Enregistrement de l’étendue du produit de campagne - En bloc

Article
11/13/2024

Définit une étendue de produit au niveau de la campagne avec une liste de conditions qui permettent de déterminer les éléments de votre catalogue à inclure dans la campagne, par exemple, filtrer par marque ou condition.

Vous pouvez utiliser des étendues de produit de campagne avec les campagnes Shopping et les campagnes d’audience basées sur les flux, c’est-à-dire les campagnes qui tirent parti d’un ID de magasin Microsoft Merchant Center. L’étendue du produit vous permet de choisir les éléments de votre catalogue à inclure dans la campagne, par exemple, filtrer par marque ou condition.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les campagnes d’achat Microsoft, consultez le guide technique des annonces de produits .

Remarque

Les conditions d’étendue de produit au niveau de la campagne ne sont pas prises en charge avec les campagnes d’achat intelligentes , c’est-à-dire les campagnes dont le type de campagne est défini sur Shopping et le sous-type défini sur ShoppingSmartAds.

Vous pouvez télécharger tous les enregistrements d’étendue de produit de campagne dans le compte en incluant la valeur DownloadEntity de CampaignProductScopes dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute une nouvelle étendue de produit de campagne si une valeur d’ID parent valide est fournie.

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,,,,,,,,,,,,,,

Si vous utilisez les Kits de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger et télécharger l’objet BulkCampaignProductScope , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

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();

Pour un enregistrement d’étendue de produit de campagne , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Campagne
Client Id
Id
Heure de modification
Parent Id
Condition de produit 1
Condition de produit 2
Condition de produit 3
Condition de produit 4
Condition du produit 5
Condition du produit 6
Condition du produit 7
Opérateur de produit 1
Opérateur de produit 2
Opérateur de produit 3
Opérateur de produit 4
Opérateur de produit 5
Opérateur de produit 6
Opérateur de produit 7
Valeur de produit 1
Valeur du produit 2
Valeur du produit 3
Valeur du produit 4
Valeur de produit 5
Valeur du produit 6
Valeur du produit 7
État

Campagne

Nom de la campagne qui contient l’étendue du produit.

Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Campagne .

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Mettre à jour: Optionnel
Supprimer: En lecture seule

ID

Identificateur généré par le système de l’étendue du produit.

Ajouter: En lecture seule
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système de la campagne qui contient l’étendue du produit.

Ce champ en bloc est mappé au champ Id de l’enregistrement de campagne .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de campagne existant ou un identificateur négatif égal au champ Id de l’enregistrement de campagne parent. Cette option est recommandée si vous ajoutez de nouvelles étendues de produit à une nouvelle campagne dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Remarque

Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Campagne .

Condition de produit 1

Opérande de la condition. Les opérandes incluent implicitement l’opérateur égal. Par exemple, vous pouvez lire Brand as Brand=.

Utilisez chaque condition de produit comme opérande pour la valeur de produit correspondante.

Condition du produit (opérande)	Valeur du produit (attribut)	Product, opérateur (opérateur)
Condition de produit 1	Valeur de produit 1	Opérateur de produit 1
Condition de produit 2	Valeur du produit 2	Opérateur de produit 2
Condition de produit 3	Valeur du produit 3	Opérateur de produit 3
Condition de produit 4	Valeur du produit 4	Opérateur de produit 4
Condition du produit 5	Valeur de produit 5	Opérateur de produit 5
Condition du produit 6	Valeur du produit 6	Opérateur de produit 6
Condition du produit 7	Valeur du produit 7	Opérateur de produit 7

Chaque condition est remplie si la valeur d’attribut du produit est égale à la valeur d’attribut de l’opérande. Par exemple, si l’opérande est défini sur Brand et que l’attribut est défini sur Contoso, la condition est remplie si la valeur de l’attribut Brand du catalogue de produits est égale à Contoso.

Remarque

