Kundenlistenelementdatensatz – Massenvorgang
Definiert ein Kundenlistenelement, das in eine Massendatei hochgeladen werden kann.
Hinweis
Das Massendownload von Kundenlistenelementen wird nicht unterstützt.
Wichtig
Bevor Sie Kundenlistendaten über die Massen-API hochladen können, müssen Sie zuerst eine Kundenlistengruppe erstellen und den Geschäftsbedingungen auf der Microsoft Advertising-Benutzeroberfläche zustimmen. 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.
Eine Kundenliste ist ein Satz von Kundenkontaktinformationen, die Sie zum Aktivieren der Kundenabgleiche kompiliert haben. Jede Liste kann mehrere Email Elemente enthalten.
- Fügen Sie den Datensatz "Kundenliste " in die Massenuploaddatei ein, und legen Sie das Feld "Aktionstyp " auf "Hinzufügen", "Entfernen" oder "Ersetzen" fest.
- Schließen Sie einen oder mehrere Kundenlistenelementdatensätze in dieselbe Massenuploaddatei ein, und legen Sie die Felder Übergeordnete ID, Untertyp und Text fest.
Sie können einen Kundenlistendatensatz ohne Kundenlistenelementdatensätze in derselben Massenuploaddatei hinzufügen oder aktualisieren. Sie können jedoch keine Kundenlistenelementeinträge ohne den zugehörigen übergeordneten Kundenlistendatensatz hochladen.
Überprüfen Sie nach 48 Stunden die Felder "Zielgruppengröße", z. B. Größe der Zielgruppensuche , um zu sehen, wie viele dieser Kunden im Bing-Netzwerk abgeglichen wurden. An diesem Punkt können Ihre Anzeigen für diese neue Zielgruppe angezeigt werden.
Tipp
Eine Übersicht und weitere Informationen zu Zielgruppen finden Sie im technischen Leitfaden zu Zielgruppen-APIs .
Sie können alle Kundenlistenelementeinträge im Konto herunterladen, indem Sie den DownloadEntity-Wert von CustomerLists in die Serviceanfrage DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.
Im folgenden Massen-CSV-Beispiel wird ein neues Kundenlistenelement hinzugefügt.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue
Für einen Kundenlistenelementdatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
Zielgruppe
Der Name der übergeordneten Zielgruppe der Kundenliste.
Der Name darf maximal 128 Zeichen lang sein.
Hinzufügen: Erforderlich. Sie müssen entweder das Feld Übergeordnete ID oder Zielgruppe angeben.
Löschen: Erforderlich. Sie müssen entweder das Feld Übergeordnete ID oder Zielgruppe angeben.
Client-ID
Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.
Hinzufügen: Optional
Löschen: Optional
Übergeordnete ID
Der Bezeichner der übergeordneten Zielgruppe der Kundenliste.
Sie müssen entweder das Feld Übergeordnete ID oder Zielgruppe angeben.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Kundenlistenbezeichner oder einen negativen Bezeichner angeben, der dem Id-Feld des übergeordneten Kundenlistendatensatzes entspricht. Dies ist erforderlich, wenn Sie neue Kundenlistenelemente zu einer neuen Kundenliste in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Löschen: Erforderlich.
Untertyp
Bestimmt, ob das Textfeld einen hashed Email-Wert darstellt.
Derzeit wird nur der Wert "Email" unterstützt.
Hinzufügen: Erforderlich
Löschen: Erforderlich
Text
Die gehashte Email als Text.
Wenn der Untertyp "Email" ist, darf dieses Feld keinen Nur-Text enthalten. Die Zeichenfolge muss mit dem SHA-256-Algorithmus gehasht werden. Der hashed Email muss eine hexadezimale Zeichenfolge mit der Länge 64 sein. Sie müssen beispielsweise eine Hashzeichenfolge wie "f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101" anstelle von "test@contoso.com" hochladen.
Hinzufügen: Erforderlich
Löschen: Erforderlich