Freigeben über

Remarketing-Listendatensatz – Massenvorgang

  • Artikel

Definiert eine Remarketing-Liste, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

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 Ähnliche Remarketing-Liste .

Tipp

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

Sie können alle Datensätze der Remarketing-Liste im Konto herunterladen, indem Sie den DownloadEntity-Wert von RemarketingLists in die Serviceanforderung 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 Remarketing-Liste hinzugefügt.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Hochladen und Herunterladen des BulkRemarketingList-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkRemarketingList
var bulkRemarketingList = new BulkRemarketingList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkRemarketingList);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Für einen Remarketing-Listeneintrag sind die folgenden Attributfelder im Massendateischema verfügbar.

Zielgruppe

Der Name der Remarketing-Liste.

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

Diese Eigenschaft ist leer, wenn das der Remarketing-Liste zugeordnete UET-Tag den Status Nicht überprüft oder Inaktiv aufweist, da die Remarketing-Liste 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: Wahlfrei
Aktualisieren: Wahlfrei
Löschen: Schreibgeschützt

Beschreibung

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

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. 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 Remarketing-Liste.

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

Mitgliedschaftsdauer

Wenn Sie eine Remarketing-Liste erstellen, können Sie angeben, wie weit Microsoft Advertising nach Aktionen suchen soll, die Ihrer Remarketing-Listendefinition entsprechen, um Ihrer Liste Personen hinzuzufügen.

Die Mindestdauer beträgt 1 Tag und die maximal zulässige Dauer 180 Tage.

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

Ä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

Übergeordnete ID

Der vom System generierte Bezeichner des Kontos oder Kunden. Wenn der Bereich auf Konto festgelegt ist, ist dies die Konto-ID und andernfalls die Kunden-ID.

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

Remarketing-Regel

Eine Regelvorlage 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. Ausführliche Informationen zum Format der einzelnen Regeln in der Massendatei finden Sie in den Abschnitten CustomEvents, PageVisitors, PageVisitorsWhoDidNotVisitAnotherPage und PageVisitorsWhoVisitedAnotherPage für Regelvorlagen weiter unten.

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

CustomEvents-Regelvorlage

Für die CustomEvents-Regel müssen Sie mindestens eins der folgenden Bedingten Ereignisoperatorpaare einschließen: (ActionOperator und Action), (CategoryOperator und Category), (LabelOperator und Label), (ValueOperator und Value). Wenn mehr als eine Bedingung angegeben ist, werden die Bedingungen mithilfe des logischen AND-Operators verknüpft. Anders ausgedrückt: Der Besucher wird nur dann zu Ihrer Remarketing-Liste hinzugefügt, wenn alle angegebenen Regelbedingungen erfüllt sind.

Angenommen, die folgenden benutzerdefinierten Ereignisse werden als logischer Ausdruck in der Massendatei festgelegt:

CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) and (Value Equals 5)

Die Auswertung des logischen Ausdrucks bestimmt, wer der Remarketing-Liste hinzugefügt wird.

PageVisitors-Regelvorlage

Für die PageVisitors-Regel müssen Sie eine oder mehrere Regelelementgruppen einschließen.

Wichtig

Im Kalenderjahr 2021 wurde unterstützung für konjunktive Normalform (CNF) hinzugefügt. Bisher unterstützte Microsoft Advertising nur disjunktive Normalform (DNF). Das Standard-Normalformular für eine neue Seitenbesucherregel bleibt DNF. Sie müssen jedoch sicherstellen, dass Ihre Anwendung CNF und DNF entsprechend lesen und unterscheiden kann. Ihre Anwendung sollte nicht mehr davon ausgehen, dass die Regel disjunktiv ist.

