PageVisitorsRule-Datenobjekt – Kampagnenverwaltung

Artikel
12/21/2023

Definiert eine Remarketing-Regel für Seitenbesucher.

Remarketing-Regeln sind Bedingungen, die verwendet werden, um zu bestimmen, wer Ihrer Remarketing-Liste hinzugefügt werden soll. Für die PageVisitors-Regel müssen Sie eine oder mehrere Regelelementgruppen einschließen.

Wichtig

Im Kalenderjahr 2021 wurde unterstützung für konjunktive Normalform (CNF) hinzugefügt. Bisher unterstützte Microsoft Advertising nur disjunktive Normalform (DNF). Das Standard-Normalformular für eine neue Seitenbesucherregel bleibt DNF. Sie müssen jedoch sicherstellen, dass Ihre Anwendung CNF und DNF entsprechend lesen und unterscheiden kann. Ihre Anwendung sollte nicht mehr davon ausgehen, dass die Regel disjunktiv ist.

Wenn das Normalformular konjunktiv (CNF) ist, werden die Regelelementbedingungen für dieselbe Seite zuerst mithilfe des logischen OR-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen AND-Operators verknüpft. Anders ausgedrückt: Der Benutzer wird Ihrer Remarketing-Liste hinzugefügt, wenn eine der angegebenen Regelelementbedingungen innerhalb aller Regelelementgruppen erfüllt ist.

Wenn das Normalformular disjunktiv (DNF) ist, werden die Regelelementbedingungen für dieselbe Seite zuerst mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft. Anders ausgedrückt: Der Benutzer wird Ihrer Remarketing-Liste hinzugefügt, wenn alle angegebenen Regelelementbedingungen in einer der Regelelementgruppen erfüllt sind.

Ein ausführliches Beispiel finden Sie weiter unten im Abschnitt "Hinweise ".

Syntax

<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>

Elemente

Das PageVisitorsRule-Objekt weist die folgenden Elemente auf: NormalForm, RuleItemGroups.

Element	Beschreibung	Datentyp
NormalForm	Bestimmt, ob die Regelelementgruppen basierend auf konjunktiver Normalform (Conjunktive Normalform, CNF) oder disjunktiver Normalform (DNF) ausgewertet werden. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den NormalForm-Wert in das ReturnAdditionalFields-Element ein, wenn Sie den GetAudiencesByIds-Dienstvorgang aufrufen. Hinzufügen: Optional. Der Standardwert ist "Disjunctive". Aktualisieren: Optional	NormalForm
RuleItemGroups	Die Liste der Regelelementgruppen, die auf die Remarketing-Liste angewendet werden sollen. Die maximale Anzahl von Regelelementgruppen in diesem Element beträgt 100. Die maximale Anzahl von Regelelementen pro Regelelementgruppe beträgt 100. Hinzufügen: Erforderlich Aktualisieren: Erforderlich. Wenn Sie eine der vorherigen Regelelementgruppen beibehalten möchten, müssen Sie sie während der Aktualisierung explizit erneut festlegen.	RuleItemGroup-Array

Das PageVisitorsRule-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von RemarketingRule

Das PageVisitorsRule-Objekt wird vom RemarketingRule-Objekt abgeleitet und erbt die folgenden Elemente: Type. Die folgenden Beschreibungen gelten spezifisch für PageVisitorsRule und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom RemarketingRule-Objekt erben.

Element	Beschreibung	Datentyp
Typ	Der Typ der Remarketing-Regel. Weitere Informationen zu Remarketing-Regeltypen finden Sie in den Hinweisen zu RemarketingRule-Datenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge

Hinweise

Wichtig

Für ein Beispiel für disjunktive Normalformauswertung nehmen wir an, dass die folgenden Regelelementgruppen festgelegt sind.

<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>

Die obige Definition wird in den folgenden logischen Ausdruck übersetzt:

((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z))

Die Auswertung des logischen Ausdrucks bestimmt, welcher der folgenden Beispielbenutzer der Remarketing-Liste hinzugefügt wird.

Benutzer	Besuchte URL	Verweis-URL	Zur Liste hinzugefügt
Benutzer 1	Ein	X	Ja Auswertung der Ergebnisse des logischen Ausdrucks als True. ((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z)) (False und True) oder (True) oder (False) False, True oder False True
Benutzer 2	B	J	Nein Auswertung der Ergebnisse des logischen Ausdrucks als False. ((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z)) (False und True) oder (False) oder (False) False, False oder False False
Benutzer 3	C	Z	Ja Auswertung der Ergebnisse des logischen Ausdrucks als True. ((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z)) (False und False) oder (True) oder (True) False, True oder True True

Anforderungen

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

Freigeben über