CustomerList-Datenobjekt – Kampagnenverwaltung

Artikel
03/05/2024

Definiert ein CustomerList-Datenobjekt.

Wichtig

Bevor Sie Kundenlistendaten über die Kampagnenverwaltungs-API erstellen, müssen Sie zuerst eine Kundenlistengruppe erstellen und die Geschäftsbedingungen in der Microsoft Advertising-Benutzeroberfläche akzeptieren. Die anfängliche Kundenliste muss keine Kundendaten enthalten, aber Sie müssen ICH STIMME auswählen. Durch Auswahl von "Ich stimme zu" stimmen Sie (1) zu, dass Sie Dies sind personenbezogene Daten der Zielgruppe an Microsoft rechtmäßig offenlegen und (2) den Kundenabgleichsbedingungen, dem Microsoft Advertising-Vertrag und den Microsoft Advertising-Richtlinien zustimmen können. Microsoft verwendet die von Ihnen hochgeladenen Daten in Übereinstimmung mit den Kundenabgleichsbedingungen.

Syntax

<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

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

Geerbte Elemente

Geerbte Elemente von Audience

Das CustomerList-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 gelten spezifisch für CustomerList 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	Lange
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: Optional Aktualisieren: Optional. 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: Optional Aktualisieren: Optional. 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	Lange
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 390 Tage. Sie können die Dauer auch auf -1 ohne Ablauf festlegen. Hinzufügen: Optional. Wenn nicht angegeben, wird die Mitgliedschaftsdauer standardmäßig auf 30 festgelegt. Aktualisieren: Optional. 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: Optional. 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.	Lange
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: Optional. 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 48 Stunden lang null oder leer, z. B. wenn Sie die Mitgliedschaftsdauer der Kundenliste hinzufügen oder aktualisieren. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Lange
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 CustomerList , wenn Sie eine Kundenlistengruppe 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

Verwendet von

ApplyCustomerListItems

Freigeben über