API Marketing

Publicités intégrées dans les reels

Créez une publicité Meta en mettant l’accent sur les placements disponibles dans les reels et obtenez des recommandations concernant nos opérations publicitaires.

Conditions requises

  • Vous avez déjà créé une application Facebook.
  • Vous connaissez les API marketing et avez activé Facebook Login.

Si vous ne remplissez pas ces conditions, veuillez vous référer à notre documentation pour les équipes de développement.

Tests dans un environnement sandbox

Meta offre un environnement de test qui ne permet pas vraiment de diffuser des publicités mais avec lequel vous pourrez :

  • Ajouter l’API Marketing comme produit dans la section Outils de votre application Meta afin de créer et de modifier sans frais des publicités utilisant nos API
  • Créer un compte publicitaire pour utiliser l’API Marketing

Lisez nos recommandations en matière de tests.

Étape 1 : accéder à l’élément

Un token d’accès est une chaîne opaque qui identifie un utilisateur ou une utilisatrice, une application ou une Page, et que l’application peut utiliser pour passer des appels à l’API Graph. Vous pouvez voir quand il expire et quelle application l’a généré. Les appels d’API Marketing dans les applications Meta doivent inclure un token d’accès.

Obtenez un token d’accès avec les autorisations nécessaires :

  • ads_management : pour apporter des changements dans certains comptes publicitaires

  • ads_read : pour lire les données des publicités

  • read_insights : pour lire les statistiques de performance

Utilisez les tokens d’accès système, car ils ont des délais d’expiration plus longs.

Couche d’autorisation supplémentaire

Pour accéder aux points de terminaison de l’API Marketing, vous devez créer une application Business. Les applications Business sont soumises à une couche supplémentaire d’autorisation de l’API Graph appelée Niveaux d’accès. Durant le Contrôle app, vous devez également demander des autorisations et fonctionnalités spécifiques pour votre application. Vous devez demander une vérification de l’entreprise si votre application est utilisée par des utilisateur·ices qui ne disposent pas d’un rôle dans cette même application, ou d’un rôle dans une entreprise qui la revendique.

Si votre application gère les comptes publicitaires d’autres personnes, vous avez besoin d’un :

  • Accès avancé ads_read

et/ou

  • Accès avancé ads_management

Étape 2 : récupérer un compte publicitaire

Récupérez le ou les comptes publicitaires de vos annonceurs et autorisez-les à sélectionner celui pour la création de publicités.

Grâce à notre API Business Management, vous pouvez voir tous les comptes publicitaires auxquels leur entreprise a accès. Cet appel renvoie tous les comptes publicitaires appartenant à une entreprise. Notez que vous aurez besoin de l’autorisation business_management au niveau application et utilisateur. Consultez les API de gestion des éléments professionnels.

Exemple d’appel

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0/<BUSINESS_ID>/owned_ad_accounts"

Étape 3 : créer une campagne

Une campagne est le niveau d’organisation le plus élevé d’un compte publicitaire et doit avoir un objectif unique pour un annonceur. Ces objets contiennent votre objectif publicitaire ainsi qu’un ou plusieurs ensembles de publicités. Ils vous aident à optimiser et à mesurer les résultats de chaque objectif publicitaire. Cliquez ici pour en savoir plus sur la création, la lecture, la mise à jour et la suppression d’une campagne.

Exemple d’appel

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Étape 4 : définir l’objectif

Pour permettre aux annonceurs de cibler des groupes spécifiques, indiquez ces paramètres dans vos requêtes API :

  • Données démographiques (âge, genre et lieu)
  • interests
  • behaviors

La clientèle potentielle la plus susceptibles de s’intéresser à vos produits ou services sera alors contactée.

Exemple d’appel

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'description=People who live in New York, aged 25-40, interested in technology' \
  -F 'customer_file_source=USER_PROVIDED_ONLY' \
  -F 'targeting_spec={
        "geo_locations": {
          "countries": ["US"],
          "regions": [{"key": "4081"}]  # New York region key
        },
        "age_min": 25,
        "age_max": 40,
        "interests": [{"id": "6003139266461", "name": "Technology"}]
      }' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/customaudiences

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

Les ensembles de publicités peuvent contenir une ou plusieurs publicités. Les publicités contenues dans un ensemble de publicités devraient avoir un ciblage, un budget, une facturation, un objectif d’optimisation et une durée identiques.

Vous pouvez définir le budget, le calendrier, le ciblage, la stratégie d’enchère et les options de placement. Les ensembles de publicités permettent d’affiner comment et où les publicités sont diffusées auprès de segments d’audience spécifiques, d’optimiser les performances et d’atteindre les objectifs marketing.

Paramètres clés :

  • Critère de ciblage d’audience
  • Budgets quotidiens ou globaux
  • Options de planification pour contrôler le moment où les publicités sont diffusées

