Impression Based Remarketing List Record – Bulk

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

Sie können alle Impression Based Remarketing List-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von ImpressionBasedRemarketingLists 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 auf Impressionen basierende Remarketing-Liste hinzugefügt.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

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 BulkImpressionBasedRemarketingList-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 BulkImpressionBasedRemarketingList
var bulkImpressionBasedRemarketingList = new BulkImpressionBasedRemarketingList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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 datensatzbasierten Remarketing-Listeneintrag sind die folgenden Attributfelder im Massendateischema verfügbar.

• Zielgruppe
• Größe des Zielgruppennetzwerks
• Größe der Zielgruppensuche
• Client-ID
• Beschreibung
• Entitätstyp
• Id
• Impression Ad Group Id
• Impression Campaign Id
• Mitgliedschaftsdauer
• Änderungszeit
• Übergeordnete ID
• Scope
• Status
• Unterstützte Kampagnentypen

Zielgruppe

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

Diese Eigenschaft ist leer, wenn das UET-Tag, das der impressionbasierten Remarketing-Liste zugeordnet ist, den Status Nicht überprüft oder Inaktiv hat, da die impressionbasierte Remarketing-Liste nicht die Kundeninformationen von Ihrer Website 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 impressionbasierten Remarketing-Liste. Verwenden Sie eine Beschreibung, um sich zu merken, welche Zielgruppe Sie mit dieser auf Impressionen basierenden 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

Entitätstyp

Dieser Entitätstyp basiert darauf, wie Benutzer eine Anzeige angezeigt haben. Sie müssen den Entitätstyp festlegen, wenn Sie eine auf Impressionen basierende Remarketing-Liste erstellen. Mögliche Werte sind AdGroup oder Campaign.

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

Id

Der vom System generierte Bezeichner der impressionbasierten Remarketing-Liste.

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

Impression Ad Group Id

Die AdGroupId, die zum Erstellen der impressionbasierten Remarketing-Liste verwendet wird.

Hinzufügen: Wenn der Entitätstyp AdGroup ist, ist dies Erforderlich. Wenn der Entitätstyp Campaign ist, ist dieser Wert leer.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Impression Campaign Id

Die CampaignId, die zum Erstellen der impression-basierten 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

Mitgliedschaftsdauer

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

Die Mindestdauer beträgt 1 Tag und die maximal zulässige Dauer 30 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

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 impression-basierten 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 impressionbasierten 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 impression-basierten Remarketing-Liste hinzugefügt, wenn eine der angegebenen Regelelementbedingungen in allen 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 Impression-basierten 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 impression-basierten 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, wen Sie zu Ihrer impressionbasierten Remarketing-Liste hinzufügen möchten. 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.

Anders ausgedrückt: Der Besucher wird ihrer impression-basierten Remarketing-Liste hinzugefügt, wenn eine der Bedingungen für die Include-Regelelementgruppe 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 impression-basierten 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, wen Sie zu Ihrer impressionbasierten Remarketing-Liste hinzufügen möchten. 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 zu Ihrer impression-basierten Remarketing-Liste hinzugefügt, wenn eine der Bedingungen der 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 impression-basierten 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

Scope definiert, welche Konten diese impressionbasierte Remarketing-Liste verwenden können. Wenn scope auf Account festgelegt ist, kann die impression-basierte Remarketing-Liste nur Kampagnen und Anzeigengruppen innerhalb eines angegebenen Kontos (Übergeordnete ID) zugeordnet werden. Wenn scope auf Customer festgelegt ist, kann die auf Impressionen basierende 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 auf Impressionen basierende Remarketing-Listenstatus.

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 von Kampagnentypen, die diese auf Impressionen basierende 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