Publicités multilingues

Personnalisez différentes parties d’un contenu créatif publicitaire, comme l’image, la vidéo, le texte et le corps d’une publicité afin qu’elle touche des publics de langues différentes. Facebook optimise votre publicité afin que la bonne version linguistique s’affiche pour la bonne audience.

Cela vous permet de configurer facilement une publicité dans plusieurs langues et d’employer la version linguistique la plus pertinente pour un spectateur donné, tout en conservant une vaste capacité de ciblage à la publicité. Vous disposez ainsi d’un contenu personnalisé et basé sur la langue du spectateur, tout en maîtrisant les coûts de vos publicités.

Pour obtenir des informations générales sur cette fonctionnalité, consultez les Pages d’aide pour les publicités, faire de la publicité auprès d’une audience multilingue. Consultez les objectifs de campagne publicitaire pris en charge.

Les publicités multilingues représentent l’une de nos trois API utilisant des règles de personnalisation des éléments.

Démarrer

Avant de démarrer, vérifiez les restrictions concernant ce produit. Si votre cas d’utilisation satisfait à nos spécifications, passez aux étapes suivantes :

• Étape 1 : Créer une campagne publicitaire et un ensemble de publicités
• Étape 2 : Fournir un contenu publicitaire via la asset_feed_spec, voir également la section Langues disponibles.
• Étape 3 : Créer une publicité avec la asset_feed_spec dans la creative_spec
• Étape 4 facultative : Obtenir un aperçu de votre publicité

Si vous ne disposez pas des ressources pour traduire manuellement votre publicité, consultez notre service de traduction automatique.

Étape 2 : Fournir un contenu publicitaire via la asset_feed_spec

Les contenus des publicités multilingues sont spécifiés avec les asset_feed_specs. Un fil de ressources est une collection de plusieurs éléments créatifs comme des images, des titres, des textes, ainsi de suite. Vous créez une asset_feed_spec sur /adcreative.

Pour créer une asset_feed_spec, fournissez un ensemble d’éléments pour chaque langue. Ajoutez une étiquette au tag de chaque ressource afin d’identifier la langue à laquelle la ressource appartient. Facebook utilise les étiquettes des asset_customization_rules pour regrouper les éléments par langue. Vous devez fournir au moins un élément par type d’élément.

Paramètres disponibles

Les paramètres à indiquer dans la asset_feed_spec sont les suivants :

Règles de personnalisation des ressources

Définissez les éléments qui apparaissent ensemble pour les spectateurs qui parlent une langue donnée. Chaque règle a une customization_spec qui définit les paramètres régionaux des personnes qui consultent ces éléments pendant la diffusion des publicités.

Indiquez exactement une règle par défaut. Cette règle doit comprendre les ressources affichées par Facebook lorsque la langue de préférence d’un utilisateur ne correspond pas aux paramètres régionaux spécifiés dans le fil de ressources. Ceci permet d’empêcher la sous-diffusion de votre publicité.

Langues disponibles

Les paramètres régionaux indiqués dans la customization_spec doivent être des ID de paramètres régionaux pris en charge dans le ciblage publicitaire. Consultez Ciblage et placement, paramètres régionaux. Vous pouvez rechercher une langue spécifique à l’aide du point de terminaison /search. Utilisez le paramètre q pour rechercher le nom d’une langue spécifique. N’inscrivez rien pour ce paramètre afin d’obtenir la liste de toutes les langues prises en charge :

curl -G 
  -d "type=adlocale"
  -d "q=en"
  -d "limit=2"
  -d "access_token=<ACCESS_TOKEN>" 
  https://graph.facebook.com/<API_VERSION>/search

En cas de réussite, vous obtenez une liste de langues :

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

Vous devez utiliser les clés de ces résultats de recherche en tant que paramètres régionaux dans vos règles de personnalisation des ressources. Pour plus d’informations, consultez Recherche de ciblage.

Étape 3 : Créer des publicités à l’aide des spécifications du fil d’éléments

Vous pouvez créer un fil d’éléments à l’aide du champ asset_feed_spec dans POST ad_account_ID/adcreatives :

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "J45p3r5m4RK374VOc4DO2",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adcreatives

En cas de réussite, vous obtenez l’ID du contenu créatif publicitaire :

{"id":"238474593777777"}

Si votre asset_feed_spec ne satisfait pas aux restrictions ci-dessous, vous verrez une erreur.

Pour créer une publicité avec cet ID de contenu publicitaire, appelez POST act_AD_ACCOUNT_ID/ads. Pour afficher plusieurs langues dans votre publicité, vous pouvez également indiquer les asset_feed_spec et object_story_spec dans le paramètre creative de la publicité.

Pour vérifier la nouvelle asset_feed_spec, appelez GET sur l’ID de la publicité ou sur l’ID du contenu publicitaire :

