Kampagnenproduktbereichsdatensatz – Massen

Artikel
11/13/2024

Definiert einen Produktbereich auf Kampagnenebene mit einer Liste von Bedingungen, mit denen bestimmt wird, welche Elemente aus Ihrem Katalog in die Kampagne aufgenommen werden sollen, z. B. nach Marke oder Bedingung filtern.

Sie können Kampagnenproduktbereiche sowohl mit Shoppingkampagnen als auch mit feedbasierten Zielgruppenkampagnen verwenden, d. h. mit Kampagnen, die eine Microsoft Merchant Center Store-ID nutzen. Mit dem Produktbereich können Sie auswählen, welche Artikel aus Ihrem Katalog in die Kampagne aufgenommen werden sollen, z. B. nach Marke oder Bedingung filtern.

Tipp

Eine Übersicht und weitere Informationen zu Microsoft-Shoppingkampagnen finden Sie im technischen Leitfaden für Produktanzeigen .

Hinweis

Produktbereichsbedingungen auf Kampagnenebene werden bei Smart Shopping-Kampagnen nicht unterstützt, d. h. Kampagnen mit Kampagnentyp , der auf "Shopping " und " Untertyp " auf "ShoppingSmartAds" festgelegt ist.

Sie können alle Datensätze des Kampagnenproduktbereichs im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignProductScopes 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 ein neuer Kampagnenproduktbereich hinzugefügt, wenn ein gültiger Übergeordneter ID-Wert angegeben wird.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

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 BulkCampaignProductScope-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 BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

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

Kampagnen
Client-ID
Id
Änderungszeit
Übergeordnete ID
Produktbedingung 1
Produktbedingung 2
Produktbedingung 3
Produktbedingung 4
Produktbedingung 5
Produktbedingung 6
Produktbedingung 7
Produktoperator 1
Produktoperator 2
Produktoperator 3
Produktoperator 4
Produktoperator 5
Produktoperator 6
Produktoperator 7
Produktwert 1
Produktwert 2
Produktwert 3
Produktwert 4
Produktwert 5
Produktwert 6
Produktwert 7
Status

Kampagne

Der Name der Kampagne, die den Produktbereich enthält.

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

Hinweis

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne 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: Wahlfrei
Aktualisieren: Wahlfrei
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner des Produktbereichs.

Hinzufügen: Schreibgeschützt
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

Übergeordnete ID

Der vom System generierte Bezeichner der Kampagne, die den Produktbereich enthält.

Dieses Massenfeld wird dem Feld Id des Kampagnendatensatzes zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Kampagnenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Kampagnendatensatzes entspricht. Dies wird empfohlen, wenn Sie einer neuen Kampagne in derselben Massendatei neue Produktbereiche hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Hinweis

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.

Produktbedingung 1

Der Operand der Bedingung. Die Operanden enthalten implizit den Gleichheitsoperator. Beispielsweise können Sie Brand als Brand= lesen.

Verwenden Sie jede Produktbedingung als Operanden für den entsprechenden Produktwert.

Produktbedingung (Operand)	Produktwert (Attribut)	Product Operator (Operator)
Produktbedingung 1	Produktwert 1	Produktoperator 1
Produktbedingung 2	Produktwert 2	Produktoperator 2
Produktbedingung 3	Produktwert 3	Produktoperator 3
Produktbedingung 4	Produktwert 4	Produktoperator 4
Produktbedingung 5	Produktwert 5	Produktoperator 5
Produktbedingung 6	Produktwert 6	Produktoperator 6
Produktbedingung 7	Produktwert 7	Produktoperator 7

Jede Bedingung ist erfüllt, wenn der Attributwert des Produkts dem Attributwert des Operanden entspricht. Wenn der Operand beispielsweise auf Brand und das Attribut auf Contoso festgelegt ist, ist die Bedingung erfüllt, wenn der Wert des Brand-Attributs des Produktkatalogs contoso entspricht.

Hinweis

