Inserzioni per effettuare una chiamata dall'API Marketing di Meta

Questa guida spiega come creare e pubblicare inserzioni per effettuare una chiamata utilizzando l'API Marketing di Meta.

Panoramica della creazione delle inserzioni

Per creare e pubblicare un'inserzione, dovrai completare i seguenti passaggi:

Creazione di una campagna pubblicitaria
Creazione di un gruppo di inserzioni collegato alla campagna pubblicitaria
Creazione di una creatività dell'inserzione per l'inserzione per effettuare una chiamata
Creazione di un'inserzione attraverso il collegamento della creatività dell'inserzione al gruppo di inserzioni
Pubblicazione dell'inserzione su Facebook e Instagram

Prima di iniziare

Questa guida presuppone che tu abbia:

un account pubblicitario con Meta con un metodo di pagamento valido
caricato qualsiasi risorsa, come immagini o video, da utilizzare nelle inserzioni sui server di Meta.

Per effettuare chiamate che vadano a buon fine a tutti gli endpoint indicati in questa guida, avrai bisogno:

di un token d'accesso della Pagina richiesto da una persona che possa eseguire l'attività ADVERTIZE sulla Pagina;
delle seguenti autorizzazioni che devono essere concesse a una persona che utilizza la tua app:
- ads_management
- pages_manage_ads
- pages_read_engagement
- pages_show_list

Consigli

Assicurati di impostare gli orari di apertura della tua azienda nelle Impostazioni della Pagina Facebook.

Quando esegui il test di una chiamata API puoi includere il parametro access_token impostato sul tuo token d'accesso. Quando invece effettui chiamate protette dalla tua app, usa la classe del token d'accesso.

Limitazioni

Il pubblico di destinazione deve avere almeno 18 anni
Il numero di telefono incluso nella call to action deve essere dello stesso Paese del pubblico di destinazione

Passaggio 1: creazione di una campagna

Per creare una campagna pubblicitaria, invia una richiesta POST all'endpoint act_ad_account_id/campaigns in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

name
objective: impostato su uno dei seguenti obiettivi supportati:
- OUTCOME_AWARENESS
- OUTCOME_ENGAGEMENT
- OUTCOME_LEADS
- OUTCOME_SALES
- OUTCOME_TRAFFIC
special_ad_categories

Esempio di richiesta

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto, come ad_account_id, con i tuoi valori.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'ID per la tua campagna.

{
  "id": "campaign_id"
}

Passaggio 2: creazione di un gruppo di inserzioni

Per creare un gruppo di inserzioni, invia una richiesta POST all'endpoint act_ad_account_id/adsets in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

bid_amount
billing_event impostato su IMPRESSIONS
campaign_id
daily_budget
destination_type impostato su PHONE_CALL
name
optimization_goal impostato su QUALITY_CALL per le inserzioni per effettuare una chiamata
targeting

Esempio di richiesta

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto, come ad_account_id, con i tuoi valori.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

In caso di azione eseguita correttamente, l'app riceve la seguente risposta JSON con l'ID per il gruppo di inserzioni.

{
  "id": "adset_id"
}

Passaggio 3: creazione della creatività dell'inserzione

La creatività dell'inserzione ti consente di aggiungere le risorse alle inserzioni. Sono supportate le inserzioni carosello, immagini, solo testo e video.

Per creare una creatività dell'inserzione, invia una richiesta POST all'endpoint /act_ad_account_id/adcreatives in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

name
object_story_spec
object_story_spec con un oggetto link_data che definsice la call_to_action con type impostato su CALL_NOW e value come numero di telefono per la tua azienda

Esempio di richiesta dell'inserzione con immagine

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto, come page_access_token, con i tuoi valori.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

In caso di azione eseguita correttamente, l'app riceve la seguente risposta JSON con l'ID per la creatività dell'inserzione.

{
  "id": "ad_creative_id"
}

Passaggio 4: creazione dell'inserzione

Per creare l'inserzione devi associare la creatività dell'inserzione e il gruppo di inserzioni. Per creare l'inserzione, invia una richiesta POST all'endpoint /act_ad_account_id/ads in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere i seguenti elementi:

adset_id (del Passaggio 2)
creative_id (del Passaggio 3)
name
status

Esempio di richiesta dell'inserzione con creatività

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto, come ad_account_id, con i tuoi valori.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

In caso di azione eseguita correttamente, l'app riceve la seguente risposta JSON con l'ID dell'inserzione.

{
  "id": "ad_id"
}

Passaggi successivi

Consulta la guida Primi passi per scoprire come inviare la tua inserzione per il controllo.

Ulteriori informazioni

Scopri di più sull'API Marketing e altre opzioni per le inserzioni per effettuare una chiamata.

Centro assistenza per le aziende

Visualizza le metriche per le inserzioni per effettuare una chiamata in Gestione inserzioni