curl -G
-d 'fields=object_story_spec,asset_feed_spec'
-d 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/<CREATIVE_ID>

Étape 4 facultative : Obtenir un aperçu de votre publicité

Obtenez un aperçu des différentes versions linguistiques de votre publicité à l’aide du point de terminaison generatepreview. Ajoutez un champ dynamic_asset_label avec une adlabel dans une règle pour afficher une version linguistique spécifique.

Par exemple, pour obtenir un aperçu de la version française du contenu publicitaire mentionné ci-dessus :

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Traductions automatiques

Vous pouvez utiliser notre service de traduction automatique si vous ne disposez pas des ressources pour traduire manuellement votre publicité. Cette fonctionnalité permet de traduire votre texte publicitaire par défaut dans d’autres langues afin de toucher une audience multilingue.

La source de la traduction automatique se trouve dans les éléments de texte spécifiés par la règle de personnalisation des éléments par défaut. Les textes publicitaires traduits automatiquement sont classés comme "Traduits automatiquement".

Pour créer une version traduite automatiquement de votre texte publicitaire, ajoutez autotranslate à la asset_feed_spec. Spécifiez ensuite les langues dans lesquelles vous souhaiteriez traduire votre texte. Voir l’exemple :

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives/?fields=asset_feed_spec

Les textes traduits automatiquement peuvent être examinés avec un appel au champ asset_feed_spec sur le contenu publicitaire.

Toutes les modifications effectuées sur les textes traduits automatiquement sur la spécification seront annulées si la même langue est spécifiée dans le champ autotranslate. Ces modifications seront remplacées par de nouvelles traductions du texte publicitaire par défaut. Si ces modifications sont absolument nécessaires, supprimez la langue du champ autotranslate.

link_urls

Vous pouvez ajouter une URL de lien personnalisée à la version de la publicité traduite automatiquement.

Pour ce faire, ajoutez une URL language-specific dans le champ link_urls avec une adlabel, puis ajoutez une nouvelle règle dans asset_customization_rules avec les codes de paramètres régionaux associés et l’link_url_label pour cette langue.

Restrictions

Les éléments suivants constituent des restrictions et des limites de votre fil de ressources.

Formats publicitaires

• Un seul format publicitaire selon asset_feed_spec
• Pour le format SINGLE_IMAGE, vous devez fournir au moins une image.
• Pour le format SINGLE_VIDEO, vous devez fournir au moins une vidéo.

Éléments, généralités

• Vous pouvez fournir au maximum 49 éléments pour chaque type d’élément sauf pour les call_to_action_types.
• Vous devez fournir exactement un élément call_to_action_type pour tous les objectifs.

Éléments textuels

• Vous devez fournir au moins un élément textuel, comme les titles, corps, descriptions et link_urls, pour chaque version linguistique du fil d’éléments.
• Tous les éléments textuels doivent avoir le champ adlabels.
• Longueur maximale : 255 caractères pour le titre, 4 096 caractères pour le corps et 10 000 caractères pour la description.

Éléments images et vidéos

• Pour les tailles d’image recommandées par placement et objectif, consultez le Guide des publicités.
• Vous pouvez utiliser au maximum un élément image ou un élément vidéo sans adlabel. Nous utiliserons cette image ou vidéo pour toutes les versions linguistiques.
• Si vous fournissez d’autres vidéos ou images, vous devez inclure les adlabels, puis fournir ces étiquettes dans votre règle de personnalisation des éléments.

Éléments d’URL de lien

• Si vous fournissez des url_tags, nous les ajoutons à l’ link_url comme paramètres pour chaque élément de la publicité.
• Si vous utilisez l’objectif APP_INSTALLS, votre link_url doit être identique à l’promoted_object.object_store_url de l’ensemble de publicités.

Règles de personnalisation des ressources

• Vous devez fournir une règle de personnalisation des éléments pour chaque variante linguistique dans la asset_feed_spec.
• Vous devez fournir une règle par défaut. Il s’agit d’une règle de personnalisation des éléments avec is_default défini sur true. Elle fait office de règle de sauvegarde et permet d’afficher les publicités même lorsque les paramètres régionaux d’une personne ne correspondent pas aux langues de la asset_feed_spec.

Placements

• Les publicités multilingues prennent en charge tous les placements.

Objectifs disponibles et types de destination

• LINK_CLICKS - site web et applications, pas Messenger.
• APP_INSTALLS - applications de bureau ou mobiles.
• CONVERSIONS - site web et applications, pas Messenger.
• REACH - tous les types de destination.
• BRAND_AWARENESS - tous les types de destination.
• VIDEO_VIEWS - tous les types de destination

Types d’achat pris en charge

• REACH - Couverture et répétition
• AUCTION

Sens de traduction pris en charge

Les sens de traduction suivants sont pris en charge. Utilisez le code dialectal correspondant figurant dans le champ autotranslate :