Zum Hinzufügen und Aktualisieren ist mindestens ein Produktbedingungs- und Wertpaar erforderlich, und die Indexnummer hat keine Relevanz. Beispielsweise können Sie gültige Werte für Product Condition 2 und Product Value 2 angeben und die restlichen Bedingungs- und Wertfelder leer lassen.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt. Sie können die Bedingungs- oder Wertfelder nicht aktualisieren. Um die Bedingungen zu aktualisieren, müssen Sie den Produktbereich löschen und einen neuen hinzufügen.
Löschen: Schreibgeschützt

Informationen zu unterstützten Produktbedingungen (Operanden) und Produktwert (Attribut) pro Kampagnentyp finden Sie in den folgenden Tabellen.

Produktbedingungen für Feed-Based Zielgruppenkampagnen

Für jede feedbasierte Zielgruppenkampagne können mehrere Produktbedingungen angegeben werden. Jede Bedingung ist erfüllt, wenn der Attributwert des Produkts dem Attributwert des Operanden entspricht. Wenn der Operand beispielsweise auf Brand und das Attribut auf Contoso festgelegt ist, ist die Bedingung erfüllt, wenn der Wert des Brand-Attributs des Produktkatalogs contoso entspricht.

Produktbedingung (Operand)	Beschreibung des Produktwerts (Attributs)	Geschäftsregeln
Marke	Hersteller, Marke oder Herausgeber des Produkts. Maximal 1.000 Zeichen.	Der Markenoperand darf nur einmal pro Kampagnen-Produktbereichsfilter angegeben werden.
Bedingung	Der Zustand des Produkts. Wenn der Operand auf Bedingung festgelegt ist, sind die unterstützten Attributwerte, die Sie angeben können, Neu, Verwendet und Generalisiert.	Der Bedingungsoperand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.
ProductType1-5 Fünf Produkttyp-Operandenwerte sind verfügbar, d. h. ProductType1, ProductType2, ProductType3, ProductType4 und ProductType5.	Ein vom Händler definierter Produkttyp oder eine Kategorie. ProductType1 ist der Produkttyp der höchsten Ebene, und ProductType5 ist der produkttyp mit der niedrigsten oder granularsten Ebene. Maximal 100 Zeichen.	Jeder Der Produkttyp-Operanden kann einmal pro Kampagnen-Produktbereichsfilter verwendet werden. Wenn Sie den Operanden auf einen Produkttyp von 1 bis 5 festlegen, müssen diese in aufsteigender Reihenfolge angegeben werden. Beispielsweise kann der Operand mit dem Attribut "Pet Supplies" auf "ProductType2" festgelegt werden, wenn eine höhere Produktpartition den Operanden "ProductType1" mit dem Attribut "Animals & Pet Supplies" aufweist.
CustomLabel0-4 Fünf benutzerdefinierte Bezeichnungsoperndenwerte sind verfügbar, d. h. CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 und CustomLabel4.	Eine benutzerdefinierte Bezeichnung, die vom Händler definiert wird. Benutzerdefinierte Bezeichnungen, z. B. CustomLabel0 und CustomLabel4, werden nicht basierend auf einer Hierarchie überprüft. Maximal 100 Zeichen.	Jeder der CustomLabel-Operanden kann einmal pro Kampagnenproduktbereichsfilter verwendet werden.

Produktbedingungen für Shopping-Kampagnen

Für jede Microsoft Shopping-Kampagne und Anzeigengruppe können mehrere Produktbedingungen angegeben werden. Jede Bedingung ist erfüllt, wenn der Attributwert des Produkts dem Attributwert des Operanden entspricht. Wenn der Operand beispielsweise auf Brand und das Attribut auf Contoso festgelegt ist, ist die Bedingung erfüllt, wenn der Wert des Brand-Attributs des Produktkatalogs contoso entspricht.

In Shoppingkampagnen können die Produktbedingungen auf Kampagnen- und Anzeigengruppenebene festgelegt werden. In der folgenden Tabelle werden die Geschäftsregeln Product Condition (Operand) und Product Value (Attribut) für Kampagnenproduktbereich und Anzeigengruppen-Produktpartitionsdatensätze beschrieben.

