API Marketing

Publicités d’appel

Ce guide explique comment créer et publier des publicités d’appel avec l’API Marketing de Meta.

Avant de commencer

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

Pour réussir les appels aux points de terminaison mentionnés dans ce guide, vous aurez besoin des éléments suivants :

  • Un token d’accès de Page demandé par un·e utilisateur·ice autorisé·e à effectuer la tâche ADVERTIZE sur la Page
  • Autorisations suivantes accordées à une personne utilisant votre application :
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Recommandations

Assurez-vous de définir les heures d’ouverture de votre entreprise dans les paramètres de votre Page Facebook.

Lorsque vous testez un appel d’API, vous pouvez inclure le paramètre access_token, défini sur votre token d’accès. En revanche, lorsque vous effectuez des appels sécurisés depuis votre application, utilisez la classe de token d’accès.

Limites

  • L’audience cible doit avoir au moins 18 ans.
  • Le numéro de téléphone inclus dans le call-to-action doit se situer dans le même pays que l’audience cible.

Étape 1 : créer une campagne

Pour créer votre campagne publicitaire, 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 :

  • name
  • objective : défini sur l’un des objectifs pris en charge suivants :
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Exemple de demande

Formaté pour plus de lisibilité. Remplacez les valeurs en gras et en italique, comme ad_account_id, par vos propres valeurs.
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"],
         }'

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

{
  "id": "campaign_id"
}

Étape 2 : créer un 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 :

  • bid_amount
  • billing_event défini sur IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type défini sur PHONE_CALL
  • name
  • optimization_goal défini sur QUALITY_CALL pour les publicités d’appel
  • targeting

Exemple de demande

Formaté pour plus de lisibilité. Remplacez les valeurs en gras et en italique, comme ad_account_id, par vos propres valeurs.
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"] 
           } 
         }'

Si la requête aboutit, votre application reçoit la réponse JSON suivante avec l’ID de l’ensemble de publicités.

{
  "id": "adset_id"
}

Étape 3 : créer un contenu publicitaire

Le contenu publicitaire vous permet d’ajouter des éléments à vos publicités. Les publicités carrousel, image, texte et vidéo sont prises en charge.

Pour créer un ensemble de publicités, 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 :

  • name
  • object_story_spec
  • object_story_spec avec un objet link_data qui définit le call_to_action avec type défini sur CALL_NOW et value comme numéro de téléphone de votre entreprise

Exemple de requête pour une publicité avec image

Formaté pour plus de lisibilité. Remplacez les valeurs en gras et en italique, comme page_access_token, par vos propres valeurs.
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" }
               }   
             }
           }
         }'

Si la requête aboutit, votre application reçoit la réponse JSON suivante avec l’ID du contenu publicitaire.

{
  "id": "ad_creative_id"
}

Étape 4 : créer la publicité

Pour créer la publicité, vous devez associer le contenu publicitaire et l’ensemble de publicités. Pour créer la 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 :

Exemple de requête pour une publicité avec du contenu

Formaté pour plus de lisibilité. Remplacez les valeurs en gras et en italique, comme ad_account_id, par vos propres valeurs.
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"
         }'

Si la requête aboutit, votre application reçoit la réponse JSON suivante avec l’ID de la publicité.

{
  "id": "ad_id"
}

Étapes suivantes

Consultez le Guide de démarrage pour savoir comment envoyer votre publicité pour examen.

En savoir plus

En savoir plus sur l’API Marketing et les options supplémentaires associées aux publicités d’appel.

Pages d’aide Business

API Marketing