Migrer vers les libellés du flux

Vous pouvez utiliser le champ feedLabel pour ajouter un libellé à vos produits et flux de données.

Les libellés de flux peuvent avoir le format suivant :

  • Chaîne de type
  • 20 caractères ou moins
  • Lettres majuscules (A-Z)
  • Nombres (0-9)
  • Tirets (-)

feedLabel est disponible dans les ressources suivantes :

Identifiant REST

Pour les nouveaux produits, feedLabel remplace targetCountry dans les identifiants REST.

Pour les nouveaux produits, l'identifiant REST se présente désormais sous la forme online:language:feedLabel:offerId, qui remplace le format online:language:targetCountry:offerId. Cela ne modifie pas l'identifiant REST des produits existants.

Obtenir et diffuser des produits

Le champ feedLabel est toujours renseigné pour l'ensemble des produits renvoyés.

Si feedLabel correspond à un code de territoire CLDR valide, nous remplissons automatiquement le champ targetCountry pour des raisons de compatibilité. Si feedLabel ne correspond pas à un code de territoire CLDR valide, nous laissons le champ targetCountry vide.

Les mêmes modifications s'appliquent pour les points de terminaison productstatuses.

Les champs spécifiques au pays sont vides pour les offres dont l'attribut feedLabel ne correspond pas à un code de territoire CLDR.

Insérer et mettre à jour des produits

Pour insérer de nouveaux produits, vous devez renseigner feedLabel ou targetCountry. Si vous insérez ou mettez à jour des produits avec feedLabel et targetCountry, leurs valeurs doivent correspondre.

Si les deux champs sont vides ou si leurs valeurs ne correspondent pas, l'API vous enverra un message d'erreur.

Pour en savoir plus, consultez Utiliser des libellés de flux pour promouvoir des produits provenant de flux spécifiques.

Ciblage par pays

Utilisez l'un des champs suivants pour vous assurer que vos produits ciblent les bons pays :

Produits

Le champ targetCountry pour products est obsolète. Utilisez plutôt le champ shipping pour indiquer vos pays cibles.

Si vous souhaitez cibler plusieurs pays, vous pouvez continuer à utiliser shipping pour ajouter d'autres pays.

Pour en savoir plus, consultez Cibler des annonces dans plusieurs pays.

Datafeeds

Vous pouvez désormais voir les pays ciblés explicitement par datafeed dans targets. Cela s'applique lorsque vous utilisez feedLabel au lieu de country dans la configuration datafeedtarget.

Nous avons également ajouté le champ targetCountries pour datafeeds afin que vous puissiez configurer directement le ciblage de datafeeds. Vous pouvez tout de même configurer le ciblage en dehors du flux, par exemple en définissant l'attribut shipping de la ressource Products.

Conversion de UK en GB

Nous autorisons actuellement la valeur UK pour le champ targetCountry, bien qu'il ne s'agisse pas d'un code pays valide. Nous convertissons automatiquement la valeur UK en GB. Les produits qui affichent la valeur UK pour targetCountry sont stockés avec la valeur GB dans leur identifiant REST et leur attribut offerId.

Si vous définissez la valeur UK pour feedLabel, elle ne sera pas automatiquement convertie en GB. UK et GB sont des chaînes différentes pour l'attribut feedLabel, et entraînent la création d'offres différentes.

Si vous renseignez la valeur UK pour targetCountry, et que nous la convertissons en GB, vous devez mettre à jour l'identifiant REST du produit pour qu'il prenne en compte la valeur GB plutôt que UK, afin de pouvoir récupérer le produit grâce à la méthode get.

Acheter sur Google

Les nouveaux marchands doivent utiliser "US" comme libellé de flux pour promouvoir leurs produits via Acheter sur Google.