Produktbedingung (Operand)	Beschreibung des Produktwerts (Attributs)	Kampagnenproduktbereichsregeln	Ad Group-Produktpartitionsregeln
Alle	Muss NULL sein.	Nicht zutreffend	Für die Produktpartitionen einer Anzeigengruppe muss der Operand auf den Stammknoten auf "All" und das Attribut auf NULL oder leer festgelegt sein.
Marke	Hersteller, Marke oder Herausgeber des Produkts. Maximal 1.000 Zeichen.	Der Markenoperand darf nur einmal pro Kampagnen-Produktbereichsfilter angegeben werden.	Der Brand-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
KategorieL1-5 Fünf Kategorieoperandwerte sind verfügbar, d. h. CategoryL1, CategoryL2, CategoryL3, CategoryL4 und CategoryL5.	Eine Produktkategorie, die vom Microsoft Merchant Center-Store definiert wird. CategoryL0 ist die Kategorie der höchsten Ebene, und CategoryL4 ist die niedrigste oder präziseste Kategorie. Maximal 100 Zeichen.	Jeder der CategoryL-Operanden kann einmal pro Produktbereichsfilter der Kampagne verwendet werden. Wenn Sie eine Produktbedingung angeben, bei der der Operand auf eine Produktkategorie von 1 bis 5 festgelegt ist, Sie müssen in aufsteigender Reihenfolge angegeben werden. Beispielsweise können Sie den Operanden mit dem Attribut "Pet Supplies" auf "CategoryL2" festlegen, wenn eine vorangehende Produktbedingung den Operanden "CategoryL1" mit dem Attribut "Animals & Pet Supplies" aufweist.	Jeder der CategoryL-Operanden kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch CategoryL1 und CategoryL2 enthalten, aber keinen weiteren Knoten mit dem CategoryL2-Operanden. Wenn Sie den Operanden auf eine Produktkategorie von 1 bis 5 festlegen, müssen diese in aufsteigender Reihenfolge angegeben werden. Beispielsweise kann der Operand mit dem Attribut "Pet Supplies" auf "CategoryL2" festgelegt werden, wenn eine höhere Produktpartition den Operanden "CategoryL1" mit dem Attribut "Animals & Pet Supplies" aufweist. Der Produktkategorieoperand der vorherigen Ebene muss nicht in der unmittelbar übergeordneten Partition angegeben werden. Beispielsweise könnte eine CategoryL2-Bedingung für eine Produktpartition angegeben werden, wenn das übergeordnete Element des übergeordneten Elements eine CategoryL1-Bedingung angegeben hat.
Kanal	Der LIA-Kanal (Local Inventory Ads). Mögliche Werte sind "Local Stores" und "Online". Wenn sich die Kampagne nicht für Lokale Bestandsanzeigen entschieden hat, sind alle Angebote standardmäßig nur Online (Channel=Online) und Einzelner Kanal (ChannelExclusivity=Single-Channel). Weitere Informationen finden Sie auf der Hilfeseite Für Lokale Bestandsanzeigen .	Der Kanaloperand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.	Der Kanaloperand kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Branch angegeben werden.
ChannelExclusivity	Exklusivität des LIA-Kanals (Local Inventory Ads). Mögliche Werte sind "Single-channel" und "Multi-channel". Wenn sich die Kampagne nicht für Lokale Bestandsanzeigen entschieden hat, sind alle Angebote standardmäßig nur Online (Channel=Online) und Einzelner Kanal (ChannelExclusivity=Single-Channel). Weitere Informationen finden Sie auf der Hilfeseite Für Lokale Bestandsanzeigen .	Der ChannelExclusivity-Operand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.	Der ChannelExclusivity-Operand kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Verzweigung angegeben werden.
Bedingung	Der Zustand des Produkts. Wenn der Operand auf Bedingung festgelegt ist, sind die unterstützten Attributwerte, die Sie angeben können, Neu, Verwendet und Generalisiert.	Der Bedingungsoperand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.	Der Condition-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
CustomLabel0-4 Fünf benutzerdefinierte Bezeichnungsoperndenwerte sind verfügbar, d. h. CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 und CustomLabel4.	Eine benutzerdefinierte Bezeichnung, die vom Händler definiert wird. Benutzerdefinierte Bezeichnungen, z. B. CustomLabel0 und CustomLabel4, werden nicht basierend auf einer Hierarchie überprüft. Maximal 100 Zeichen. Dieser Operand gilt nicht für gesponserte Produkte.	Jeder der CustomLabel-Operanden kann einmal pro Kampagnenproduktbereichsfilter verwendet werden.	Jeder der CustomLabel-Operanden kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch CustomLabel0 und CustomLabel1 enthalten, aber keinen weiteren Knoten mit dem CustomLabel1-Operanden .
GTIN	Die vom Händler definierte Global Trade Item Number. Für das Feld GTIN sind maximal 50 Zeichen zulässig, wobei jeder GTIN-Wert bis zu 14 Ziffern aufweist. Dieser Operand gilt nur für gesponserte Produkte.	Der GTIN-Operand darf nur einmal pro Kampagnen-Produktbereichsfilter angegeben werden.	Der GTIN-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
Id	Der vom Händler definierte Produktbezeichner. Maximal 1.000 Zeichen.	Der Id-Operand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.	Der Id-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
MPN	Die vom Händler definierte Global Trade Item Number. Maximal 70 Zeichen. Dieser Operand gilt nur für gesponserte Produkte.	Der MPN-Operand darf nur einmal pro Produktbereichsfilter der Kampagne angegeben werden.	Der MPN-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
ProductType1-5 Fünf Produkttyp-Operandenwerte sind verfügbar, d. h. ProductType1, ProductType2, ProductType3, ProductType4 und ProductType5.	Ein vom Händler definierter Produkttyp oder eine Kategorie. ProductType1 ist der Produkttyp der höchsten Ebene, und ProductType5 ist der produkttyp mit der niedrigsten oder granularsten Ebene. Maximal 100 Zeichen. Dieser Operand gilt nicht für gesponserte Produkte.	Jeder Der Produkttyp-Operanden kann einmal pro Kampagnen-Produktbereichsfilter verwendet werden. Wenn Sie eine Produktbedingung angeben, bei der der Operand auf einen Produkttyp von 1 bis 5 festgelegt ist, Sie müssen in aufsteigender Reihenfolge angegeben werden. Beispielsweise können Sie den Operanden mit dem Attribut "Pet Supplies" auf "ProductType2" festlegen, wenn eine vorangehende Produktbedingung den Operanden "ProductType1" mit dem Attribut "Animals & Pet Supplies" aufweist.	Jeder der ProductType-Operanden kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch ProductType1 und ProductType2 enthalten, aber keinen weiteren Knoten mit dem ProductType2-Operanden . Wenn Sie den Operanden auf einen Produkttyp von 1 bis 5 festlegen, müssen diese in aufsteigender Reihenfolge angegeben werden. Beispielsweise kann der Operand mit dem Attribut "Pet Supplies" auf "ProductType2" festgelegt werden, wenn eine höhere Produktpartition den Operanden "ProductType1" mit dem Attribut "Animals & Pet Supplies" aufweist. Der Produkttypopernd der vorherigen Ebene muss nicht in der unmittelbar übergeordneten Partition angegeben werden. Beispielsweise könnte eine ProductType2-Bedingung für eine Produktpartition angegeben werden, wenn das übergeordnete Element des übergeordneten Elements eine ProductType1-Bedingung angegeben hat.

Produktbedingung 2

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktbedingung 3

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktbedingung 4

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktbedingung 5

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktbedingung 6

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktbedingung 7

Unterstützt die gleichen Werte und Regeln wie Produktbedingung 1.

Produktoperator 1

Der Operatorwert der Bedingung. Der Operatorwert ist entweder gleich oder notequal.

Hinzufügen: Wahlfrei
Aktualisieren: Schreibgeschützt. Sie können die Bedingungs- oder Wertfelder nicht aktualisieren. Um die Bedingungen zu aktualisieren, müssen Sie den Kampagnenproduktbereich löschen und einen neuen hinzufügen.
Löschen: Schreibgeschützt