Cliquez ici pour obtenir des informations complémentaires.

Vous pouvez choisir un placement manuel des publicités qui intègrent les reels Instagram et Facebook, ou les placements automatiques par défaut. Si vous laissez un champ de placement vide, le système envisagera toutes les positions par défaut possibles pour ce champ.

Exemple d’appel

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=Reels Ad Set' \
  -F 'campaign_id=YOUR_CAMPAIGN_ID' \
  -F 'daily_budget=5000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=REACH' \
  -F 'start_time=2024-07-10T10:00:00-0700' \
  -F 'end_time=2024-07-20T10:00:00-0700' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
  -F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
  -F 'status=PAUSED' \
  -F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
  -F 'publisher_platforms=["instagram"]' \
  -F 'instagram_positions=["reels"]' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/adsets

Ciblage de placement : positions disponibles pour les reels, objectifs compatibles et objectifs d’optimisation

publisher_platformsfacebook_position ou instagram positionObjectifs compatiblesoptimization_goal
instagram

reels, profile_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

instagram

reels, profile_reels

 OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

instagram

reels, profile_reels

 OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

instagram

reels, profile_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

VISIT_INSTAGRAM_PROFILE

instagram

reels, profile_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

POST_ENGAGEMENT

REACH

IMPRESSIONS

REMINDERS_SET

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

instagram

reels, profile_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

facebookfacebook_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

facebookfacebook_reels

OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

facebookfacebook_reels

OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

facebookfacebook_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

QUALITY_CALL

facebookfacebook_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

POST_ENGAGEMENT

REACH

IMPRESSIONS

EVENT_RESPONSES

QUALITY_CALL

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

PAGE_LIKES

facebookfacebook_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

QUALITY_CALL

Limites

Combinaison entre l’objectif compatible + optimization_goal Reels FB compatibles ? Reels Instagram compatibles ?

OUTCOME_AWARENESS + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_TRAFFIC + VISIT_INSTAGRAM_PROFILE

❌

✅

OUTCOME_TRAFFIC + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_ENGAGEMENT + EVENT_RESPONSES

✅

❌

OUTCOME_ENGAGEMENT + REMINDERS_SET

❌

✅

OUTCOME_ENGAGEMENT + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + PAGE_LIKES

✅

❌

OUTCOME_SALES + QUALITY_CALL

✅

❌

Étape 6 : sélectionner le contenu publicitaire

Les contenus publicitaires sont les composantes visuelles et textuelles des publicités. Ils sont aux formats suivants :

  • images
  • vidéos
  • Carrousels
  • Designs publicitaires personnalisés (si activés)

Automatisez les éléments de design et optimisez les performances en utilisant notre processus de création de contenu publicitaire.

Réutiliser un reel existant en tant que contenu publicitaire

Les utilisateur·ices peuvent fournir un nouvel élément ou réutiliser un reel existant de leur compte Instagram comme contenu publicitaire.

Vous pouvez créer des publicités à partir de reels Instagram ou Facebook (existants et organiques) dès lors qu’ils peuvent être utilisés à cette fin, à condition que :

  • Ils durent moins de 90 secondes
  • Ils soient accessibles en plein écran (9:16) au format vertical
  • Ils soient libres de droit pour tout ce qui concerne la musique, les GIF, les stickers interactifs ou les filtres d’appareil photo appartenant à un tiers
  • Ils ne soient pas partagés sur Facebook

Pour réutiliser un reel Instagram organique comme contenu publicitaire pour une nouvelle campagne publicitaire :

  1. Demandez l’ID de compte Instagram Business qui doit être connecté à une page Facebook.

    • GET/{ad_account_id}/connected_instagram_accounts ou
    • GET/{business_id}/instagram_business_accounts

  2. Trouvez le reel à promouvoir.

    • GET/{ig-business-account-user-id}/media

  3. Fournissez le contenu publicitaire.

    • Définissez instagram_user_id en tant qu’identifiant utilisateur·ice Instagram plutôt que d’indiquer instagram_actor_id dans les spécifications du contenu publicitaire.
    • Indiquez source_instagram_media_id comme identifiant de contenu multimédia.
    • Éventuellement, mettez à jour call_to_action pour votre promotion.

Utilisez boost_eligibility_info comme moyen pratique de déterminer si les contenus multimédias peuvent être boostés en tant que publicité, et boost_ads_list pour retracer les informations d’anciennes publicités Instagram boostées liées à la publicité.

Exemple d’appel

curl -i -X POST \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>

Boîte à outils pour contenus publicitaires axée sur l’IA générative

