Publicités qui renvoient à la multi-destination

Ce guide explique comment créer et publier des publicités qui renvoient à la multi-destination à l’aide de l’API Marketing.

Les publicités qui renvoient à la multi-destination redirigent les personnes qui cliquent sur vos publicités directement vers des conversations avec votre entreprise dans l’application ou les applications de messagerie (Messenger, Instagram ou WhatsApp) depuis lesquelles elles sont les plus susceptibles de répondre. Utilisez ces publicités pour toucher les internautes à grande échelle et leur offrir un service personnalisé de qualité.

Les publicités multi-destination signifient que la publicité peut être diffusée vers n’importe quelle combinaison de destinations : discussion Messenger, Instagram, WhatsApp.

Si vous souhaitez créer une publicité pour une seule destination, reportez-vous aux sections suivantes :

• Publicités qui renvoient à Messenger
• Publicités qui renvoient à Instagram
• Publicités qui renvoient à WhatsApp

Présentation de la création de publicités

Ce document décrit les étapes à suivre pour configurer votre intégration pour les publicités renvoyant à la multi-destination. Vous devez :

1. Créer une campagne publicitaire
2. Créer un ensemble de publicités qui associe vos publicités à votre campagne publicitaire
3. Créer un contenu publicitaire pour le type de publicité multi-destination que vous souhaitez diffuser
4. Créer une publicité en liant votre contenu publicitaire à votre ensemble de publicités

Avant de commencer

Ce guide considère que vous disposez des éléments suivants :

• Un compte publicitaire avec Meta
• Tous les éléments (images, vidéos, etc.) qui seront utilisés dans vos publicités sur les serveurs Meta, déjà importés

Étape 1 : créer une campagne publicitaire

Commencez par créer votre campagne publicitaire. Pour ce faire, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/campaigns où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Requête

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/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID de la campagne que vous venez de créer.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Mise à jour

Vous pouvez mettre à jour une campagne en envoyant une requête POST à /<AD_CAMPAIGN_ID>.

Lecture

Pour vérifier que vous avez bien créé une campagne de renvoi à la multi-destination, vous pouvez envoyer une requête GET à /<AD_CAMPAIGN_ID>. Consultez la section Campagne publicitaire, Référence pour obtenir la liste complète des paramètres disponibles.

Requête

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

Réponse

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

Étape 2 : créer un ensemble de publicités

Une fois que vous disposez d’une campagne publicitaire, créez votre ensemble de publicités. Pour créer un ensemble de publicités, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/adsets où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Consultez la section Référence sur le compte publicitaire d’un ensemble de publicités pour obtenir la liste complète des paramètres disponibles.

Requête

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/v21.0/act_<AD_ACCOUNT_ID>/adsets

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID de l’ensemble de publicités que vous venez de créer.

{
  "id": "<AD_SET_ID>"
}

Mise à jour

Vous pouvez mettre à jour un ensemble de publicités en envoyant une requête POST à /<AD_SET_ID>.

Lecture

Pour vérifier que vous avez bien créé un ensemble de publicités de renvoi à la multi-destination, vous pouvez envoyer une requête GET à /<AD_SET_ID>. Consultez la section Ensemble de publicités, Référence pour obtenir la liste complète des paramètres disponibles.

Requête

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

Réponse

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

Étape 3 : créer un contenu publicitaire

Le contenu publicitaire vous permet d’ajouter des éléments à vos publicités. Pour créer un contenu publicitaire, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/adcreatives où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

{
  "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"
    }
}

Consultez la section Ensemble de publicités, Référence pour obtenir la liste complète des paramètres disponibles.

Rédaction du message de bienvenue de la Page

Par défaut, le message visible par les internautes sera « Bonjour ! Puis-je en savoir plus à ce sujet ? ». Vous pouvez créer des expériences d’utilisation plus adaptées pour vos publicités qui renvoient à la multi-destination en personnalisant le message d’accueil, les prises de contact et les messages de saisie automatique de vos publicités dans le champ page_welcome_message sous object_story_spec.

Pour plus d’informations sur les prises de contact, voir la référence de ice_breakers.

Limites

• Le titre d’une prise de contact ne doit pas dépasser 80 caractères.
• Les réponses à une prise de contact ne doivent pas dépasser 300 caractères.
• Le texte du message ne doit pas dépasser 300 caractères.

Exemple

Créez l’objet page_welcome_message pour ajouter des prises de contact à un message de bienvenue.

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

Exemples de création de contenu publicitaire

Ajoutez le champ page_welcome_message au contenu publicitaire comme suit.

Requête

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/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID du contenu publicitaire que vous venez de créer.

{
  "id": "<AD_CREATIVE_ID>"
}

Création de contenus publicitaires à l’aide de contenus Instagram

Publications Instagram

Consultez la section Utiliser des publications comme publicités Instagram pour plus d’informations.

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Images Instagram

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Création de contenus publicitaires à l’aide de contenus Facebook

Consultez la section Utiliser des publications comme publicités Instagram : Publications Facebook pour plus d’informations.

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

object_story_id est l’ID de la publication au format postOwnerID_postID et instagram_actor_id est l’ID du compte Instagram connecté à une Page ou du compte Instagram associé à une Page. Pour plus d’informations, voir Configurer les comptes Instagram.

Mise à jour

Vous pouvez mettre à jour un contenu publicitaire en envoyant une requête POST à /<AD_CREATIVE_ID>.

Lecture

Pour vérifier que vous avez bien créé un contenu publicitaire de renvoi à la multi-destination, vous pouvez envoyer une requête GET à /<AD_CREATIVE_ID>. Consultez la section Contenu publicitaire pour obtenir la liste complète des paramètres disponibles.

Requête

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

Réponse

{
  "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>"
}

Étape 4 : créer une publicité

Les publicités vous permettent d’associer des informations de contenus publicitaires à vos ensembles de publicités. Pour créer une publicité, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/ads où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Requête

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/v21.0/act_<AD_ACCOUNT_ID>/ads

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID de la publicité que vous venez de créer.

{
  "id": "<AD_ID>"
}

Call-to-action

Vous pouvez aussi définir un call-to-action lors de la création de votre publicité.

"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": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

Pour plus d’informations, consultez la documentation sur la spécification des flux d’éléments.

Mise à jour

Vous pouvez mettre à jour une publicité en envoyant une requête POST à /<AD_ID>.

Lecture

Pour vérifier que vous avez bien créé une publicité de renvoi à la multi-destination, vous pouvez envoyer une requête GET à /<AD_ID>. Consultez la section Référence sur les publicités pour obtenir la liste complète des paramètres disponibles.

Requête

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

Réponse

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