API Marketing

Creatività dell'inserzione

Usa le inserzioni di Facebook con i tuoi clienti esistenti e per raggiungerne di nuovi. Ogni guida descrive i prodotti dedicati alle inserzioni di Facebook che ti aiutano a raggiungere i tuoi obiettivi pubblicitari. Esistono diversi tipi di unità pubblicitarie con diversi aspetti, posizionamenti e creatività disponibili. Per le linee guida sulle unità pubblicitarie in termini di contenuti delle creatività, consulta la guida alle inserzioni di Facebook.

Creatività

Le creatività dell'inserzione sono un oggetto che contiene tutti i dati per la visualizzazione dell'inserzione stessa. Nell'API sono presenti diversi tipi di inserzioni che è possibile creare su Facebook, tutti elencati qui.

Se hai una campagna con l'obiettivo Interazione con un post della Pagina, adesso puoi creare un'inserzione per promuovere un post pubblicato dalla Pagina, considerata anche un'inserzione da un post della Pagina. Le inserzioni da un post della Pagina richiedono il campo object_story_id, che è la proprietà id di un post della Pagina. Scopri di più sul riferimento sulle creatività dell'inserzione.

Le creatività dell'inserzione presentano tre parti:

  • Le creatività dell'inserzione stesse, definite dagli attributi grafici dell'oggetto delle creatività.
  • Il posizionamento in cui viene pubblicata l'inserzione.
  • L'anteprima dell'unità stessa, per posizionamento.

Per creare l'oggetto per le creatività dell'inserzione, effettua la chiamata seguente:

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

La risposta alla chiamata API è l'id dell'oggetto creative. Memorizzalo, poiché ti serve per l'oggetto ad:


curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Limiti

Esistono limiti relativi al testo, alle dimensioni e alle proporzioni delle immagini, nonché ad altri aspetti delle creatività. Consulta la guida alle inserzioni.

Lettura

Nell'API Ads, ogni campo da recuperare deve essere richiesto esplicitamente, fatta eccezione per id. Il riferimento per ogni oggetto presenta una sezione per la rilettura dell'oggetto ed elenca i campi leggibili. Per le creatività, sono gli stessi campi specificati al momento della creazione dell'oggetto e id.


curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>Open In Graph API Explorer

Posizionamenti

Il posizionamento è il punto in cui viene mostrata la tua inserzione su Facebook, ad esempio il feed sul computer, il feed su un dispositivo mobile o la colonna destra. Consulta la guida ai prodotti delle inserzioni.

È consigliabile pubblicare inserzioni nell'intera gamma di posizionamenti disponibili. L'asta pubblicitaria di Facebook è progettata per pubblicare impression di inserzioni al posizionamento che con maggiore probabilità restituirà risultati della campagna al costo minore possibile.

Il modo più semplice per trarre vantaggio da questa ottimizzazione è lasciare vuoto questo campo. Puoi anche selezionare posizionamenti specifici in un campo target_spec del gruppo di inserzioni.

Questo esempio prevede un'inserzione da un post della Pagina. I posizionamenti disponibili sono feed mobile, feed del computer e colonna destra di Facebook. Nell'API, consulta Opzioni di posizionamento. Se scegli desktopfeed e rightcolumn come page_type, l'inserzione viene pubblicata nei posizionamenti feed del computer e colonna destra. Qualsiasi inserzione creata al di sotto di questo gruppo di inserzioni prevede solo il posizionamento su computer.

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

Anteprima di un'inserzione

Puoi visualizzare un'anteprima dell'inserzione in due modi diversi: tramite l'API Ad Preview o il plug-in per l'anteprima dell'inserzione.

Sono disponibili tre modi per generare un'anteprima tramite l'API:

  1. Per ID dell'inserzione
  2. Per ID delle creatività dell'inserzione
  3. Per specifica per le creatività

In base ai documenti di riferimento dell'API per l'anteprima, la chiamata API minima richiesta è:


curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

La specifica per le creatività è un array di ogni campo e valore necessario per creare le creatività dell'inserzione.

Attualmente, la chiamata per le creatività dell'inserzione è:


curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Usa object_story_id nella chiamata API per l'anteprima:


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

I valori disponibili per ad_format sono leggermente diversi rispetto a page_types. Tuttavia, in questo scenario, sono selezionati il feed del computer e la colonna destra di Facebook. Sono quindi necessarie due chiamate all'API per generare le anteprime di ogni posizionamento:



curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

La risposta è un iFrame valido per 24 ore.

Altro