API Marketing

Publicités d’appel à l’aide de l’API Marketing de Meta

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

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

Voici les étapes de la création et la publication d’une publicité :

  1. Créer d’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 la publicité d’appel
  4. Créer une publicité en liant votre contenu publicitaire à votre ensemble de publicités
  5. Publier votre publicité sur Facebook et Instagram

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 requête

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/v19.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/campaigns 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 requête

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

  • 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/v19.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/v19.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