Vous pouvez automatiser la création d’éléments publicitaires comme des images, des vidéos et du texte. Ces outils pilotés par IA aident à optimiser les performances des publicités en adaptant les contenus aux préférences de l’audience et en améliorant leur variété. Les publicités ainsi créées généreront de meilleures interactions et conduiront à de meilleures campagnes.

Étape 7 : générer un aperçu de la publicité

Générez un aperçu de la publicité au format Facebook et Instagram Reels comme présenté ci-dessous dans le tableau, en utilisant :

  • ID publicité
  • ID du contenu publicitaire
  • Spécifications du contenu publicitaire
PLATEFORME DE PUBLICATION Format publicitaire

Facebook

DESKTOP_FEED_STANDARD, FACEBOOK_STORY_MOBILE, INSTANT_ARTICLE_STANDARD, INSTREAM_VIDEO_DESKTOP, INSTREAM_VIDEO_MOBILE, MARKETPLACE_DESKTOP, MARKETPLACE_MOBILE, MOBILE_FEED_BASIC, MOBILE_FEED_STANDARD, RIGHT_COLUMN_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE, FACEBOOK_REELS_BANNER, FACEBOOK_REELS_BANNER_DESKTOP, FACEBOOK_REELS_MOBILE, FACEBOOK_REELS_POSTLOOP, FACEBOOK_REELS_STICKER, FACEBOOK_STORY_STICKER_MOBILE, WATCH_FEED_HOME

Instagram

INSTAGRAM_STANDARD, INSTAGRAM_STORY, INSTAGRAM_EXPLORE_CONTEXTUAL, INSTAGRAM_EXPLORE_IMMERSIVE, INSTAGRAM_EXPLORE_GRID_HOME, INSTAGRAM_FEED_WEB, INSTAGRAM_FEED_WEB_M_SITE, INSTAGRAM_PROFILE_FEED, INSTAGRAM_REELS, INSTAGRAM_REELS_OVERLAY, INSTAGRAM_SEARCH_CHAIN, INSTAGRAM_SEARCH_GRID, INSTAGRAM_STORY_CAMERA_TRAY, INSTAGRAM_STORY_WEB, INSTAGRAM_STORY_WEB_M_SITE

Exemple d’appel

curl -X POST \
  'https://graph.facebook.com/v21.0/act_{ad_account_id}/adpreviews' \
  -F 'access_token={your_access_token}' \
  -F 'creative={
        "object_story_spec": {
            "instagram_actor_id": "{instagram_actor_id}",
            "video_data": {
                "video_id": "{video_id}",
                "title": "Check out our new product!",
                "description": "Exciting new features and benefits.",
                "call_to_action": {
                    "type": "LEARN_MORE",
                    "value": {
                        "link": "https://www.example.com/product"
                    }
                }
            }
        }
    }' \
  -F 'ad_format=INSTAGRAM_REELS'

Étape 8 : programmer la diffusion des publicités

Pour réserver une publicité en utilisant l’API Marketing, créez un objet de groupe publicitaire et associez votre objet d’ensemble de publicités au contenu publicitaire. Utilisez /act_{ad_account_id}/ads pour envoyer votre objet publicitaire, puis validez la réponse pour confirmer la réussite de la réservation. Cette étape finalise la configuration de votre publicité qui est alors prête à être diffusée en fonction des configurations fournies.

Exemple d’appel

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Étape 9 : examiner les performances

Utilisez l’API Insights pour récupérer les indicateurs du compte publicitaire correspondant aux publicités diffusées :

  • act_<AD_ACCOUNT_ID>/insights
  • <CAMPAIGN_ID>/insights
  • <ADSET_ID>/insights
  • <AD_ID>/insights

Si vous diffusez une campagne sur Instagram et Facebook, ajoutez breakdowns=publisher_platform pour afficher séparément les statistiques des placements Facebook et Instagram, comme indiqué dans l’exemple d’appel ci-dessous : Lorsque vous répartirez les insights par niveau de placement, il sera possible de visualiser les performances des publicités en fonction du placement des reels Instagram et Facebook.

Exemple d’appel

curl -X GET \
  'https://graph.facebook.com/v21.0/{ad_account_id}/insights' \
  -F 'access_token={your_access_token}' \
  -F 'level=campaign' \
  -F 'fields=campaign_name,impressions,clicks,spend' \
  -F 'breakdowns=publisher_platform,platform_position' \
  -F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
  -F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'

Éléments importants à prendre en compte

Nouveaux objectifs pris en charge dans ODAX (validation des objectifs des expériences publicitaires orientées résultats)

  • OUTCOME_APP_PROMOTION
  • OUTCOME_AWARENESS
  • OUTCOME_ENGAGEMENT
  • OUTCOME_LEADS
  • OUTCOME_SALES
  • OUTCOME_TRAFFIC

Plafonds

