Enregistrement de partition de produit du groupe d’annonces - En bloc

Définit une partition de produit de groupe d’annonces qui peut être chargée et téléchargée dans un fichier en bloc.

Vous pouvez charger des enregistrements de partition de produit de groupe d’annonces pour plusieurs groupes d’annonces dans le même fichier en bloc, tant que les règles de validation sont satisfaites, comme décrit ci-dessous.

• Au minimum, vous devez spécifier au moins le nœud racine pour l’arborescence du groupe de partitions de produit. Le nœud racine du groupe de partitions de produits doit avoir son champ Condition de produit 1 défini sur « Tout » et valeur de produit 1 null ou vide. Si vous enchérissez sur tous les produits du catalogue de la même façon, définissez le champ Sous-type sur Unité. Si vous partitionnez les enchères en fonction de conditions de produit plus spécifiques, définissez le champ Sous-type sur Subdivision, l’ID du critère parent sur null ou vide et l’ID sur une valeur négative. Vous utiliserez la valeur négative comme ID de critère parent pour tous les nœuds enfants.

• Le nœud racine est considéré comme un niveau 0, et une arborescence peut avoir des branches allant jusqu’à 7 niveaux de profondeur.

• Par demande de chargement, vous pouvez inclure un maximum de 20 000 nœuds d’arborescence de partition de produit par groupe d’annonces. Le nombre total de nœuds de l’arborescence de partition de produit pour un groupe d’annonces ne peut pas dépasser 20 000.

• Les nœuds de l’arborescence de partition de produit pour la même arborescence (même groupe d’annonces) doivent être regroupés dans le fichier .

• L’ordre des nœuds de partition de produit n’est pas garanti pendant le téléchargement, et les nœuds parents peuvent être fournis après les nœuds enfants ; Toutefois, tous les nœuds du même groupe d’annonces seront regroupés dans le fichier .

• Si vous créez ou modifiez l’arborescence, les nœuds de l’arborescence de partition de produit parent doivent être classés avant les nœuds d’arborescence de partition de produit enfant ; toutefois, l’ordre n’a pas d’importance pour les changements non structurels tels que la mise à jour de l’offre. Par exemple, si vous souhaitez mettre à jour les enchères sans ajouter, supprimer ou mettre à jour l’arborescence, vous devez uniquement charger les champs Id, Id parent et Enchère .

• Pour mettre à jour le champ Condition de produit 1, Valeur du produit 1 ou Est exclu , vous devez supprimer le nœud d’arborescence de partition de produit existant et charger un nouveau nœud d’arborescence de partition de produit qui obtiendra un nouvel identificateur.

• En cas d’échec d’une action, toutes les actions restantes qui auraient pu autrement avoir réussi échouent également.

• Toutes les actions d’ajout et de suppression de nœud de partition de produit doivent aboutir à une arborescence complète.

• Chaque chemin d’accès du nœud racine à la fin d’une branche doit se terminer par un nœud feuille (Sub Type=Unit). Chaque unité doit avoir une enchère, sauf si le champ Est exclu a la valeur TRUE, ce qui signifie que le nœud est un critère de groupe d’annonces négatif.

• Chaque sous-division doit avoir au moins un nœud feuille qui enchérit sur le reste des conditions de la sous-division, c’est-à-dire utiliser le même opérande que ses unités sœurs et définir sa valeur de produit 1 null ou vide.

• Si vous ajoutez des partitions avec plusieurs niveaux où ni le parent ni l’enfant n’existe encore, utilisez une valeur int négative comme référence pour identifier le parent. Par exemple, définissez les champs ID du parent et ID du critère parent de l’enfant sur la même valeur négative. Les ID négatifs ne sont valides que pour la durée de l’appel. Les identificateurs système uniques pour chaque critère de groupe d’annonces ajoutés avec succès sont retournés dans le fichier de résultats de chargement.

• Les champs Bid et Url de destination sont applicables uniquement si le champ Is Excluded a la valeur FALSE, ce qui signifie que le nœud est un critère de groupe d’annonces biddable. Toutefois, ces champs sont ignorés pour les nœuds de partition de subdivision . Ces éléments sont uniquement pertinents pour les nœuds de partition Unit (feuille).

• Pour suspendre une partition de produit, vous devez suspendre l’ensemble du groupe d’annonces en mettant à jour le champ État du groupe d’annonces sur Suspendu. Vous pouvez suspendre l’ensemble de la campagne en mettant à jour le champ État de la campagne sur Suspendu.

• Pour une action Supprimée , il vous suffit de spécifier l’ID et l’ID parent.

