Configuration des catalogues localisés

Utilisez ce guide pour configurer vos catalogues pour la localisation. Découvrez également comment créer un flux linguistique ou un flux de pays pour localiser votre catalogue dans cette page d’aide sur les publicités.

Conditions requises

  • Vous devez créer un flux de données de remplacement de langues ou de pays qui ne contiendra que les champs (avec les valeurs) que vous souhaitez modifier.
  • Vous devez inclure un champ id dans votre flux de données de remplacement. L’id de chaque article doit correspondre à son id dans l’un des flux de données de votre catalogue principal et/ou à son ID de contenu dans votre pixel.
  • Vous devez inclure un champ override.
  • Vous ne pouvez pas localiser (remplacer) tous les champs, mais seulement quelques-uns. Consultez la section Champs pris en charge : catalogues localisés pour obtenir une liste des champs de catalogue pris en charge.
  • Assurez-vous que les images des produits respectent les exigences relatives au catalogue.
  • Vérifiez que les titres des produits respectent les exigences relatives au catalogue.
  • Assurez-vous que les descriptions des produits respectent les exigences relatives au catalogue.

Recommandations

Lorsque vous planifiez la configuration de votre catalogue, nous vous invitons à suivre ces recommandations :

  • Bien que vous puissiez inclure plusieurs langues dans un flux linguistique et plusieurs pays dans un flux de pays, nous vous recommandons de créer vos flux de pays et linguistiques séparément.
  • Si vous souhaitez localiser un catalogue volumineux (plus de 100 000 articles) pour plusieurs pays ou langues, créez un flux de données par langue ou pays.
  • Si vous créez un flux linguistique et un flux de pays, les champs inclus dans chaque flux devraient être uniques à ce type de flux. Par exemple, ne spécifiez pas le nom du produit dans le flux linguistique et le flux de pays.
  • Pour les produits (e-commerce), nous vous recommandons d’inclure title et description dans votre flux linguistique, et d’inclure price, sale_price, sale_price_effective_date, availability et link dans votre flux de pays.
  • À titre d’exemple, nous fournissons un modèle de remplacement linguistique et un modèle de remplacement de pays.

Voir aussi :

Étape 1 : créer des flux de pays et linguistiques

Types de flux

Vous pouvez inclure des propriétés localisées pour vos articles de catalogue, en utilisant d’autres types de flux.

Type de fluxDescriptionExemple

Flux de pays

Contient des remplacements pour certains pays. Vous pouvez créer et importer des flux de pays en utilisant le Gestionnaire des ventes ou via l’API. Découvrez les formats de flux pris en charge.

Un article peut avoir des prix différents selon les pays.

Flux linguistique

Contient des traductions pour des champs spécifiques. Vous pouvez créer et importer des flux linguistiques en utilisant le Gestionnaire des ventes ou via l’API. Découvrez les format de flux pris en charge.

Un article peut avoir des descriptions différentes selon les langues.

Flux linguistique et de pays

Destiné aux cas d’utilisation avancés, quand un flux de pays ou un flux linguistique ne suffit pas pour localiser vos articles. L’utilisation d’un flux linguistique et de pays doit être réservée aux champs qui en ont vraiment besoin.


Seule l’API permet de créer un flux linguistique et de pays, mais il est possible d’utiliser le Gestionnaire des ventes pour modifier et importer le flux, en plus de l’API. Le Gestionnaire des ventes fournit des détails sur chaque pays et chaque configuration linguistique.


Remarque : pour localiser à la fois la langue et le pays d’un champ, la valeur de la colonne override doit comprendre un code de langue ISO et un code de pays ISO pris en charge, séparés par le caractère « | » (exemple : en_XX|US).

Les URL de vos produits peuvent dépendre de la langue et du pays de l’internaute.

Par exemple : http://www.mysite.com/ca/item12345?lang=fr
or
http://www.mysite.com/ca/fr/item12345

Une limite de 350 paires de langues et de pays est imposée par article de catalogue pour les champs localisés.

Formats de flux

Flux de pays