L’API Marketing dispose de sa propre logique de plafond et elle est exclue de toutes les limites de débit de l’API Graph. La fonctionnalité qui a un impact sur le plafond de l’API Marketing est l’accès standard à la gestion des publicités. Par défaut, vous obtenez un accès standard (Standard Access) lorsque vous ajoutez le produit de l’API Marketing à votre Espace App, ce qui vous donne un accès en mode développement à l’API Marketing. Pour augmenter le plafond, passez à un accès avancé (Advanced Access).

Notions de base sur les contenus publicitaires

Les publicités intégrées dans les reels transforment l’attention portée en action et boostent vos résultats. Quand vous les concevez comme il se doit, elles sont d’autant plus efficaces.

1. Filmez en 9:16 pour rendre votre vidéo captivante : les reels sont un format vidéo immersif plein écran. Pour que votre contenu publicitaire s’exprime pleinement, commencez par choisir une vidéo et redimensionnez-la au format 9:16.

2. Veillez à ce que rien ne gêne vos messages pour garantir leur clarté : faites en sorte que les stickers de texte en superposition, les appels à l’action ou les messages clés ne soient pas masqués par l’interface d’utilisation des reels. Aucun texte, logo ou autre élément clé ne doit figurer dans la partie inférieure de votre contenu publicitaire au format 9:16. Prévoyez de laisser libre une partie représentant 35 % au bas de celui-ci.

3. Ajoutez du son pour rendre votre vidéo divertissante : le son, qu’il s’agisse de musique, de voix off ou d’effets sonores, est un élément clé des interactions et du divertissement dans les reels.

Contenus multimédias dynamiques avec vidéo de produit du catalogue

Utilisez la vidéo de produit du catalogue pour le placement de vos Reels afin d’améliorer l’expérience catalogue et publicitaire. Avec les contenus multimédias dynamiques, vous pouvez diffuser des éléments vidéo de votre catalogue parallèlement aux images de produit existantes lors de vos campagnes publicitaires de catalogue Advantage+. Ces contenus multimédias vous permettent d’étendre la couverture de vos Reels Instagram et Facebook. Ils permettent également de regrouper plusieurs campagnes vidéo en une seule campagne publicitaire dynamique. Vous pouvez utiliser ce type de publicités pour différents placements, bien qu’ici, nous nous concentrions sur leur utilisation dans les placements Reels.

Le contenu multimédia dynamique affiche des images ou des vidéos des articles de votre catalogue en fonction des articles susceptibles d’intéresser la personne qui voit votre publicité. Il utilise l’automatisation et le classement des produits pour diffuser les produits les plus pertinents, mais aussi les éléments les plus performants, auprès des audiences sur tous les placements.

Pourquoi utiliser la vidéo de produit du catalogue ?

La vidéo de produit du catalogue est prise en charge pour tous les secteurs, et les publicités de contenus multimédias dynamiques sont ouvertes à tous les annonceurs. Elle est adaptée aux annonceurs qui souhaitent donner un coup de pouce à leurs campagnes de publicités de catalogue Advantage+ grâce à des contenus vidéo plus inspirants.

Conditions requises

Pour créer des publicités de contenus multimédias dynamiques sur Reels, vous aurez besoin d’un catalogue des produits existants et d’au moins une vidéo pour chaque article dans un format URL vidéo téléchargeable. Pour plus d’informations, voir Contenu multimédia dynamique.

Étape 1 : Configurer les vidéos de produit pour le catalogue

  • Veillez à ce qu’au moins une vidéo par produit présente des proportions 9:16 pour des performances optimales sur Reels
    • Les publicités de contenu multimédia sélectionnent automatiquement une vidéo 9:16 pour les placements Reels
    • Si aucune vidéo 9:16 n’est disponible, la première vidéo est utilisée
  • Assurez-vous que les vidéos fournies pour votre catalogue sont hébergées sur des URL téléchargeables
  • Bien que non obligatoire, l’audio est le bienvenu et peut avoir un impact positif sur votre publicité
  • Vous pouvez ajouter des tags à vos vidéos de catalogue pour utiliser preferred_video_tags sur la publicité

Étape 2 : Créer une campagne publicitaire compatible avec les placements Reels et les publicités de catalogue Advantage+

Étape 3 : Créer un ensemble de publicités ciblant les placements Reels avec un ensemble de produits

Étape 4 : Créer une publicité de contenu multimédia

  • Assurez-vous de créer une publicité carrousel ou une publicité au format vidéo unique. Les publicités de collection comportant des vidéos de produit du catalogue ne sont pas encore prises en charge sur les placements Reels. Les publicités carrousel contiennent une série de produits différents issus d’un ensemble. Une seule vidéo montre un produit à la fois de l’ensemble de produits spécifié
  • En savoir plus sur les vidéos de produit du catalogue