Objet de données PageVisitorsRule - Gestion des campagnes

Article
12/21/2023

Définit une règle de remarketing des visiteurs de page.

Les règles de remarketing sont des conditions utilisées pour déterminer qui ajouter à votre liste de remarketing. Pour la règle PageVisitors , vous devez inclure un ou plusieurs groupes d’éléments de règle.

Importante

Au cours de l’année civile 2021, nous avons ajouté la prise en charge de la forme normale conjonctive (CNF). Auparavant, Microsoft Advertising prenait uniquement en charge la forme normale disjonctive (DNF). La forme normale par défaut d’une règle de visiteurs de nouvelle page reste DNF. Toutefois, vous devez vous assurer que votre application peut lire et faire la distinction entre CNF et DNF. Votre application ne doit plus supposer que la règle est disjonctive.

Si la forme normale est conjonctive (CNF), les conditions d’élément de règle pour la même page sont d’abord jointes à l’aide de l’opérateur OR logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur AND logique. En d’autres termes, l’utilisateur est ajouté à votre liste de remarketing si l’une des conditions d’élément de règle spécifiées dans tous les groupes d’éléments de règle est remplie.

Si la forme normale est disjonctive (DNF), les conditions d’élément de règle pour la même page sont d’abord jointes à l’aide de l’opérateur LOGIQUE AND . Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique. En d’autres termes, l’utilisateur est ajouté à votre liste de remarketing si toutes les conditions d’élément de règle spécifiées dans l’un des groupes d’éléments de règle sont remplies.

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

Syntaxe

<xs:complexType name="PageVisitorsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="NormalForm" nillable="true" type="tns:NormalForm">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="RuleItemGroups" nillable="true" type="tns:ArrayOfRuleItemGroup" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet PageVisitorsRule contient les éléments suivants : NormalForm, RuleItemGroups.

Élément	Description	Type de données
NormalForm	Détermine si les groupes d’éléments de règle sont évalués en fonction de la forme normale conjonctive (CNF) ou de la forme normale disjonctive (DNF). Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur NormalForm dans l’élément ReturnAdditionalFields lorsque vous appelez l’opération de service GetAudiencesByIds . Ajouter: Optionnel. La valeur par défaut est « Disjonctive ». Mettre à jour: Optionnel	NormalForm
RuleItemGroups	Liste des groupes d’éléments de règle que vous souhaitez appliquer à la liste de remarketing. Le nombre maximal de groupes d’éléments de règle dans cet élément est de 100. Le nombre maximal d’éléments de règle par groupe d’éléments de règle est de 100. Ajouter: Obligatoire Mettre à jour: Obligatoire. Si vous souhaitez conserver l’un des groupes d’éléments de règle précédents, vous devez les définir explicitement à nouveau lors de la mise à jour.	Tableau RuleItemGroup

L’objet PageVisitorsRule contient des éléments hérités.

Éléments hérités

Éléments hérités de RemarketingRule

L’objet PageVisitorsRule dérive de l’objet RemarketingRule et hérite des éléments suivants : Type. Les descriptions ci-dessous sont spécifiques à PageVisitorsRule 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

Importante

Pour obtenir un exemple d’évaluation disjonctive de formulaire normal, supposons que les groupes d’éléments de règle suivants sont définis.

<Rule i:type="PageVisitorsRule">
  <Type i:nil="true" />
  <NormalForm i:nil="true" />
  <RuleItemGroups>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>Contains</Operator>
          <Value>X</Value>
        </RuleItem>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>DoesNotContain</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>DoesNotBeginWith</Operator>
          <Value>Y</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>Equals</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
  </RuleItemGroups>
</Rule>

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

((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z))

L’évaluation de l’expression logique détermine lequel des exemples d’utilisateurs suivants sera ajouté à la liste de remarketing.

Utilisateur	URL visitée	URL du référent	Ajouté à la liste
Utilisateur 1	A	X	Oui. Évaluation des résultats de l’expression logique avec la valeur True. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et True) ou (True) ou (False) False, True ou False True
Utilisateur 2	B	O	Non. Évaluation des résultats de l’expression logique comme False. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et True) ou (False) ou (False) False ou False ou False False
Utilisateur 3	C	Z	Oui. Évaluation des résultats de l’expression logique avec la valeur True. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et False) ou (True) ou (True) False, True ou True True

Configuration requise

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