Produktgruppendatensatz – Massen

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

Hinweis

Dynamische Remarketing-Listen wurden in Microsoft Advertising früher als Produktgruppen bezeichnet. Auf der Microsoft Advertising-Benutzeroberfläche wird "Dynamic Remarketing list" (Dynamische Remarketing-Liste) angezeigt, aber um Breaking Changes zu vermeiden, werden die API-Objekte weiterhin als "Produktzielgruppe" bezeichnet.

Dynamische Remarketing-Listen kombinieren Kunden mit bestimmten Produkten basierend auf dem, was sie auf Ihrer Website angesehen, berücksichtigt oder bereits gekauft haben. Sie können dynamische Remarketing-Listen sowohl in Suchkampagnen als auch in Zielgruppenkampagnen verwenden (noch nicht jeder hat Zielgruppenkampagnen).

Dynamische Remarketing-Listen eignen sich am besten für Shopping-Kampagnen und feedbasierte Zielgruppenkampagnen, d. h. für Kampagnen, die eine Microsoft Merchant Center-Store-ID nutzen.

Wichtig

Achten Sie darauf, das Skript zu bearbeiten, das der UET-Tag-ID auf Ihrer Website entspricht, um die ecomm_prodid Parameter und ecomm_pagetype einzuschließen. Der parameter ecomm_prodid ist die Produkt-ID des Produkts auf der Seite. Sie ist für jedes Element eindeutig und muss entweder mit dem Id- oder item_group_id-Attribut in Ihrem Produktfeed übereinstimmen. Nur numerische und alphanumerische Zeichen (einschließlich Bindestrichen) mit maximal 50 Zeichen. Der parameter ecomm_pagetype identifiziert den Typ der Seite, die der Benutzer besucht hat. Gültige Optionen: Startseite, Suchergebnisse, Kategorie, Produkt, Warenkorb, Kauf, andere.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Tipp

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

Sie können alle Product Audience-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von ProductAudiences 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 Produktgruppe hinzugefügt.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,Search;DynamicSearchAds;Shopping;Audience

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 BulkProductAudience-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zu schreiben, um jedes Feld in der Massendatei zu analysieren.

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // '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(bulkProductAudience);

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 Product Audience-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

• Zielgruppe
• Größe des Zielgruppennetzwerks
• Größe der Zielgruppensuche
• Client-ID
• Beschreibung
• Id
• Mitgliedschaftsdauer
• Änderungszeit
• Übergeordnete ID
• Produktgruppentyp
• Scope
• Status
• Unterstützte Kampagnentypen
• UET-Tag-ID

Zielgruppe

Der Name der Produktgruppe.

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 der Produktgruppe, die Regel oder den Tagbezeichner hinzufügen oder aktualisieren.

Diese Eigenschaft ist leer, wenn das UET-Tag, das der Produktzielgruppe zugeordnet ist, den Status Nicht überprüft oder Inaktiv aufweist, da die Produktgruppe die Kundeninformationen von Ihrer Website nicht erhalten 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 Produktgruppe. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, welche Zielgruppe Sie für diese Produktzielgruppe verwenden.

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 Produktzielgruppe.

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

Mitgliedschaftsdauer

Wenn Sie eine Produktgruppe erstellen, können Sie angeben, wie weit Microsoft Advertising nach Aktionen suchen soll, die Ihrer Produktgruppendefinition 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

Produktgruppentyp

Bestimmt, wer Ihrer Produktgruppe hinzugefügt werden soll.

Die möglichen Werte sind GeneralVisitors, ProductSearchers, ProductViewers, ShoppingCartAbandoners und PastBuyers.

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

Bereich

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

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 Produktgruppe 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 UET-Tags (Universal Event Tracking), das mit der Produktgruppe verwendet wird.

Wichtig

Achten Sie darauf, das UET-Skript auf Ihrer Website so zu bearbeiten, dass es die prodid Parameter und pagetype enthält.

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
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 zu Ihrer Produktgruppe 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 Produktgruppe hinzugefügt wird.

PageVisitors-Regelvorlage

Für die PageVisitors-Regel müssen Sie eine oder mehrere Regelelementgruppen einschließen. Mit jeder Regelelementgruppe 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. Anders ausgedrückt: Der Benutzer wird Ihrer Produktgruppe hinzugefügt, wenn alle angegebenen Regelelementbedingungen in einer der Regelelementgruppen erfüllt sind.

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

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 Produktgruppe 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 Zu Ihrer Produktgruppe 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.

Anders ausgedrückt: Der Besucher wird Ihrer Produktgruppe hinzugefügt, wenn eine der Bedingungen für die Include-Regelelementgruppe erfüllt ist und keine der Bedingungen für die Ausschlussregelelementgruppe 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 Produktgruppe 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 Zu Ihrer Produktgruppe 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 Produktgruppe 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 Produktgruppe 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