Contenu publicitaire

Utilisez des publicités Facebook avec votre clientèle existante et pour en toucher de nouvelles. Chaque guide décrit des produits publicitaires Facebook afin de vous aider à atteindre vos objectifs publicitaires. Il existe différents types d’unités publicitaires avec divers aspects, placements et options de contenu. Pour obtenir des conseils sur les unités publicitaires en tant que contenus, consultez le guide des publicités Facebook.

Contenu publicitaire

Le contenu d’une publicité est un objet contenant toutes les données permettant d’obtenir le rendu visuel de la publicité elle-même. L’API propose différents types de publicités que vous pouvez créer sur Facebook. Vous pouvez en consulter la liste ici.

Si vous avez créé une campagne avec l’objectif Interactions avec les publications de la Page, vous pouvez maintenant créer une publicité qui fait la promotion d’une publication créée par la Page. C’est ce que nous appelons une publicité Publication de Page. Les publicités Publication de Page nécessitent un champ appelé object_story_id, qui correspond à la propriété id d’une publication de Page. Pour en savoir plus sur le contenu publicitaire, consultez cette page.

Un contenu publicitaire est constitué de trois parties :

le contenu publicitaire en lui-même, défini par les attributs visuels de l’objet créatif ;
le placement sur lequel la publicité est diffusée ;
l’aperçu de l’unité elle-même, selon le placement.

Pour créer l’objet du contenu publicitaire, effectuez l’appel suivant :

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

La réponse à l’appel d’API sera l’élément id de l’objet créatif. Enregistrez cette information, vous en aurez besoin pour l’objet publicitaire :


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
  
Open In Graph API Explorer

Limites

Il existe des limites concernant le texte, la taille de l’image, le format de l’image et d’autres aspects du contenu. Consultez le guide des publicités.

Consultation

Dans l’API Ads, vous devez effectuer une demande explicite pour chaque champ que vous souhaitez récupérer, à l’exception d’id. La référence de chaque objet comporte une section permettant d’accéder à l’objet ultérieurement et d’afficher la liste des champs lisibles. Pour le contenu, il s’agit des mêmes champs que ceux ayant été indiqués lors de la création de l’objet, ainsi que du champ id.


curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>Open In Graph API Explorer

Placements

Un placement est un endroit où votre publicité apparaît sur Facebook, comme le flux sur ordinateur, le flux sur mobile ou la colonne de droite. Consultez le Guide des produits publicitaires.

Nous vous encourageons à diffuser des publicités sur toute la gamme des placements disponibles. Le système d’enchères de Facebook est conçu pour fournir des impressions publicitaires au placement le plus susceptible de générer des résultats de campagne au coût le plus bas possible.

La façon la plus simple de profiter de cette optimisation est de laisser ce champ vide. Vous pouvez également sélectionner des placements spécifiques dans le champ target_spec d’un ensemble de publicités.

Cet exemple comprend une publicité pour une publication de Page. Les placements disponibles sont le flux sur mobile, le flux sur ordinateur et la colonne de droite de Facebook. Dans l’API, consultez Options de placement. Si vous choisissez desktopfeed et rightcolumn en tant que type de page (page_type), la publicité est diffusée dans le flux sur ordinateur et dans la colonne de droite. Les publicités créées dans cet ensemble de publicités sont uniquement diffusées sur ordinateur.

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

Affichage de l’aperçu d’une publicité

Deux options s’offrent à vous pour afficher un aperçu d’une publicité : à l’aide de l’API Ad preview ou du plugin d’aperçu des publicités.

Il existe trois façons de générer un aperçu à l’aide de l’API :

Par ID publicité
Par identifiant de contenu publicitaire
En indiquant les spécifications d’un contenu

Selon les documents de référence sur l’API Preview, l’appel d’API minimal requis est :


curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

Les spécifications de contenu sont constituées de l’ensemble des champs et valeurs requis pour la création du contenu publicitaire.

Actuellement, notre appel pour un contenu publicitaire se présente comme suit :


curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Prenez object_story_id et utilisez-le dans l’appel à l’API Preview :


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

Les valeurs disponibles pour ad_format varient légèrement de celles disponibles pour page_types. Toutefois, dans ce scénario, le flux sur ordinateur et la colonne de droite de Facebook sont sélectionnés. Vous devez alors effectuer deux appels d’API pour générer les aperçus pour chaque placement :



curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

La réponse contient une iFrame valable pendant 24 heures.

Contenu publicitaire