Enregistrement de groupe d’annonces de groupe de ressources - En bloc
Définit un groupe de listes de groupes de ressources qui peut être chargé et téléchargé dans un fichier en bloc.
Vous pouvez charger des enregistrements de groupe d’annonces pour plusieurs groupes d’annonces dans le même fichier en bloc, à condition que les règles de validation soient 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, il vous suffit de charger les champs Id et Id parent .
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.
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.
Vous pouvez télécharger tous les enregistrements du groupe de listes de groupes de ressources dans le compte en incluant la valeur DownloadEntity de AssetGroupListingGroups 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.
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 BulkAssetGroupListingGroup , 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.
Pour un enregistrement de groupe de listes de groupes de ressources, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
- Groupe de ressources
- Campagne
- Client Id
- Id
- Est exclu
- Heure de modification
- Parent Id
- ID de groupe de listes parentes
- Condition de produit 1
- Valeur de produit 1
- État
- Sous-type
Groupe de ressources
Nom du groupe de ressources auquel appartient le groupe de référencements de groupe d’actifs.
Pour ajouter, mettre à jour et supprimer, vous devez spécifier l’ID parent ou le champ Groupe de ressources et campagne .
Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
Campagne
Nom de la campagne qui contient le groupe de ressources et le groupe de référencements.
Pour ajouter, mettre à jour et supprimer, vous devez spécifier l’ID parent ou le champ Groupe de ressources et campagne .
Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
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 du groupe de référencement du groupe de ressources.
Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour le groupe de référencement de groupes de ressources peut ensuite être référencé dans le champ ID parent des types d’enregistrements dépendants tels que les annonces, les mots clés ou le critère. Cette option est recommandée si vous ajoutez de nouveaux groupes de listes de groupes de ressources et de nouveaux enregistrements dépendants 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
Est exclu
Détermine si les produits appartiennent au groupe de listes doivent être exclus lors du service.
Si la valeur est true , il s’agit d’un critère négatif ; sinon, si la valeur est false , il s’agit d’un critère positif.
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é).
Notes
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
ID du groupe de ressources qui contient le groupe de référencements.
Pour ajouter, mettre à jour et supprimer, vous devez spécifier l’ID parent ou le champ Groupe de ressources et campagne .
Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
ID de groupe de listes parentes
Au minimum, vous devez spécifier au moins le nœud racine pour l’arborescence.
Le nœud racine du groupe de listes doit avoir son champ Condition de produit 1 défini sur Tous et Valeur du 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 produits en fonction de conditions de produit plus spécifiques, définissez le champ Sous-type sur Subdivision, l’ID du groupe de listes parent sur Null ou vide et l’ID sur une valeur négative. Vous utiliserez la valeur négative comme ID de groupe de listes parentes pour tous les nœuds enfants.
Ajouter: Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
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 groupe de ressources Microsoft Performance Max. 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 Performance Max, les conditions du produit ne peuvent être définies qu’au niveau du groupe de ressources. Le tableau suivant décrit les règles métier Condition de produit (opérande) et Valeur de produit (attribut) pour les objets AssetGroupListingGroup du groupe de ressources.
| Condition du produit (opérande) | Description de la valeur du produit (attribut) | Règles de partition de produit du groupe de ressources |
|---|---|---|
| tous | Doit être null. | Pour les partitions de produits d’un groupe de ressources, 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. |
Pour les partitions de produits d’un groupe de ressources, l’opérande du nœud racine doit avoir la valeur All et l’attribut défini sur null ou vide. |
| 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é dans plusieurs branches. 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 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 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 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. |
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 . |
| ID | Identificateur de produit défini par le commerçant. Un maximum de 1 000 caractères. |
L’opérande Id 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. |
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
État
État du groupe de référencements du groupe de ressources.
Les valeurs possibles sont Actif, Supprimé.
Ajouter: Optionnel.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.
Sous-type
Type de groupe de référencements de groupe de ressources.
Les valeurs possibles sont Subdivision et Unit.
Ajouter: Obligatoire
Mettre à jour: En lecture seule
Supprimer: En lecture seule