Pour l’ajout et la mise à jour, au moins une condition de produit et une paire valeur sont requises, et le numéro d’index n’a aucune pertinence. Par exemple, vous pouvez spécifier des valeurs valides pour condition de produit 2 et valeur de produit 2 et laisser les champs de condition et de valeur restants vides.

Ajouter: Optionnel
Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour les champs condition ou valeur. Pour mettre à jour les conditions, vous devez supprimer l’étendue du produit et en ajouter une nouvelle.
Supprimer: En lecture seule

Pour connaître la condition de produit (opérande) et la valeur de produit (attribut) prises en charge par type de campagne, consultez les tableaux ci-dessous.

Conditions du produit pour les campagnes d’audience Feed-Based

Plusieurs conditions de produit peuvent être spécifiées pour chaque campagne Audience basée sur un flux. Chaque condition est remplie si la valeur d’attribut du produit est égale à la valeur d’attribut de l’opérande. Par exemple, si l’opérande est défini sur Brand et que l’attribut est défini sur Contoso, la condition est remplie si la valeur de l’attribut Brand du catalogue de produits est égale à Contoso.

Condition du produit (opérande)	Description de la valeur du produit (attribut)	Règles d’entreprise
Marque	Fabricant, marque ou éditeur du produit. Un maximum de 1 000 caractères.	L’opérande Marque ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.
Condition	Condition du produit. Si l’opérande est défini sur Condition, les valeurs d’attribut prises en charge que vous pouvez spécifier sont Nouveau, Utilisé et Reconditionné.	L’opérande Condition ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.
ProductType1-5 Cinq valeurs d’opérande de type de produit sont disponibles : ProductType1, ProductType2, ProductType3, ProductType4 et ProductType5.	Type de produit ou catégorie défini par le marchand. ProductType1 est le type de produit de niveau le plus élevé, et ProductType5 est le type de produit de niveau le plus bas ou le plus granulaire. Un maximum de 100 caractères.	Chacun des opérandes de type de produit peut être utilisé une fois par filtre d’étendue de produit de campagne. Si vous définissez l’opérande sur un type de produit de 1 à 5, ils doivent être spécifiés dans l’ordre croissant. Par exemple, l’opérande peut être défini sur « ProductType2 » avec l’attribut « Pet Supplies », si une partition de produit de niveau supérieur a l’opérande « ProductType1 » avec l’attribut « Animals & Pet Supplies ».
CustomLabel0-4 Cinq valeurs d’opérande d’étiquette personnalisée sont disponibles, par exemple CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 et CustomLabel4.	Étiquette personnalisée définie par le commerçant. Les étiquettes personnalisées, par exemple CustomLabel0 et CustomLabel4, ne sont validées en fonction d’aucune hiérarchie. Un maximum de 100 caractères.	Chacun des opérandes CustomLabel peut être utilisé une seule fois par filtre d’étendue de produit de campagne.

Conditions du produit pour les campagnes d’achat

Plusieurs conditions de produit peuvent être spécifiées pour chaque campagne Et groupe d’annonces Microsoft Shopping. Chaque condition est remplie si la valeur d’attribut du produit est égale à la valeur d’attribut de l’opérande. Par exemple, si l’opérande est défini sur Marque et que l’attribut est défini sur Contoso, la condition est remplie si la valeur de l’attribut Brand du catalogue de produits est égale à Contoso.

Dans les campagnes Shopping, les conditions du produit peuvent être définies au niveau de la campagne et du groupe d’annonces. Le tableau suivant décrit les règles métier Condition du produit (opérande) et Valeur de produit (attribut) pour les enregistrements d’étendue de produit de campagne et de partition de produit du groupe d’annonces .

Condition du produit (opérande)	Description de la valeur du produit (attribut)	Règles d’étendue de produit de campagne	Règles de partition de produit du groupe d’annonces
tous	Doit être null.	Non applicable	Pour les partitions de produits d’un groupe d’annonces, l’opérande du nœud racine doit avoir la valeur « All » et l’attribut défini sur null ou vide.
Marque	Fabricant, marque ou éditeur du produit. Un maximum de 1 000 caractères.	L’opérande Marque ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande Brand peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
CategoryL1-5 Cinq valeurs d’opérande de catégorie sont disponibles : CategoryL1, CategoryL2, CategoryL3, CategoryL4 et CategoryL5.	Catégorie de produit définie par le magasin Microsoft Merchant Center. CategoryL0 est la catégorie de niveau le plus élevé, et CategoryL4 est le niveau le plus bas ou la catégorie la plus granulaire. Un maximum de 100 caractères.	Chacun des opérandes CategoryL peut être utilisé une seule fois par filtre d’étendue de produit de campagne. Si vous spécifiez une condition de produit avec l’opérande défini sur une catégorie de produit comprise entre 1 et 5, ils doivent être spécifiés dans l’ordre croissant. Par exemple, vous pouvez définir l’opérande sur « CategoryL2 » avec l’attribut « Pet Supplies », si une condition de produit précédente a l’opérande « CategoryL1 » avec l’attribut « Animals & Pet Supplies ».	Chacun des opérandes CategoryL peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche. Par exemple, une branche peut contenir CategoryL1 et CategoryL2, mais pas un autre nœud avec l’opérande CategoryL2. Si vous définissez l’opérande sur une catégorie de produit comprise entre 1 et 5, ils doivent être spécifiés dans l’ordre croissant. Par exemple, l’opérande peut être défini sur « CategoryL2 » avec l’attribut « Pet Supplies », si une partition de produit de niveau supérieur a l’opérande « CategoryL1 » avec l’attribut « Animals & Pet Supplies ». L’opérande de catégorie de produit de niveau précédent n’a pas besoin d’être spécifié dans la partition parente immédiate. Par exemple, une condition CategoryL2 peut être spécifiée pour une partition de produit si le parent de son parent a spécifié une condition CategoryL1.
Canal	Le canal Local Inventory Ads (LIA). Les valeurs possibles sont « Magasins locaux » et « En ligne ». Si la campagne n’a pas opté pour les annonces d’inventaire local, toutes les offres sont par défaut en ligne uniquement (Channel=Online) et monocanal (ChannelExclusivity=Single-channel). Pour plus d’informations, consultez la page d’aide Annonces d’inventaire local .	L’opérande channel ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande channel peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
ChannelExclusivity	Exclusivité du canal Local Inventory Ads (LIA). Les valeurs possibles incluent « Canal unique » et « Multicanal ». Si la campagne n’a pas opté pour les annonces d’inventaire local, toutes les offres sont par défaut en ligne uniquement (Channel=Online) et monocanal (ChannelExclusivity=Single-channel). Pour plus d’informations, consultez la page d’aide Annonces d’inventaire local .	L’opérande ChannelExclusivity ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande ChannelExclusivity peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
Condition	Condition du produit. Si l’opérande est défini sur Condition, les valeurs d’attribut prises en charge que vous pouvez spécifier sont Nouveau, Utilisé et Reconditionné.	L’opérande Condition ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande Condition peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
CustomLabel0-4 Cinq valeurs d’opérande d’étiquette personnalisée sont disponibles, par exemple CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 et CustomLabel4.	Étiquette personnalisée définie par le commerçant. Les étiquettes personnalisées, par exemple CustomLabel0 et CustomLabel4, ne sont validées en fonction d’aucune hiérarchie. Un maximum de 100 caractères. Cet opérande ne s’applique pas aux produits sponsorisés.	Chacun des opérandes CustomLabel peut être utilisé une seule fois par filtre d’étendue de produit de campagne.	Chacun des opérandes CustomLabel peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche. Par exemple, une branche peut contenir CustomLabel0 et CustomLabel1, mais pas un autre nœud avec l’opérande CustomLabel1 .
GTIN	Numéro d’élément commercial global défini par le commerçant. Le champ GTIN a une limite de 50 caractères, chaque valeur GTIN ayant jusqu’à 14 chiffres. Cet opérande s’applique uniquement aux produits sponsorisés.	L’opérande GTIN ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande GTIN peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
ID	Identificateur de produit défini par le commerçant. Un maximum de 1 000 caractères.	L’opérande Id ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande Id peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
MPN	Numéro d’élément commercial global défini par le commerçant. Un maximum de 70 caractères. Cet opérande s’applique uniquement aux produits sponsorisés.	L’opérande MPN ne peut être spécifié qu’une seule fois par filtre d’étendue de produit de campagne.	L’opérande MPN peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche.
ProductType1-5 Cinq valeurs d’opérande de type de produit sont disponibles : ProductType1, ProductType2, ProductType3, ProductType4 et ProductType5.	Type de produit ou catégorie défini par le marchand. ProductType1 est le type de produit de niveau le plus élevé, et ProductType5 est le type de produit de niveau le plus bas ou le plus granulaire. Un maximum de 100 caractères. Cet opérande ne s’applique pas aux produits sponsorisés.	Chacun des opérandes de type de produit peut être utilisé une fois par filtre d’étendue de produit de campagne. Si vous spécifiez une condition de produit dont l’opérande est défini sur un type de produit de 1 à 5, ils doivent être spécifiés dans l’ordre croissant. Par exemple, vous pouvez définir l’opérande sur « ProductType2 » avec l’attribut « Pet Supplies », si une condition de produit précédente a l’opérande « ProductType1 » avec l’attribut « Animals & Pet Supplies ».	Chacun des opérandes ProductType peut être utilisé dans plusieurs branches, mais ne peut être spécifié qu’une seule fois par branche. Par exemple, une branche peut contenir ProductType1 et ProductType2, mais pas un autre nœud avec l’opérande ProductType2 . Si vous définissez l’opérande sur un type de produit de 1 à 5, ils doivent être spécifiés dans l’ordre croissant. Par exemple, l’opérande peut être défini sur « ProductType2 » avec l’attribut « Pet Supplies », si une partition de produit de niveau supérieur a l’opérande « ProductType1 » avec l’attribut « Animals & Pet Supplies ». L’opérande de type de produit de niveau précédent n’a pas besoin d’être spécifié dans la partition parente immédiate. Par exemple, une condition ProductType2 peut être spécifiée pour une partition de produit si le parent de son parent a spécifié une condition ProductType1.

