Freigeben über

Kundenlistendatensatz – Massenvorgang

  • Artikel

Definiert eine Kundenliste, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

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.

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 Kundenlistendatensätze 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 eine neue Kundenliste hinzugefügt.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add

Für einen Kundenlistendatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Aktionstyp

Bestimmt, ob die Datensätze des Kundenlistenelements hinzugefügt, entfernt oder ersetzt werden sollen, die Sie in dieselbe Massenuploaddatei einschließen.

Wenn der Aktionstyp "Hinzufügen" lautet, versucht der Dienst, die Datensätze des Kundenlistenelements hinzuzufügen, die Sie in dieselbe Massenuploaddatei einschließen.

Wenn der Aktionstyp auf "Entfernen" festgelegt ist, versucht der Dienst, die Datensätze des Kundenlistenelements zu entfernen, die Sie in derselben Massenuploaddatei enthalten.

Wenn der Aktionstyp auf "Ersetzen" festgelegt ist, werden alle vorherigen Kundenabgleichsdaten für diese Liste entfernt, und der Dienst versucht, die Datensätze des Kundenlistenelements hinzuzufügen, die Sie in dieselbe Massenuploaddatei einschließen.

Hinzufügen: Optional. Standardmäßig wird der Aktionstyp "Hinzufügen" für neue Kundenlisten verwendet. Unabhängig davon, ob Sie einen Wert festlegen oder nicht, wird dieses Feld für neue Kundenlisten ignoriert.
Aktualisieren: Erforderlich, wenn Sie auch Kundenlistenelementeinträge für eine vorhandene Zielgruppe in dieselbe Massenuploaddatei einschließen, andernfalls ist dieses Feld optional.
Löschen: Schreibgeschützt

Zielgruppe

Der Name der Kundenliste.

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.
Löschen: Schreibgeschützt

Größe des Zielgruppennetzwerks

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
Löschen: Schreibgeschützt

Größe der Zielgruppensuche

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 bis zu 24 Stunden leer, während die Zielgruppe erstellt wird, z. B. wenn Sie die Mitgliedschaftsdauer, die Regel oder den Tagbezeichner der Kundenliste hinzufügen oder aktualisieren.

Diese Eigenschaft ist leer, wenn das der Kundenliste zugeordnete UET-Tag die status "Nicht überprüft" oder "Inaktiv" aufweist, da die Kundenliste die Kundeninformationen von Ihrer Website nicht empfangen kann, die sie zum Erstellen der Liste benötigt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

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
Aktualisieren: Optional
Löschen: Schreibgeschützt

Beschreibung

Die Beschreibung der Kundenliste. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, welche Zielgruppe Sie mit dieser Kundenliste ansprechen.

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. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner der Kundenliste.

Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Ein negativer Bezeichner, der für die Kundenliste festgelegt wurde, kann dann im Feld Übergeordnete ID von abhängigen Datensatztypen wie dem Kundenlistenelement verwiesen werden. Dies ist erforderlich, wenn Sie eine neue Kundenliste und neue Kundenlistenelemente in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Änderungszeit

Das Datum und die Uhrzeit der letzten Aktualisierung der Entität. Der Wert wird in UTC (Coordinated Universal Time) angegeben.

Hinweis

Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Mitgliedschaftsdauer

Wenn Sie eine Kundenliste erstellen, können Sie angeben, wie lange Benutzer in diesem Segment bleiben.

Die Mindestdauer beträgt 1 Tag. Hinweis: Wenn ein Benutzer 180 Tage lang keine Aktivität hat, werden sie aus allen Segmenten entfernt.

Wenn die Mitgliedschaftsdauer "-1" ist, gibt es keinen Ablauf.

Wenn die Mitgliedschaftsdauer NULL ist, wird die Standarddauer (30 Tage) verwendet.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Übergeordnete ID

Der Microsoft Advertising-Bezeichner des Kunden, der die Kundenliste enthält.

Hinzufügen: Optional
Aktualisieren: Schreibgeschützt. Sie können die übergeordnete ID nicht ändern.
Löschen: Schreibgeschützt

Bereich

Bereich definiert, welche Konten diese Kundenliste verwenden können. Für eine Kundenliste ist der einzige unterstützte Bereich Der Kunde, und die Kundenliste kann allen Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt. Sie können den Bereich nicht ändern.
Löschen: Schreibgeschützt

Status

Die Kundenliste status.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Unterstützte Kampagnentypen

Die durch Semikolons getrennte Liste der Kampagnentypen, die diese Kundenliste 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
Löschen: Schreibgeschützt