Partager via


Objet de données ProductCondition - Gestion des campagnes

Définit une condition qui détermine si un produit est sélectionné dans le fichier catalogue Microsoft Merchant Center d’un client.

Vous pouvez utiliser des conditions de production au niveau de la campagne avec les campagnes Shopping, les campagnes d’audience basées sur les flux et les campagnes de recherche avec des publicités multimédias, c’est-à-dire les campagnes qui tirent parti d’un ID de magasin Microsoft Merchant Center. (Remarque : Tout le monde n’a pas encore de campagnes de recherche avec des publicités multimédias. Si ce n’est pas le cas, ne vous inquiétez pas - il sera bientôt disponible !) Les conditions de produit au niveau du groupe d’annonces ne peuvent être utilisées qu’avec les campagnes Shopping. Les conditions de produit au niveau du groupe de ressources ne peuvent être utilisées qu’avec les campagnes Performance Max. 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.

Syntaxe

<xs:complexType name="ProductCondition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Attribute" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operand" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operator" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Éléments

L’objet ProductCondition contient les éléments suivants : Attribute, Operand, Operator.

Élément Description Type de données
Attribut 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.

Les valeurs d’attribut et d’opérande disponibles varient en fonction du type de campagne. Pour connaître les valeurs d’attribut et d’opérande prises en charge, consultez remarques ci-dessous.

Ajouter ou appliquer : Obligatoire
Mettre à jour: Optionnel
chaîne
Opérande Opérande de la condition. Les opérandes incluent implicitement l’opérateur égal. Par exemple, lisez Brand as Brand=.

Ajouter ou appliquer : Obligatoire
Mettre à jour: Optionnel
chaîne
Opérateur Opérateur d’élément de règle.

Ajouter: Obligatoire
Mettre à jour: Obligatoire
chaîne

Remarques

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 objets ProductScope de campagne et ProductPartition 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.

Remarque

Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, il sera bientôt disponible !

Plusieurs conditions de produit peuvent être spécifiées pour chaque campagne de recherche Microsoft avec des publicités multimédias. 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 de recherche, les conditions du produit peuvent être définies au niveau de la campagne. Le tableau suivant décrit les règles métier Condition du produit (opérande) et Valeur de produit (attribut) pour les objets ProductScope de campagne.

Condition du produit (opérande) Description de la valeur du produit (attribut) Règles d’étendue de produit de campagne
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.
CategoryL1

Une valeur d’opérande de catégorie est disponible, c’est-à-dire CategoryL1.
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.

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

Une valeur d’opérande de type de produit est disponible, c’est-à-dire ProductType1.
Type de produit ou catégorie défini par le marchand.

ProductType1 est le type de produit de niveau le plus élevé.

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.

Conditions du produit pour les campagnes de performances maximales

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 .

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AssetGroupListingGroup
ProductPartition
ProductScope