Exemple de flux CSV : contient des localisations de pays pour le Royaume-Uni (GB) et l’Italie (IT).

      
id; override; price; link; delete
FB_product_1234; GB; 9.00 GBP; http://www.example.com/en_GB/FB_product_1234; false
FB_product_1234; IT; 10.49 EUR; http://www.example.com/it_IT/FB_product_1234; false
    

price, sale_price, unit_price, base_price, status (visibilité) et availability ne doivent être fournis que dans un flux de pays. Ces champs ne peuvent pas être fournis dans un flux linguistique. Les client·es peuvent ainsi voir les données des produits localisées.


Flux linguistique

Exemple de flux CSV : contient des localisations linguistiques pour le français (fr_XX) et l’anglais (en_XX).

      
id; override; description; title; delete
FB_product_1234; fr_XX; Le t-shirt American Apparel préféré de tous. Le t-shirt comporte une encolure ajustée de 3/4 pouce au cou, une bande épaule à épaule et un ourlet de 1 pouce sur les manches.; T-shirt Unisexe d'American Apparel; false
FB_product_1234; en_XX ; Everyone's favorite American Apparel T-shirt. The t-shirt features 3/4 inches set-in neck, shoulder to shoulder tape and 1 inch hem on sleeves.; American Apparel Unisex T-Shirt; false
    

Flux linguistique et de pays

Exemple : contient des localisations « langue et pays » pour les francophones aux États-Unis (fr_XX|US) et les francophones au Canada (fr_XX|CA).

id; override; url; delete
FB_product_1234; fr_XX|US; http://us.example.com/fr/product_1234; false
FB_product_1234; fr_XX|CA; http://ca.example.com/fr/product_1234; false

Étape 2 : vérifier l’ordre de prévalence dans vos flux

Avant de sélectionner les informations qui seront localisées, notez que nous vérifions le contenu du flux dans cet ordre :

  1. Valeurs du flux linguistique et de pays pour les langues parlées et le pays d’origine de l’utilisateur·ice
  2. Valeurs du flux linguistique pour les langues parlées de l’utilisateur·ice
  3. Valeurs du flux de pays pour le pays d’origine de l’utilisateur·ice

Étape 3 : importer les flux de pays et linguistiques

Une fois que vous avez créé vos flux, vous pouvez choisir de les importer manuellement via le Gestionnaire des ventes ou via l’API, comme indiqué ci-dessous.

Importer les flux via l’API

  1. Déposez vos flux sur votre serveur.
  2. Associez les flux à votre catalogue en utilisant un paramètre override_type supplémentaire.

Flux linguistique

Exemple : importez un flux linguistique

curl \
  -F 'name=Language feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_language_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=language'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Flux de pays

Exemple : importez un flux de pays

curl \
  -F 'name=Country Feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_country_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Flux linguistique et de pays

Exemple : importez le flux linguistique et de pays

curl \
  -F 'name=language and country Feed' \
  -F 'schedule={
        "interval": "DAILY",
        "url": "http:\/\/www.example.com\/sample_language_and_country_feed.tsv",
        "hour": 22
      }' \
  -F 'override_type=language_and_country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Paramètres

Paramètre Valeur

url

Lieu où nous pouvons récupérer le fichier de flux

interval

Fréquence à laquelle nous récupérons le fichier de flux

hour

Heure de la journée (au format 24 heures) à laquelle nous récupérons le flux

Étape 4 : supprimer les informations sur le pays ou la langue d’un produit (facultatif)

Pour supprimer des informations localisées d’un article :

  1. Indiquez une colonne « delete » (supprimer) dans votre flux de pays ou linguistique.
  2. Définissez la valeur sur true.

La localisation de ce produit sera supprimée.

Remarque : vous pouvez également supprimer (delete) des articles dans votre flux d’articles principaux. Lorsque vous supprimez un article principal, tous les remplacements sont supprimés.

Étape 5 : vérifier votre configuration dans le Gestionnaire des ventes

Le Gestionnaire des ventes fournit des informations sur les champs de pays et de langue pour chaque produit dans la page Articles > Détails.



Vous pouvez également connaître la couverture internationale de l’intégralité de votre catalogue dans l’onglet Articles > Couverture internationale.