RemarketingList-Datenobjekt – Kampagnenverwaltung

Artikel
11/14/2024

Definiert eine Remarketing-Liste.

Tipp

Eine Übersicht über die Implementierung finden Sie im technischen Leitfaden zur universellen Ereignisnachverfolgung .

Hinweis

Microsoft Advertising generiert automatisch ähnliche Zielgruppen für Remarketing-Listen, wenn Sie Pilotteilnehmer sind. Sie können die ähnliche Zielgruppe für eine Remarketing-Liste nicht erstellen oder bearbeiten. Abgesehen davon können Sie ähnliche Remarketing-Listenzuordnungen und -ausschlüsse hinzufügen und löschen. Wenn Sie die Quell-Remarketing-Liste löschen, wird auch die ähnliche Zielgruppe gelöscht. Wenn einer Kampagne oder Anzeigengruppe eine ähnliche Zielgruppe zugeordnet ist, können Sie die Remarketing-Quellliste nicht löschen. Weitere Informationen finden Sie unter SimilarRemarketingList .

<xs:complexType name="RemarketingList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="Rule" nillable="true" type="tns:RemarketingRule" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "RemarketingList",
  "Rule": {
    "Type": "CustomEvents",
    "Action": "ValueHere",
    "ActionOperator": "ValueHere",
    "Category": "ValueHere",
    "CategoryOperator": "ValueHere",
    "Label": "ValueHere",
    "LabelOperator": "ValueHere",
    "Value": DecimalValueHere,
    "ValueOperator": "ValueHere"
  },
  "TagId": "LongValueHere"
}

Elemente

Das RemarketingList-Objekt weist die folgenden Elemente auf: Rule, TagId.

Element	Beschreibung	Datentyp
Regel	Eine Regel enthält Bedingungen, die verwendet werden, um zu bestimmen, wer Ihrer Remarketing-Liste hinzugefügt werden soll. Sie können eine der vier Arten von Regeln für verschiedene Zielgruppen auswählen: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule und PageVisitorsWhoVisitedAnotherPageRule. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie eines der vorherigen Regelelemente beibehalten möchten, müssen Sie sie während der Aktualisierung explizit erneut festlegen. Sie können den Typ der Regel während des Updates ändern.	RemarketingRule
TagId	Der Microsoft Advertising-Bezeichner des Tags für die universelle Ereignisnachverfolgung (Universal Event Tracking, UET), das mit der Remarketing-Liste verwendet wird. Bevor Sie eine Abhängigkeit von der Tag-ID erstellen, beachten Sie, dass das UET-Tag für oder von einem anderen Kunden freigegeben werden kann. Freigegebene UET-Tags und Zielgruppen sind nur für Pilotkunden verfügbar. Eine Übersicht über die Freigabe von Zielgruppen und UET-Tags in einer Kundenhierarchie finden Sie im technischen Leitfaden Freigeben von Zielgruppen und UET-Tags . Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	lang

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

Geerbte Elemente

Geerbte Elemente von Audience

Das RemarketingList-Objekt wird vom Audience-Objekt abgeleitet und erbt die folgenden Elemente: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Die folgenden Beschreibungen sind spezifisch für RemarketingList und gelten möglicherweise nicht für andere Objekte, die die gleichen Elemente vom Audience-Objekt erben.

Element	Beschreibung	Datentyp
AudienceNetworkSize	Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Zielgruppennetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Benutzer des Audience-Netzwerks Sie ansprechen können. Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	lang
CustomerShare	Bestimmt die Liste der Kunden und Konten, die die Zielgruppe gemeinsam nutzen. Details umfassen die Anzahl der Benutzergruppenzuordnungen. Freigegebene UET-Tags und Zielgruppen sind nur für Pilotkunden verfügbar. Eine Übersicht über die Freigabe von Zielgruppen und UET-Tags in einer Kundenhierarchie finden Sie im technischen Leitfaden Freigeben von Zielgruppen und UET-Tags . Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie dieses Element auf NULL oder leer fest, um vorhandene Kundenkontofreigaben beizubehalten. Um alle Kundenkontofreigaben zu entfernen, legen Sie das CustomerAccountShares-Element des CustomerShare-Objekts auf NULL oder leer fest. Um eine Teilmenge von Kundenkontofreigaben zu entfernen, geben Sie die Kundenkontofreigaben, die Sie behalten möchten, im CustomerAccountShares-Element des CustomerShare-Objekts an.	CustomerShare
Beschreibung	Die Beschreibung der Zielgruppe. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, für welche Zielgruppe Sie sich richten. Die Beschreibung darf maximal 1.024 Zeichen enthalten. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für das Audience-Objekt .	KeyValuePairOfstring-Array
Id	Der Microsoft Advertising-Bezeichner der Zielgruppe. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich und schreibgeschützt	lang
MembershipDuration	Wenn Sie eine Zielgruppe erstellen, können Sie angeben, wie weit Microsoft Advertising nach Aktionen suchen soll, die Ihrer Zielgruppendefinition entsprechen. Die Mindestdauer beträgt 1 Tag und die maximal zulässige Dauer 180 Tage. Hinzufügen: Wahlfrei. Wenn nicht angegeben, wird die Mitgliedschaftsdauer standardmäßig auf 30 festgelegt. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
Name	Der Name der Zielgruppe. Der Name darf maximal 128 Zeichen lang sein. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
ParentId	Der Microsoft Advertising-Bezeichner des Kontos oder Kunden. Wenn der Bereich auf Konto festgelegt ist, ist dies die Konto-ID und andernfalls die Kunden-ID. Hinzufügen: Erforderlich Aktualisieren: Schreibgeschützt. Sie können die übergeordnete ID nicht ändern.	lang
Bereich	Bereich definiert, welche Konten diese Zielgruppe verwenden können. Wenn bereich auf Konto festgelegt ist, kann die Zielgruppe nur Kampagnen und Anzeigengruppen in einem Konto zugeordnet werden, d. h. über die ParentId. Wenn scope auf Customer festgelegt ist, kann die Zielgruppe Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Sie können den Bereich von Konto in Kunde ändern, aber Sie können den Bereich nicht von Kunde in Konto ändern.	EntityScope
SearchSize	Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Suchnetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Suchbenutzer Sie als Ziel verwenden können. Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet. Diese Eigenschaft ist während der Erstellung der Zielgruppe bis zu 24 Stunden lang null oder leer, z. B. wenn Sie die Mitgliedschaftsdauer, die Regel oder den Tagbezeichner der Remarketing-Liste hinzufügen oder aktualisieren. Diese Eigenschaft ist null oder leer, wenn das der Remarketing-Liste zugeordnete UET-Tag eine status "Nicht überprüft" oder "Inaktiv" aufweist, da die Remarketing-Liste die Kundeninformationen von Ihrer Website, die sie zum Erstellen der Liste benötigt, nicht empfangen kann. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	lang
SupportedCampaignTypes	Die Liste der Kampagnentypen, die diese Zielgruppe unterstützen. Unterstützte Werte sind Audience, DynamicSearchAds, Search und Shopping. Möglicherweise werden in Zukunft neue Kampagnentypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolgenarray
Typ	Der Typ der Zielgruppe. Dieser Wert ist RemarketingList , wenn Sie eine Remarketing-Listenzielgruppe abrufen. Weitere Informationen zu Zielgruppentypen finden Sie in den Hinweisen zu Zielgruppendatenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AudienceType

Anforderungen

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

Freigeben über