CustomEventsRule-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert eine Remarketing-Regel für benutzerdefinierte Ereignisse.

Remarketing-Regeln sind Bedingungen, die verwendet werden, um zu bestimmen, wer Ihrer Remarketing-Liste hinzugefügt werden soll. Für die benutzerdefinierte Ereignisregel müssen Sie mindestens eins der folgenden Bedingten Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Wenn mehr als eine Bedingung angegeben ist, werden die Bedingungen mithilfe des logischen AND-Operators verknüpft. Anders ausgedrückt: Der Besucher wird nur dann zu Ihrer Remarketing-Liste hinzugefügt, wenn alle angegebenen Regelbedingungen erfüllt sind.

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

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

Elemente

Das CustomEventsRule-Objekt verfügt über die folgenden Elemente: Action, ActionOperator, Category, CategoryOperator, Label, LabelOperator, ValueOperator.

Element	Beschreibung	Datentyp
Aktion	Der Typ der Benutzerinteraktion, die Sie nachverfolgen möchten. Beispiel: "play" oder "pause". Wenn dieses Element während eines Add- oder Updatevorgangs angegeben wird, ist auch das ActionOperator-Element erforderlich. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie actionOperator und Action während der Aktualisierung nicht einschließen, werden alle vorhandenen ActionOperator - und Action-Einstellungen gelöscht.	Zeichenfolge
ActionOperator	Der Operator, der auf den Wert des Action-Elements angewendet werden kann. Wenn dieses Element während eines Add- oder Updatevorgangs angegeben wird, ist auch das Action-Element erforderlich. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie actionOperator und Action während der Aktualisierung nicht einschließen, werden alle vorhandenen ActionOperator - und Action-Einstellungen gelöscht.	StringOperator
Kategorie	Die Kategorie des Ereignisses, das Sie nachverfolgen möchten. Beispiel: "video". Wenn dieses Element während eines Add- oder Updatevorgangs angegeben wird, ist auch das CategoryOperator-Element erforderlich. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie categoryOperator und Category während des Updates nicht einschließen, werden alle vorhandenen CategoryOperator - und Category-Einstellungen gelöscht.	Zeichenfolge
CategoryOperator	Der Operator, der auf den Wert des Category-Elements angewendet werden kann. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie categoryOperator und Category während des Updates nicht einschließen, werden alle vorhandenen CategoryOperator - und Category-Einstellungen gelöscht.	StringOperator
Beschriftung	Der Name des Elements, das die Aktion verursacht hat. Beispiel: "trailer" oder "behindthescenes". Wenn dieses Element während eines Add- oder Update-Vorgangs angegeben wird, ist auch das LabelOperator-Element erforderlich. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie labelOperator und Label während der Aktualisierung nicht einschließen, werden alle vorhandenen LabelOperator - und Label-Einstellungen gelöscht.	Zeichenfolge
LabelOperator	Der Operator, der auf den Wert des Label-Elements angewendet werden kann. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie labelOperator und Label während der Aktualisierung nicht einschließen, werden alle vorhandenen LabelOperator - und Label-Einstellungen gelöscht.	StringOperator
Wert	Ein positiver ganzzahliger Wert, der diesem Ereignis zugeordnet ist. Der Wert kann z. B. die Dauer sein, die das Video wiedergegeben hat. Wenn dieses Element während eines Add- oder Updatevorgangs angegeben wird, ist auch das ValueOperator-Element erforderlich. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie valueOperator und Value während der Aktualisierung nicht einschließen, werden alle vorhandenen ValueOperator - und Value-Einstellungen gelöscht.	dezimal
ValueOperator	Der Operator, der auf den Wert des Value-Elements angewendet werden kann. Hinzufügen: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Sie müssen eines oder mehrere der folgenden Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Aktualisieren: Optional, wenn Sie eines oder mehrere der anderen Ereignisse einschließen; Wenn Sie valueOperator und Value während der Aktualisierung nicht einschließen, werden alle vorhandenen ValueOperator - und Value-Einstellungen gelöscht.	NumberOperator

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

Geerbte Elemente

Geerbte Elemente von RemarketingRule

Das CustomEventsRule-Objekt wird vom RemarketingRule-Objekt abgeleitet und erbt die folgenden Elemente: Type. Die folgenden Beschreibungen gelten spezifisch für CustomEventsRule 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

Für die CustomEvents-Regel müssen Sie mindestens eins der folgenden Bedingten Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Wenn mehr als eine Bedingung angegeben ist, werden die Bedingungen mithilfe des logischen AND-Operators verknüpft. Anders ausgedrückt: Der Besucher wird nur dann zu Ihrer Remarketing-Liste hinzugefügt, wenn alle angegebenen Regelbedingungen erfüllt sind.

Angenommen, die folgenden benutzerdefinierten Ereignisse sind festgelegt.

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

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

(Kategorie gleich Video) und (Aktion gleich Wiedergabe) und (Label Equals trailer) und (Value Equals 5)

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

Anforderungen

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

Freigeben über