Wenn das Normalformular konjunktiv (CNF) ist, werden die Regelelementbedingungen für dieselbe Seite zuerst mithilfe des logischen OR-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen AND-Operators verknüpft. Anders ausgedrückt: Der Benutzer wird Ihrer Remarketing-Liste hinzugefügt, wenn eine der angegebenen Regelelementbedingungen innerhalb aller Regelelementgruppen erfüllt ist.

  • Regel 1 UND Regel 2
  • (Regel 1 ODER Regel 2) UND Regel 3
  • (Regel 1 ODER Regel 2) UND (Regel 3 ODER Regel 4)

Wenn das Normalformular disjunktiv (DNF) ist, werden die Regelelementbedingungen für dieselbe Seite zuerst mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft. Anders ausgedrückt: Der Benutzer wird Ihrer Remarketing-Liste hinzugefügt, wenn alle angegebenen Regelelementbedingungen in einer der Regelelementgruppen erfüllt sind.

  • Regel 1 ODER Regel 2
  • (Regel 1 UND Regel 2) ODER Regel 3
  • (Regel 1 UND Regel 2) ODER (Regel 3 UND Regel 4)

Angenommen, die folgenden Regelelementgruppen sind als logischer Ausdruck in der Massendatei festgelegt, um ein Beispiel für die DNF-Auswertung zu erhalten:

PageVisitors((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or (Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z))

Die Auswertung des logischen Ausdrucks bestimmt, welcher der folgenden Beispielbenutzer der Remarketing-Liste hinzugefügt wird.

Benutzer Besuchte URL Verweis-URL Zur Liste hinzugefügt
Benutzer 1 A
 X Ja. Auswertung der Ergebnisse des logischen Ausdrucks als True.

((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z))

(False und True) oder (True) oder (False)

False, True oder False

True
Benutzer 2 B
 Y Nein Auswertung der Ergebnisse des logischen Ausdrucks als False.

((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z))

(False und True) oder (False) oder (False)

False, False oder False

False
Benutzer 3 C
 Z Ja. Auswertung der Ergebnisse des logischen Ausdrucks als True.

((Url enthält X) und (ReferrerUrl DoesNotContain Z)) oder ((Url DoesNotBeginWith Y)) oder ((ReferrerUrl Equals Z))

(False und False) oder (True) oder (True)

False, True oder True

True

PageVisitorsWhoDidNotVisitAnotherPage-Regelvorlage

Remarketing-Regeln sind Bedingungen, die verwendet werden, um zu bestimmen, wer Ihrer Remarketing-Liste hinzugefügt werden soll. Für die PageVisitorsWhoDidNotVisitAnotherPage-Regel müssen Sie eine oder mehrere Regelelementgruppen für die besuchte Seite (IncludeRuleItemGroups) einschließen, und Sie müssen auch eine oder mehrere Regelelementgruppen für die Seite einschließen, die nicht besucht worden sein darf (ExcludeRuleItemGroups).

Für jede Regelelementgruppe in IncludeRuleItemGroups werden die Regelelementbedingungen für dieselbe Seite mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft.

Ebenso werden für jede Regelelementgruppe in ExcludeRuleItemGroups die Regelelementbedingungen für dieselbe Seite mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft. Schließlich wird der logische NOT-Operator auf das aggregierte Ergebnis der Ausschlussregelelementgruppen angewendet.

Mit anderen Worten, der Besucher wird Ihrer Remarketing-Liste hinzugefügt, wenn eine der Bedingungen für die Includeregelelementgruppe erfüllt ist und keine der Bedingungen für die Ausschließen-Regelelementgruppe erfüllt ist.

Angenommen, die folgenden Regelelementgruppen werden als logischer Ausdruck in der Massendatei festgelegt:

((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) und nicht ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) oder ((Url contains C)))

Die Auswertung des logischen Ausdrucks bestimmt, welcher der folgenden Beispielbenutzer der Remarketing-Liste hinzugefügt wird.

Benutzer Besuchte URL Verweis-URL Zur Liste hinzugefügt
Benutzer 1 A
 X Ja. Auswertung der Ergebnisse des logischen Ausdrucks als True.