Condition de produit 2

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Condition de produit 3

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Condition de produit 4

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Condition du produit 5

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Condition du produit 6

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Condition du produit 7

Prend en charge les mêmes valeurs et règles que condition de produit 1.

Opérateur de produit 1

Valeur de l’opérateur de la condition. La valeur de l’opérateur est égale ou notequal.

Ajouter: Optionnel
Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour les champs condition ou valeur. Pour mettre à jour les conditions, vous devez supprimer l’étendue du produit de campagne et en ajouter une nouvelle.
Supprimer: En lecture seule

Opérateur de produit 2

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Opérateur de produit 3

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Opérateur de produit 4

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Opérateur de produit 5

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Opérateur de produit 6

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Opérateur de produit 7

Prend en charge les mêmes valeurs et règles que Product Operator 1.

Valeur de produit 1

Valeur d’attribut de la condition. La valeur d’un attribut doit correspondre exactement à la valeur spécifiée dans le fichier catalogue Microsoft Merchant Center du client.

Pour connaître les règles d’entreprise, consultez Condition de produit 1.

Ajouter: Obligatoire
Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour les champs condition ou valeur. Pour mettre à jour les conditions, vous devez supprimer l’étendue du produit de campagne et en ajouter une nouvelle.
Supprimer: En lecture seule