Inserzioni che rimandano a più destinazioni

Questa guida spiega come creare e pubblicare inserzioni che rimandano a più destinazioni utilizzando l'API Marketing.

Le inserzioni che rimandano a più destinazioni reindirizzano le persone direttamente alle conversazioni con la tua azienda in una o più app di messaggistica (Messenger, Instagram o WhatsApp) da cui è più probabile che rispondano. Utilizza queste inserzioni per raggiungere le persone su vasta scala e offrire un'assistenza personalizzata di alto livello.

Le inserzioni per più destinazioni sono inserzioni che possono rimandare a una qualsiasi combinazione delle destinazioni previste: chat di Messenger, chat di Instagram e chat di WhatsApp.

Se desideri creare un'inserzione che rimanda a una sola destinazione, consulta questi riferimenti:

• Inserzioni che rimandano a Messenger
• Inserzioni che rimandano a Instagram
• Inserzioni che rimandano a WhatsApp

Panoramica della creazione delle inserzioni

Questo documento illustra i passaggi da seguire per configurare l'integrazione per le inserzioni che rimandano a più destinazioni. Ecco cosa dovrai fare:

1. Creare una campagna pubblicitaria
2. Creare un gruppo di inserzioni collegato alla campagna pubblicitaria
3. Creare una creatività dell'inserzione per il tipo di inserzione che rimanda a più destinazioni che desideri mostrare
4. Creare un'inserzione attraverso il collegamento della creatività dell'inserzione al gruppo di inserzioni

Prima di iniziare

Questa guida presuppone che tu abbia:

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

Passaggio 1: creazione di una campagna pubblicitaria

Inizia creando la tua campagna pubblicitaria. Per farlo, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/campaigns in cui <AD_ACCOUNT_ID> è l'ID del tuo account pubblicitario di Meta. La richiesta deve includere:

Parametri

Richiesta

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Risposta

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'ID della campagna appena creata.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Aggiornamento

Puoi aggiornare una campagna effettuando una richiesta POST a /<AD_CAMPAIGN_ID>.

Lettura

Per verificare di aver creato correttamente una campagna che rimanda a più destinazioni, puoi effettuare una richiesta GET a /<AD_CAMPAIGN_ID>. Per una lista completa di tutti i parametri disponibili, consulta il riferimento per le campagne pubblicitarie.

Richiesta

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

Risposta

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Passaggio 2: creazione di un gruppo di inserzioni

Una volta creata la campagna pubblicitaria, puoi creare un gruppo di inserzioni. Per creare un gruppo di inserzioni, effettua 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:

Parametri

Per la lista completa dei parametri disponibili, consulta il riferimento per i gruppi di inserzioni dell'account pubblicitario.

Richiesta

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Risposta

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'ID del gruppo di inserzioni appena creato.

{
  "id": "<AD_SET_ID>"
}

Aggiornamento

Puoi aggiornare un gruppo di inserzioni effettuando una richiesta POST a /<AD_SET_ID>.

Lettura

Per verificare che il gruppo di inserzioni che rimandano a più destinazioni sia stato creato correttamente, puoi effettuare una richiesta GET a /<AD_SET_ID>. Per la lista completa dei parametri disponibili, consulta il riferimento per i gruppi di inserzioni.

Richiesta

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_SET_ID>

Risposta

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

Passaggio 3: creazione di una creatività dell'inserzione

La creatività dell'inserzione ti consente di aggiungere le risorse alle inserzioni. Per creare una creatività dell'inserzione, effettua 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:

Parametri

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

Per la lista completa dei parametri disponibili, consulta il riferimento per le creatività dell'inserzione.

Compilazione del messaggio di benvenuto della Pagina

Il messaggio predefinito che un cliente vede è "Ciao! Posso ricevere più informazioni in merito?". Puoi creare esperienze utente più adatte ai destinatari delle tue inserzioni che rimandano a più destinazioni personalizzando il messaggio di saluto delle inserzioni nel campo page_welcome_message in object_story_spec.

Esempio

Aggiunta di rompighiaccio con un messaggio di benvenuto.

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
  "media_type": "text",
  "text_format": {
    "customer_action_type": "ice_breakers",
    "message": {
      "text": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

Esempi di creazione di creatività dell'inserzione

Richiesta

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Risposta

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

{
  "id": "<AD_CREATIVE_ID>"
}

Aggiornamento

Puoi aggiornare una creatività dell'inserzione effettuando una richiesta POST a /<AD_CREATIVE_ID>.

Lettura

Per verificare di aver creato correttamente una creatività dell'inserzione che rimanda a più destinazioni, puoi effettuare una richiesta GET a /<AD_CREATIVE_ID>. Per la lista completa dei parametri disponibili, consulta Creatività dell'inserzione.

Richiesta

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>

Risposta

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

Passaggio 4: creazione di un'inserzione

Le inserzioni ti consentono di associare le informazioni sulle creatività dell'inserzione ai tuoi gruppi di inserzioni. Per creare un'inserzione, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/ads in cui <AD_ACCOUNT_ID> è l'ID del tuo account pubblicitario di Meta. La richiesta deve includere:

Parametri

Richiesta

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Risposta

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'ID dell'inserzione appena creata.

{
  "id": "<AD_ID>"
}

Aggiornamento

Puoi aggiornare un'inserzione effettuando una richiesta POST a /<AD_ID>.

Lettura

Per verificare di aver creato correttamente un'inserzione che rimanda a più destinazioni, puoi effettuare una richiesta GET a /<AD_ID>. Per la lista completa dei parametri disponibili, consulta il riferimento per le inserzioni.

Richiesta

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_ID>

Risposta

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}