((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) und nicht ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) oder ((Url contains C)))

((False und True) oder (True) oder (False)) und nicht ((True und False) oder (False))

(False oder True oder False) und nicht (False oder False)

True und nicht False

True
Benutzer 2 B
 Y Ja. Auswertung der Ergebnisse des logischen Ausdrucks als True.

((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) und nicht ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) oder ((Url contains C)))

((False und True) oder (True) oder (False)) und nicht ((False und False) oder (False))

(False oder True oder False) und nicht (False oder False)

True und nicht False

True
Benutzer 3 C
 Z Nein Auswertung der Ergebnisse des logischen Ausdrucks als False.

((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) und nicht ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) oder ((Url contains C)))

((False und False) oder (True) oder (True)) und nicht ((False und False) oder (True))

(False, True oder True) und nicht (False oder True)

True und nicht True

False

PageVisitorsWhoVisitedAnotherPage-Regelvorlage

Remarketing-Regeln sind Bedingungen, die verwendet werden, um zu bestimmen, wer Ihrer Remarketing-Liste hinzugefügt werden soll. Für die PageVisitorsWhoVisitedAnotherPage-Regel müssen Sie eine oder mehrere Regelelementgruppen für die besuchte Seite (RuleItemGroups) einschließen, und Sie müssen auch eine oder mehrere Regelelementgruppen für eine andere Seite einschließen, die besucht worden sein muss (AnotherRuleItemGroups).

Für jede Regelelementgruppe in RuleItemGroups werden die Regelelementbedingungen für dieselbe Seite mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft.

Ebenso werden für jede Regelelementgruppe in AnotherRuleItemGroups die Regelelementbedingungen für dieselbe Seite mithilfe des logischen AND-Operators verknüpft. Anschließend werden alle Ergebnisse aus der Liste der Regelelementgruppen mithilfe des logischen OR-Operators verknüpft.

Anders ausgedrückt: Der Besucher wird Ihrer Remarketing-Liste hinzugefügt, wenn eine der Bedingungen für die Regelelementgruppe erfüllt ist und eine der anderen Bedingungen für die Regelelementgruppe erfüllt ist.

Angenommen, die folgenden Regelelementgruppen werden als logischer Ausdruck in der Massendatei festgelegt:

((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

Die Auswertung des logischen Ausdrucks bestimmt, welcher der folgenden Beispielbenutzer der Remarketing-Liste hinzugefügt wird.

Benutzer Besuchte URL Verweis-URL Zur Liste hinzugefügt
Benutzer 1 A
 X Nein Auswertung der Ergebnisse des logischen Ausdrucks als False.

((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False und True) oder (True) oder (False)) und ((True and False) oder (False))

(False, True oder False) und (False oder False)

True und False

False
Benutzer 2 B
 Y Nein Auswertung der Ergebnisse des logischen Ausdrucks als False.

((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False und True) oder (True) oder (False)) und ((False und False) oder (False))

(False, True oder False) und (False oder False)

True und False
False
Benutzer 3 C
 Z Ja. Auswertung der Ergebnisse des logischen Ausdrucks als True.

((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False und True) oder (True) oder (True)) und ((False und False) oder (True))

(False oder True oder True) und (False oder True)

True und True

True

Bereich

Bereich definiert, welche Konten diese Remarketing-Liste verwenden können. Wenn bereich auf Konto festgelegt ist, kann die Remarketing-Liste nur Kampagnen und Anzeigengruppen innerhalb eines angegebenen Kontos (übergeordnete ID) zugeordnet werden. Wenn scope auf Customer festgelegt ist, kann die Remarketing-Liste 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

Der Status der Remarketing-Liste.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Wahlfrei. 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 Remarketing-Liste 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

UET-Tag-ID

Der Microsoft Advertising-Bezeichner des Tags für die universelle Ereignisnachverfolgung (Universal Event Tracking, UET), das mit der Remarketing-Liste verwendet wird.

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