Catalogo localizzato per le inserzioni del catalogo Advantage+

Panoramica

Usa questa guida per configurare il tuo catalogo localizzato per le inserzioni del catalogo Advantage+.

Il tuo catalogo è un oggetto (o contenitore) di informazioni sui tuoi prodotti in cui puoi caricare il tuo inventario.

Come funziona

Meta fornisce la funzionalità di catalogo localizzato, che ti permette di configurare il tuo catalogo prodotti per mostrare gli articoli nelle inserzioni o fare shopping in diversi Paesi. Un caso d'uso comune è la localizzazione di valuta, prezzo, titolo tradotto o descrizione. Puoi anche fornire un URL di un prodotto localizzato per dirigere il cliente verso un sito web di prodotto specifico per Paese o per lingua. Scopri di più su come configurare il tuo catalogo localizzato.

Creare un modello per le inserzioni del catalogo Advantage+

Quando crei un modello per le inserzioni del catalogo Advantage+, puoi specificare le personalizzazioni delle creatività in diverse lingue. Ad esempio, puoi mostrare un titolo diverso alle persone che parlano un'altra lingua.

Oltre agli altri campi nei dati del modello della creatività (all'interno delle specifiche della storia dell'oggetto), puoi specificare un array di personalizzazioni, nel campo customization_rules_spec, in cui ogni personalizzazione ha il formato seguente:

Nome del campoDescrizioneAccetta i parametri del modello

customization_spec

tipo: oggetto

Obbligatorio.

Descrive la lingua per la personalizzazione. Scopri come creare inserzioni del catalogo Advantage+ per più lingue e Paesi, Centro assistenza per le inserzioni.

Esempio: {'language' => 'en_XX'}

No

message

tipo: stringa

Facoltativo.

Messaggio per la tua inserzione, visibile su Instagram.

Esempio: Test {{product.name | titleize}}

link

tipo: stringa

Facoltativo.

Link al tuo sito web, utilizzato per generare la didascalia dell'inserzione. Questo campo viene sempre sostituito con il campo link dal tuo elenco prodotti, tranne l'unità finale delle inserzioni carosello che collega ad esso. Non può essere un URL su Facebook.com.

Esempio: //link.com


Per le inserzioni con raccolta, puoi utilizzare link per fornire un documento per le Esperienze interattive, come descritto dettagliatamente in Inserzioni con raccolta.

Esempio: https://fb.com/canvas_doc/CANVAS_ID

No

name

tipo: stringa

Facoltativo.

Nome o titolo per la tua inserzione, visibile su Instagram.

Esempio: Headline {{product.price}}

description

tipo: stringa

Facoltativo.

Descrizione dell'inserzione. Non visibile su Instagram.

Esempio: Description {{product. description}}

template_url_spec

tipo: oggetto

Facoltativo.

Può essere utilizzato per fornire un deep link web, come descritto dettagliatamente in Monitoraggio dei clic e modelli. Nota: è supportato solo il deep link web.

Esempio: {'web' => {'url' => DEEP_LINK}}
Esempio: {'web' => {'url' => 'example://link/?id={{product. retailer_id}}'}}

video_id

tipo: intero

Facoltativo.

Solo per le inserzioni con raccolta, puoi utilizzare video_id per fornire il video per il contenuto multimediale promozionale con raccolta, come descritto dettagliatamente in Inserzioni con raccolta.

Esempio: 1234

No

picture

tipo: stringa

Facoltativo.

Solo per le inserzioni con raccolta, puoi utilizzare picture per fornire un'immagine per il contenuto multimediale promozionale con raccolta, come descritto dettagliatamente in Inserzioni con raccolta.

Esempio: https://url/image.jpg

No

Quando specifichi l'array di personalizzazioni, solo una personalizzazione deve specificare esclusivamente customization_spec, che identifica la lingua del testo non personalizzato utilizzato in template_data.

Quando viene visualizzata l'inserzione, la lingua di visualizzazione viene scelta in base alla lingua dell'interfaccia della persona che visualizza e ad altri segnali. Meta utilizza anche le proprietà del prodotto dall'elenco della lingua del catalogo in modo che corrisponda alla lingua di visualizzazione, se disponibile.

Vedi anche Creare un modello di creatività, Campi supportati per le inserzioni del catalogo Advantage+ e Formati di elenco supportati per le inserzioni del catalogo Advantage+.

Modello per le inserzioni con raccolta

Quando crei inserzioni con raccolta, puoi specificare le personalizzazioni delle creatività, in modo simile alle inserzioni del catalogo Advantage+ multilingua tramite customization_rules_spec.

Limitazioni:

  • link deve essere creato per le inserzioni con raccolta utilizzando i modelli: Vetrina interattiva, in precedenza "Vendita di prodotti, griglia (1932289657009030)"
  • Il modello per le inserzioni con raccolta viene pubblicato solo tramite un posizionamento del feed di Facebook mobile.

Esempi

Visualizzazione in anteprima delle inserzioni del catalogo Advantage+ in più lingue o Paesi per una lingua o un Paese diverso

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'dynamic_customization={
       "language": "fr_XX",
       "country": "FR"
     }' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews

Creazione di un modello di inserzioni del catalogo Advantage+ carosello con più lingue

curl -X POST \
  -F 'name="Dynamic Ad Template Creative Sample"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "message": "English Test {{product.name | titleize}}",
         "link": "http://www.example.com/englishurl",
         "name": "English Headline {{product.price}}",
         "description": "English Description {{product.description}}",
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "message": "French Test {{product.name | titleize}}",
             "link": "http://www.example.com/frenchurl",
             "name": "French Headline {{product.price}}",
             "description": "French Description {{product.description}}",
             "template_url_spec": {
               "web": {
                 "url": "http://www.example.com/frenchdeeplink"
               }
             }
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'template_url_spec={
       "web": {
         "url": "http://www.example.com/englishdeeplink"
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Creazione di un'inserzione con raccolta con contenuto multimediale promozionale immagine con più lingue

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "picture": "<IMAGE_URL>",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Creazione di un'inserzione con raccolta con contenuto multimediale promozionale video con più lingue

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "video_id": "<VIDEO_ID>",
         "image_url": "<IMAGE_URL>",
         "title": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE",
           "value": {
             "link": "<CANVAS_LINK>"
           }
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "video_id": "<VIDEO_ID_FR>",
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Creazione di inserzioni con raccolta con contenuto multimediale promozionale video dinamico con più lingue

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "format_option": "collection_video",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives