Multi-Language Ads

Personalizza diverse parti di una creatività dell'inserzione come l'immagine, il video, il testo e il corpo dell'inserzione per raggiungere persone di diverse lingue. Facebook ottimizza la tua inserzione in modo da mostrare a ciascun utente la lingua corretta.

Questo ti aiuta a configurare con facilità un'inserzione in più lingue e mostrarla nella lingua più pertinente per ciascun utente così da mantenere una vasta targetizzazione delle inserzioni. In questo modo potrai disporre di un contenuto personalizzato in base alla lingua parlata dall'utente, mantenendo al contempo le inserzioni convenienti.

Per informazioni generali su questa funzione, consulta Centro assistenza per le inserzioni, Realizzare inserzioni per un pubblico multilingue. Consulta gli obiettivi della campagna pubblicitaria supportati.

Multi-Language Ads è una delle nostre tre API che utilizzano le regole di personalizzazione delle risorse.

Primi passi

Prima di iniziare, controlla le restrizioni per questo prodotto. Se il tuo caso d'uso soddisfa le nostre specifiche, vai ai passaggi successivi:

• Passaggio 1: Crea una campagna pubblicitaria e un gruppo di inserzioni
• Passaggio 2: Fornisci le creatività tramite asset_feed_spec, vedi anche Lingue disponibili
• Passaggio 3: Crea un'inserzione con asset_feed_spec in creative_spec
• Passaggio 4 opzionale: Visualizza in anteprima l'inserzione

Se non disponi delle risorse per tradurre manualmente l'inserzione, dai un'occhiata al nostro servizio di traduzione automatica.

Passaggio 2: Fornisci le creatività tramite asset_feed_spec

Le creatività di Multi-Language Ads sono specificate usando asset_feed_spec. Un elenco di risorse è una raccolta di diversi elementi delle creatività, come immagine, titolo, corpo del testo e così via. Crea un elemento asset_feed_spec su /adcreative.

Per creare un elemento asset_feed_spec, indica un array di risorse per ogni lingua. Aggiungi un'etichetta per taggare ciascuna risorsa in modo da identificare la lingua a cui appartiene. Facebook usa le etichette in asset_customization_rules per raggruppare le risorse per lingua. Devi indicare almeno una risorsa per tipo.

Parametri disponibili

I parametri da indicare in asset_feed_spec includono:

Regole sulla personalizzazione delle risorse

Definiscono le risorse mostrate congiuntamente per gli utenti che parlano una determinata lingua. Ogni regola ha una customization_spec che definisce le lingue delle persone che visualizzano queste risorse durante la pubblicazione dell'inserzione.

Indica esattamente una regola predefinita. Questa regola deve includere le risorse che Facebook visualizza se la lingua preferita di un utente non corrisponde a nessuna delle lingue specificate nell'elenco di risorse. Ciò contribuisce a prevenire una pubblicazione inefficace delle inserzioni.

Lingue disponibili

Le lingue che indichi in customization_spec devono essere associate a ID supportati nella targetizzazione delle inserzioni. Consulta Targetizzazione e posizionamento , Lingue. Puoi cercare una lingua specifica usando l'endpoint /search. Usa il parametro q per cercare il nome di una lingua specifica. Lascia questo parametro vuoto per ottenere una lista di tutte le lingue supportate:

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

In caso di azione eseguita correttamente, otterrai una lista di lingue:

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

Devi utilizzare i tasti in questi risultati della ricerca come lingue nelle tue regole di personalizzazione delle risorse. Per maggiori informazioni, consulta Ricerca targetizzazione.

Passaggio 3: Crea inserzioni usando le specifiche dell'elenco di risorse

Puoi creare un elenco di risorse usando il campo asset_feed_spec in 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": "<IMAGE_HASH>",
         },
       ],
       "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/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

In caso di azione eseguita correttamente, otterrai l'ID per le creatività dell'inserzione:

{"id":"238474593777777"}

Se la tua asset_feed_spec non soddisfa le restrizioni sotto, visualizzerai un errore.

Per creare un'inserzione con questo ID delle creatività dell'inserzione, chiama POST act_AD_ACCOUNT_ID/ads. In alternativa, per visualizzare diverse lingue nella tua inserzione, indica asset_feed_spec e object_story_spec nel parametro creative dell'inserzione.

Per verificare la nuova asset_feed_spec, chiama GET sull'ID dell'inserzione o sull'ID delle creatività dell'inserzione.

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

Passaggio 4 opzionale: visualizza in anteprima l'inserzione

Visualizza in anteprima le diverse lingue della tua inserzione usando l'endpoint generatepreview. Aggiungi un campo dynamic_asset_label con una adlabel in una regola per visualizzare una lingua specifica.

Ad esempio, per visualizzare in anteprima la versione in lingua francese della creatività in alto:

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/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Traduzioni automatiche

Puoi usare il nostro servizio di traduzione automatica se non disponi delle risorse necessarie a tradurre manualmente le inserzioni. Questa funzionalità traduce il testo predefinito dell'inserzione in altre lingue, consentendoti di raggiungere un pubblico multilingue.

La fonte per la traduzione automatica si trova nelle risorse di testo specificate dalla regola di personalizzazione delle risorse predefinita. I testi delle inserzioni tradotti automaticamente sono etichettati come "Tradotte automaticamente".

Per creare una versione tradotta automaticamente del testo di un'inserzione, aggiungi autotranslate a asset_feed_spec. Quindi, specifica le lingue in cui desideri tradurre il testo. Vedi l'esempio:

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"],
       "optimization_type": "LANGUAGE",
       "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/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

I testi tradotti automaticamente possono essere rivisti con una chiamata al campo asset_feed_spec sulla creatività.

Eventuali modifiche ai testi tradotti automaticamente sulla specifica saranno rifiutate se la stessa lingua è specificata nel campo autotranslate. Queste modifiche saranno sostituite da nuove traduzioni del testo predefinito dell'inserzione. Se tali modifiche sono assolutamente necessarie, rimuovi la lingua dal campo autotranslate.

link_urls

Puoi aggiungere un URL personalizzato alla versione dell'inserzione tradotta automaticamente.

Per farlo, aggiungi un URL language-specific al campo link_urls insieme a una adlabel, quindi aggiungi una nuova regola alle asset_customization_rules con codici della lingua e link_url_label associati a questa lingua.

Restrizioni

Di seguito sono riportati restrizioni e limiti al tuo elenco di risorse.

Formati pubblicitari

• Un solo formato pubblicitario per asset_feed_spec
• Per il formato SINGLE_IMAGE, devi indicare almeno un'immagine.
• Per il formato SINGLE_VIDEO, devi indicare almeno un video.

Informazioni generali sulle risorse

• Puoi indicare un massimo di 49 risorse per ciascun tipo di risorsa, eccetto call_to_action_types.
• Devi indicare esattamente una risorsa call_to_action_type per tutti gli obiettivi.

Risorse di testo

• Devi indicare almeno una risorsa di testo, come titles, bodies, descriptions e link_urls, per ogni lingua nell'elenco di risorse.
• Tutte le risorse di testo devono avere il campo adlabels.
• Lunghezza massima: 255 caratteri per il titolo, 4096 caratteri per il corpo del testo e 10 000 caratteri per la descrizione.

Risorse immagini e video

• Per le dimensioni delle immagini consigliate in base a posizionamento e obiettivo, consulta la Guida alle inserzioni.
• Puoi usare una sola risorsa immagine o video senza adlabel. Utilizzeremo questa immagine o questo video per tutte le lingue.
• Se fornisci video o immagini aggiuntivi, devi includere le rispettive adlabel e indicare queste etichette nella tua regola di personalizzazione delle risorse.

Risorse URL

• Se indichi url_tags, li alleghiamo all'elemento link_url come parametri per ciascuna risorsa nell'inserzione.
• Se usi l'obiettivo APP_INSTALLS, il tuo link_url deve coincidere con il promoted_object.object_store_url del gruppo di inserzioni.

Regole sulla personalizzazione delle risorse

• Devi indicare una regola di personalizzazione delle risorse per ogni variante linguistica in asset_feed_spec.
• Devi indicare una regola predefinita. Si tratta di una regola di personalizzazione delle risorse con is_default impostato su true. Funge da regola di backup e consente la visualizzazione delle inserzioni persino nel caso in cui la lingua di un utente non corrisponda a nessuna delle lingue in asset_feed_spec.

Posizionamenti

• Multi-Language Ads supporta tutti i posizionamenti.

Obiettivi e tipi di destinazione disponibili

• LINK_CLICKS: sito web e app, Messenger escluso.
• APP_INSTALLS: app per computer o mobili.
• CONVERSIONS: sito web e app, Messenger escluso.
• REACH: tutti i tipi di destinazione.
• BRAND_AWARENESS: tutti i tipi di destinazione.
• VIDEO_VIEWS: tutti i tipi di destinazione.

Tipi di acquisto supportati

• REACH: copertura e frequenza
• AUCTION

Lingue di destinazione supportate per la traduzione

Sono supportate per la traduzione le seguenti lingue di destinazione. Usa il codice linguistico corrispondente nel campo autotranslate: