Objet de données CustomEventsRule - Gestion des campagnes

Article
11/13/2024

Définit une règle de remarketing d’événements personnalisés.

Les règles de remarketing sont des conditions utilisées pour déterminer qui ajouter à votre liste de remarketing. Pour la règle d’événements personnalisés, vous devez inclure une ou plusieurs des paires d’opérateurs d’événements conditionnels suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Si plusieurs conditions sont spécifiées, les conditions sont jointes à l’aide de l’opérateur AND logique. En d’autres termes, le visiteur n’est ajouté à votre liste de remarketing que si toutes les conditions de règle spécifiées sont remplies.

Pour obtenir un exemple détaillé, consultez la section Remarques ci-dessous.

<xs:complexType name="CustomEventsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="Action" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Category" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Label" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" type="tns:NumberOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "Type": "CustomEvents",
  "Action": "ValueHere",
  "ActionOperator": "ValueHere",
  "Category": "ValueHere",
  "CategoryOperator": "ValueHere",
  "Label": "ValueHere",
  "LabelOperator": "ValueHere",
  "Value": DecimalValueHere,
  "ValueOperator": "ValueHere"
}

Éléments

L’objet CustomEventsRule contient les éléments suivants : Action, ActionOperator, Category, CategoryOperator, Label, LabelOperator, Value, ValueOperator.

Élément	Description	Type de données
Action	Type d’interaction utilisateur que vous souhaitez suivre. Par exemple , « play » ou « pause ». Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément ActionOperator est également requis. Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ActionOperator et Action pendant la mise à jour, les paramètres ActionOperator et Action existants sont supprimés.	chaîne
ActionOperator	Opérateur qui peut être appliqué à la valeur de l’élément Action . Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément Action est également requis. Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ActionOperator et Action pendant la mise à jour, les paramètres ActionOperator et Action existants sont supprimés.	StringOperator
Catégorie	Catégorie d’événement que vous souhaitez suivre. Par exemple, « video ». Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément CategoryOperator est également requis. Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas CategoryOperator et Category lors de la mise à jour, les paramètres CategoryOperator et Category existants seront supprimés.	chaîne
CategoryOperator	Opérateur qui peut être appliqué à la valeur de l’élément Category . Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas CategoryOperator et Category lors de la mise à jour, les paramètres CategoryOperator et Category existants seront supprimés.	StringOperator
Étiquette	Nom de l’élément à l’origine de l’action. Par exemple « trailer » ou « behindthescenes ». Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément LabelOperator est également requis. Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas LabelOperator et Label pendant la mise à jour, les paramètres LabelOperator et Label existants sont supprimés.	chaîne
LabelOperator	Opérateur qui peut être appliqué à la valeur de l’élément Label . Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas LabelOperator et Label pendant la mise à jour, les paramètres LabelOperator et Label existants sont supprimés.	StringOperator
Valeur	Valeur entière positive associée à cet événement. Par exemple, la valeur peut être la durée pendant laquelle la vidéo a été lue. Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément ValueOperator est également requis. Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ValueOperator et Value pendant la mise à jour, les paramètres ValueOperator et Value existants seront supprimés	décimal
ValueOperator	Opérateur qui peut être appliqué à la valeur de l’élément Value . Ajouter: Facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Mettre à jour: Facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ValueOperator et Value lors de la mise à jour, les paramètres ValueOperator et Value existants seront supprimés.	NumberOperator

L’objet CustomEventsRule a des éléments hérités.

Éléments hérités

Éléments hérités de RemarketingRule

L’objet CustomEventsRule dérive de l’objet RemarketingRule et hérite des éléments suivants : Type. Les descriptions ci-dessous sont spécifiques à CustomEventsRule et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet RemarketingRule .

Élément	Description	Type de données
Type	Type de la règle de remarketing. Pour plus d’informations sur les types de règles de remarketing, consultez les remarques relatives aux objets de données RemarketingRule. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

Remarques

Pour la règle CustomEvents , vous devez inclure une ou plusieurs des paires d’opérateurs d’événements conditionnels suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Si plusieurs conditions sont spécifiées, les conditions sont jointes à l’aide de l’opérateur AND logique. En d’autres termes, le visiteur n’est ajouté à votre liste de remarketing que si toutes les conditions de règle spécifiées sont remplies.

Par exemple, supposons que les événements personnalisés suivants sont définis.

<Rule i:type="CustomEventsRule">
  <Type i:nil="true" />
  <Action>play</Action>
  <ActionOperator>Equals</ActionOperator>
  <Category>video</Category>
  <CategoryOperator>Equals</CategoryOperator>
  <Label>trailer</Label>
  <LabelOperator>Equals</LabelOperator>
  <Value>5.00</Value>
  <ValueOperator>Equals</ValueOperator>
</Rule>

La définition ci-dessus est traduite en l’expression logique suivante :

(La catégorie est égale à la vidéo) et (Action est égale à la lecture) et (Étiquette est égale à la bande-annonce) et (Valeur égale à 5)

L’évaluation de l’expression logique détermine qui sera ajouté à la liste de remarketing.

Configuration requise

Service : CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Partager via