CombinedList-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Eine kombinierte Liste ist eine Zielgruppe, die aus einer Kombination mehrerer vorhandener Zielgruppen erstellt wird.

Sie können benutzerdefinierte Zielgruppen, Kundenlisten, Produktgruppen, ähnliche Zielgruppen und Remarketing-Listen kombinieren. Sie können keine anderen kombinierten Listen oder marktinternen Zielgruppen in eine kombinierte Liste aufnehmen.

Sie können maximal 1.000 kombinierte Listen pro Anzeigenkonto und bis zu 5.000 pro Kunde erstellen. Jede Liste kann bis zu 100 Kombinationsregeln oder Sätze logischer Bedingungen enthalten, und jede CombinationRule kann bis zu 100 Zielgruppen-IDs enthalten.

Tipp

Eine Übersicht und weitere Informationen zu Zielgruppen finden Sie im technischen Leitfaden zu Zielgruppen-APIs .

<xs:complexType name="CombinedList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="CombinationRules" nillable="true" type="tns:ArrayOfCombinationRule" />
      </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": "CombinedList",
  "CombinationRules": [
    {
      "AudienceIds": [
        "LongValueHere"
      ],
      "Operator": "ValueHere"
    }
  ]
}

Elemente

Das CombinedList-Objekt verfügt über die folgenden Elemente: CombinationRules.

Element	Beschreibung	Datentyp
CombinationRules	Logische Bedingungen, die verwendet werden, um zu bestimmen, wer ihrer kombinierten Liste hinzugefügt werden soll. Jede Liste kann bis zu 100 Kombinationsregeln oder Sätze logischer Bedingungen enthalten, und jede CombinationRule kann bis zu 100 Zielgruppen-IDs enthalten. Weitere Informationen finden Sie in den Hinweisen zu CombinationRule. Hinzufügen: Erforderlich Aktualisieren: Erforderlich. Wenn Sie eine der vorherigen Regeln beibehalten möchten, müssen Sie sie während des Updates explizit erneut festlegen.	CombinationRule-Array

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

Geerbte Elemente

Geerbte Elemente von Audience

Das CombinedList-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 CombinedList und gelten möglicherweise nicht für andere Objekte, die dieselben 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	Dieses Element wird für kombinierte Listengruppen nicht unterstützt. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	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	Dieses Element wird für kombinierte Listengruppen nicht unterstützt. Hinzufügen: Nicht unterstützt Aktualisieren: Nicht unterstützt	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 kombinierte Listenmitgliedschaftsdauer, Regel oder Tag-ID hinzufügen oder aktualisieren. Diese Eigenschaft ist null oder leer, wenn das der kombinierten Liste zugeordnete UET-Tag den status Nicht überprüft oder Inaktiv aufweist, da die kombinierte Liste nicht die Kundeninformationen von Ihrer Website empfangen kann, die sie zum Erstellen der Liste benötigt. 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 CombinedList , wenn Sie eine kombinierte Listengruppe 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