• Si vous supprimez une partition de produit parent, tous ses enfants et descendants sont également supprimés.

• Vous ne pouvez pas spécifier de conditions de produit en double dans une branche.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les campagnes d’achat Microsoft, consultez les guides techniques Des annonces de produits et des campagnes d’achat intelligentes .

Vous pouvez télécharger tous les enregistrements de partition de produit du groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupProductPartitions 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 partition de produit de groupe d’annonces 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,Is Excluded,Parent Criterion Id,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,
Ad Group Product Partition,Paused,,-1112,,,,ClientIdGoesHere,,0.5,,All,,FALSE,,,,{_promoCode}=PROMO1; {_season}=summer

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 BulkAdGroupProductPartition , 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 BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to True,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to False.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new ProductPartition { 
            Condition = new ProductCondition
            {
                // 'Product Value 1' column header in the Bulk file
                Attribute = null,
                // 'Product Condition 1' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Destination Url' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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 de partition de produit de groupe d’annonces, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Groupe d’annonces
• Offre
• Ajustement de l’enchère
• Campagne
• Client Id
• Paramètre personnalisé
• Destination Url
• Suffixe d’URL final
• Id
• Est exclu
• Heure de modification
• ID du critère parent
• Parent Id
• Condition de produit 1
• Valeur de produit 1
• État
• Sous-type
• Modèle de suivi

Groupe d’annonces

Nom du groupe d’annonces qui contient la partition de 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 Groupe d’annonces .

Offre

Montant à enchérir dans la vente aux enchères.

Remarque

Pour les groupes d’annonces dans les campagnes d’achat Microsoft qui sont configurés pour les produits sponsorisés, ce champ n’est pas applicable si l’option d’enchère du groupe d’annonces est définie sur BidBoost. Pour plus d’informations, consultez Ajustement des enchères .

Ajouter: Obligatoire si Est exclu a la valeur FALSE et que le sous-type a la valeur Unit ; sinon, l’enchère n’est pas autorisée.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

Ajustement de l’enchère

Pourcentage (supérieur à zéro) qui permet à votre offre de produits sponsorisés de fléchir.

Par exemple, supposons que votre partenaire offre 5 USD dans son groupe de produits (via le champ Enchère ). Si l’ajustement de votre offre (ce champ) est défini sur 20 (pour cent) et que l’enchère maximale de votre groupe publicitaire est de 0,50 (50 centimes), votre part sera de 50 cents et non de 1 USD.

Ce champ s’applique uniquement si l’option d’enchère du groupe d’annonces est définie sur BidBoost. Si l’option d’enchère du groupe d’annonces est définie sur BidValue, l’enchère utilise l’enchère du groupe de produits.

Les valeurs prises en charge sont négatives quatre-vingt-dix (-90) à 900 (900) positives.

Remarque

Ce paramètre s’applique uniquement aux groupes d’annonces dans les campagnes d’achat Microsoft qui sont configurés pour les produits sponsorisés. Les produits sponsorisés sont uniquement disponibles dans le États-Unis et sont actuellement en version bêta ouverte.

Ajouter: Optionnel. L’ajustement de l’enchère sera défini sur la valeur par défaut 0 s’il n’est pas inclus.
Mettre à jour: Obligatoire
Supprimer: En lecture seule

Campagne

Nom de la campagne qui contient le groupe d’annonces et la partition de produit.

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

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

Paramètre personnalisé

Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.

Dans un fichier en bloc, la liste des paramètres personnalisés est mise en forme comme suit.

• Mettez en forme chaque paire de paramètres personnalisés en tant que Clé=Valeur, par exemple {_promoCode}=PROMO1.

• Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètres personnalisés que vous incluez, et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée.

• Chaque paire clé-valeur est délimitée par un point-virgule et un espace (« ; »), par exemple {_promoCode}=PROMO1 ; {_season}=été.

• Une clé ne peut pas contenir de point-virgule. Si une valeur contient un point-virgule, elle doit être placée dans une séquence d’échappement en tant que « \ ; ». En outre, si la valeur contient une barre oblique inverse, elle doit également être placée dans une séquence d’échappement en tant que « \ ».

• La clé ne peut pas dépasser 16 UTF-8 octets, et la valeur ne peut pas dépasser 250 UTF-8 octets. La clé est obligatoire et la valeur est facultative. La taille maximale de la clé n’inclut pas les accolades et le trait de soulignement, c’est-à-dire « { », « _ » et « } ».

  Remarque

  Avec le service en bloc, la clé doit être mise en forme avec des accolades environnantes et un trait de soulignement de début. Par exemple, si la clé est promoCode, elle doit être mise en forme comme {_promoCode}. Avec le service Gestion des campagnes, vous ne pouvez pas spécifier les accolades et le trait de soulignement environnants.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer tous les paramètres personnalisés, définissez ce champ sur delete_value. Le delete_value mot clé supprime le paramètre précédent. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver et omettez ceux que vous ne souhaitez pas conserver. Le nouvel ensemble de paramètres personnalisés remplace tout jeu de paramètres personnalisé précédent.
Supprimer: En lecture seule

Destination Url

URL de la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité.

Si vous utilisez actuellement des URL de destination, vous devez les remplacer par des modèles de suivi. Pour plus d’informations, consultez Suivi des URL avec des URL mises à niveau.

L’URL peut contenir des paramètres dynamiques tels que {MatchType}. Pour obtenir la liste des paramètres pris en charge, consultez l’article d’aide microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?.

L’URL peut contenir un maximum de 1 024 caractères. Si l’URL ne spécifie pas de protocole, le système utilise le protocole HTTP lorsqu’un utilisateur clique sur la publicité. Si l’URL spécifie le protocole HTTP lorsque vous ajoutez une publicité, le service supprime la chaîne de protocole http:// (la chaîne de protocole HTTP ne compte pas dans la limite de 1 024 caractères) ; Toutefois, le service ne supprime pas de chaîne de protocole HTTPS (https://) de l’URL.

Remarque

Cette URL de destination est utilisée si elle est spécifiée ; sinon, l’URL de destination est déterminée par la valeur correspondante du lien que vous avez spécifié pour l’offre de produit dans votre catalogue Microsoft Merchant Center.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Suffixe d’URL final

Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID

Identificateur généré par le système de la partition de produit.

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

Est exclu

Détermine si la partition de produit représente un critère biddable ou négatif.

S’il est défini sur TRUE , il s’agit d’un critère négatif ; sinon, s’il s’agit de FALSE , il s’agit d’un critère biddable.

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

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

ID du critère parent

Identificateur de critère de la partition de produit parent.

Remarque

Ce champ ne s’applique pas au nœud de partition de produit racine de l’arborescence, qui n’a pas de parent.

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

Parent Id

Identificateur généré par le système du groupe d’annonces qui contient la partition de produit.

Ce champ en bloc est mappé au champ Id de l’enregistrement groupe d’annonces .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de groupe d’annonces existant ou un identificateur négatif égal au champ Id de l’enregistrement de groupe d’annonces parent. Cela est recommandé si vous ajoutez de nouvelles partitions de produit à un nouveau groupe d’annonces 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: 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 Groupe d’annonces .

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 la Condition de produit 1 comme opérande pour la valeur de produit 1.

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. Consultez Taxonomie des catégories Bing pour connaître les valeurs de catégorie et la taxonomie valides. 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.
NPP	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.

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 la partition de produit et en ajouter une nouvelle.
Supprimer: En lecture seule

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.

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 la partition de produit et en ajouter une nouvelle.
Supprimer: En lecture seule

Statut

Status de la partition de produit.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. Le seul status possible est Actif. Si vous définissez le status sur Supprimé, il sera ignoré et l’enregistrement retourné aura status défini sur Actif.
Mettre à jour: Optionnel
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Sous-type

Type de partition de produit.

Les valeurs possibles sont Subdivision et Unit.

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

Modèle de suivi

Les modèles de suivi peuvent être utilisés en tandem avec l’URL spécifiée dans le champ « Lien » pour l’offre de produit que vous avez soumise via l’API de contenu. En combinant l’URL du flux avec le modèle de suivi, l’URL de la page d’accueil est assemblée à l’endroit où un utilisateur est dirigé après avoir cliqué sur la publicité. Lorsque vous utilisez le champ Modèle de suivi pour mettre à jour les paramètres d’URL au lieu de les mettre à jour dans l’URL du flux, l’URL du flux n’a pas besoin de passer par une révision éditoriale et vos annonces continueront à être diffusées sans interruption. Par exemple, si l’URL de votre offre de produit dans le flux de catalogue est https://contoso.com/, vous pouvez spécifier le modèle de suivi suivant : {lpurl} ?matchtype={matchtype}&device={device}.

Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?

• Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent ceux définis pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.

• La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.

• Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.

• Microsoft Advertising ne vérifie pas s’il existe des paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}et que ni {_season} ni {_promocode} n’est défini au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule