API Marketing

Opzioni specifiche degli elenchi di risorse

Puoi usare le seguenti opzioni nel tuo asset_feed_spec. Consulta le Specifiche degli elenchi delle risorse pubblicitarie per maggiori informazioni di riferimento.

Nome della proprietà Descrizione

images

tipo: array di lista

Obbligatorio per il formato SINGLE_IMAGE e CAROUSEL_IMAGE.

Array di immagini idonee. Le immagini fornite in questo array dovrebbero essere incluse nella libreria di immagini dell'account pubblicitario.


Fornisci questo campo come un array di lista contenente {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}. È obbligatorio url o hash.

videos

tipo: array di lista

Obbligatorio per il formato SINGLE_VIDEO.

Array di video_id. I video_id forniti in questo array devono appartenere all'account pubblicitario.


Fornisci questo campo come array di lista contenente {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}

carousels
tipo: array di lista

Facoltativo.
Array di child_attachments insieme ai booleani multi_share_end_card e multi_share_optimized e a adlabels. I child_attachments forniti in questo array devono appartenere all'account pubblicitario.



Fornisci child_attachments come array di lista contenente {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}. È obbligatorio image_label o video_label.

bodies

tipo: array di lista

Facoltativo.

Array di corpi. Il messaggio o il testo principale dell'inserzione.


Fornisci questo campo come array di lista di {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}.

call_to_action_types

tipo: array di lista

Obbligatorio per tutti gli obiettivi, eccetto OUTCOME_AWARENESS.

Array di valori del tipo di call to action.


Fornisci questo campo come array di lista di {"{CALL_TO_ACTION}"}. Puoi fornire più valori, fino a cinque.

titles

tipo: array di lista

Facoltativo.

Array di titoli. Un breve titolo dell'inserzione, generalmente mostrato accanto a un link, un'immagine o un video.


Fornisci questo campo come array di lista di {"text": "{TITLE}", "url_tags": "{TAG}"}.

descriptions

tipo: array di lista

Facoltativo.

Array di testi descrittivi secondari, visualizzati in modo meno evidente rispetto al corpo del testo o al titolo. Generalmente appare accanto a un link, un'immagine o un video. Se non specificato, Facebook analizza il link che hai fornito per generarlo. Usa una stringa vuota con spazio singolo per la descrizione vuota, se non vuoi usare il testo estrapolato.


Fornisci questo campo come array di lista di {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}.

link_urls

tipo: array di lista

Obbligatorio.

Array di URL.


Fornisci questo campo come array di lista di {"website_url": "{URL}"}.

ad_formats

tipo: array di stringhe

Obbligatorio.

Array di formati pubblicitari di Facebook in cui dovremmo creare le inserzioni. I formati supportati sono: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT.


Fornisci questo campo come array di stringhe ["{AD_FORMAT}"].

optimization_type

tipo: stringa

Facoltativo.

Tipo di ottimizzazione usato nel feed delle risorse. I valori possibili sono ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT e REGULAR.

message_extensions

tipo: array di stringhe

Facoltativo.
Tipo di estensione del messaggio usato nel feed delle risorse.


Valore possibile: whatsapp

onsite_destinations
tipo: array di lista

Obbligatorio per le inserzioni per gli Shop. Valido per le inserzioni statiche; formato SINGLE_IMAGE, SINGLE_VIDEO o CAROUSEL.
Fornisci questo campo come array di lista contenente uno dei seguenti valori per specificare la destinazione del tuo Shop sul sito.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
tipo: booleano

Obbligatorio per le inserzioni per gli Shop. Valido per le inserzioni del catalogo Advantage+.
Fornisci questo campo per l'ottimizzazione dello Shop. Include sia i tipi di ottimizzazione dello Shop reasons_to_shop e automated_product_tags.
Valori possibili: true, false

reasons_to_shop
tipo: booleano

Obbligatorio per le inserzioni per gli Shop. Valido per le inserzioni del catalogo Advantage+.
Fornisci questo campo per l'ottimizzazione dello Shop. Mette automaticamente in evidenza le informazioni sui prodotti del tuo Shop, come "Spedizione gratuita", "Di tendenza" o "Quasi esaurito".
Valori possibili: true, false

Restrizioni delle specifiche degli elenchi delle risorse

Formati pubblicitari

  • Supportati ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO e AUTOMATIC_FORMAT.
  • È consentito un solo ad_format per feed delle risorse.
  • ad_format conta come una risorsa in un feed delle risorse.

Numero di risorse:

  • Massimo 30 risorse totali. Ad esempio, hai 28 risorse con 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url e 1 call_to_action_types.
  • Numero totale di immagini: <= 10.
  • Numero totale di video: <= 10. Se usi Instagram come posizionamento, sono consentiti solo video quadrati o video orizzontali.
  • Numero totale di corpi: <= 5.
  • Numero totale di call to action: <= 5.
  • Numero totale di titoli: <= 5.
  • Numero totale di link: <= 5.
  • Numero totale di descrizioni: <= 5.

Requisiti immagini:

  • Specifiche consigliate per le immagini: 1,9:1.
  • Dimensioni delle immagini consigliate: 1200 x 628 pixel.
  • Per il formato CAROUSEL_IMAGE, devi fornire almeno 2 immagini.
  • Se usi Instagram come posizionamento, usa immagini quadrate per prestazioni migliori.

Requisiti testo:

  • Testo del titolo e della descrizione: lunghezza massima 255 caratteri.
  • Testo del corpo: lunghezza massima 1024 caratteri.
  • Se non specifichi alcuna descrizione, analizziamo il link che hai fornito per estrapolare una descrizione.
  • Per CAROUSEL_IMAGE, i titoli sono facoltativi.

url_tags sono facoltativi e disponibili solo per images, videos, bodies, descriptions e titles. Facebook aggiunge url_tags all'URL del link come parametri per ogni risorsa in un'inserzione.

Ad esempio, una combinazione di feed delle risorse valida per il formato SINGLE_IMAGE è:

  • 5 images
  • 3 bodies
  • 3 titles
  • 3 descriptions
  • 1 formato: SINGLE_IMAGE
  • 2 link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

Uso dei deep link

Puoi usare i deep link nelle specifiche del feed delle risorse per campagne con i seguenti obiettivi:

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

Aggiungi deeplink_url in link_urls quando crei il tuo asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Inserzioni da sito web a WhatsApp

Puoi creare inserzioni che rimandano le persone a WhatsApp con un pulsante mostrato sul tuo sito web, che compare nella parte inferiore dello schermo, in modo che possano contattarti istantaneamente. Questo aiuterà le persone a connettersi con te su WhatsApp mentre visitano il tuo sito web.

Aggiungi message_extensions quando crei il tuo asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives