API Marketing

Inserzioni per effettuare una chiamata

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

Prima di iniziare

Questa guida presuppone che tu abbia:

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/v21.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/v21.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/v21.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:

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/v21.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.

Scopri di più

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

Centro assistenza per le aziende

API Marketing