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 :
Ce document décrit les étapes à suivre pour configurer votre intégration pour les publicités renvoyant à la multi-destination. Vous devez :
Ce guide considère que vous disposez des éléments suivants :
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 :
Nom | Description |
---|---|
chaîne | Obligatoire. |
énumération | Obligatoire. |
liste<Object> | Obligatoire. |
énumération | Facultatif. |
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
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>" }
Vous pouvez mettre à jour une campagne en envoyant une requête POST
à /<AD_CAMPAIGN_ID>
.
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.
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_CAMPAIGN_ID>
{ "name": "Click to Multi Destination Campaign", "status": "ACTIVE", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_CAMPAIGN_ID>" }
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 :
Nom | Description |
---|---|
int32 non signé | Obligatoire si bid_strategy est défini sur |
énumération | Facultatif. |
énumération | Obligatoire. |
chaîne numérique ou nombre entier | Obligatoire. |
int64 | Obligatoire si |
chaîne | Obligatoire.
Remarque : si vous incluez WhatsApp dans les destinations, assurez-vous d'avoir le numéro WhatsApp Business connecté à votre page. Si vous incluez Instagram dans les destinations, assurez-vous d'avoir un compte business Instagram connecté à votre page. |
datetime | Obligatoire lorsque |
int64 | Obligatoire si |
chaîne | Obligatoire. |
énumération | Obligatoire. |
| Obligatoire.
Consultez la section Ensemble de publicités, objet promu pour de plus amples détails. |
datetime | Facultatif. |
énumération | Facultatif. |
objet de ciblage | Obligatoire. |
datetime | Facultatif. |
datetime | Obligatoire lorsque |
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.
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
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>" }
Vous pouvez mettre à jour un ensemble de publicités en envoyant une requête POST
à /<AD_SET_ID>
.
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.
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>
{ "name": "<AD_SET_NAME>", "destination_type": "<DESTINATION_TYPE>", "optimization_goal": "CONVERSATIONS", "bid_strategy": "LOWEST_COST_WITHOUT_CAP'" "id": "<AD_SET_ID>" }
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 :
Nom | Description |
---|---|
| Obligatoire. Obligatoire :
Messenger { "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" } } |
chaîne | Obligatoire. |
| Obligatoire. Obligatoire :
Facultatif :
|
| Facultatif. |
Consultez la section Ensemble de publicités, Référence pour obtenir la liste complète des paramètres disponibles.
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
.
Ajout de prises de contact à un message d’accueil.
"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>" } ] } } }
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
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>" }
Vous pouvez mettre à jour un contenu publicitaire en envoyant une requête POST
à /<AD_CREATIVE_ID>
.
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.
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>
{ "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>" }
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 :
Nom | Description |
---|---|
chaîne | Obligatoire. |
chaîne numérique ou nombre entier | Obligatoire. |
| Obligatoire. |
énumération | Obligatoire. |
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
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>" }
Vous pouvez mettre à jour une publicité en envoyant une requête POST
à /<AD_ID>
.
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.
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_ID>
{ "status": "ACTIVE", "adset_id": "<AD_SET_ID>", "id": "<AD_ID>" }