API Marketing

Contenu publicitaire dynamique

Le contenu publicitaire dynamique vous permet de combiner automatiquement les contenus publicitaires associés à une publicité pour en présenter différentes versions à vos utilisateur·ices. Cela vous aide à trouver la combinaison qui génère le plus d’impressions et à affiner votre stratégie en fonction des performances des éléments sur l’ensemble des audiences.

Cette solution améliore également votre capacité à explorer une variété de combinaisons de contenus publicitaires et d’audiences, pour vous permettre de présenter les images, titres et descriptions, entre autres, les plus efficaces à vos utilisateur·ices.

Le contenu publicitaire dynamique est recommandé pour :

  • Automatiser le workflow des tests de contenus publicitaires
  • Cibler différentes audiences pour trouver la combinaison de contenus publicitaires la plus efficace

Vous pouvez utiliser cette API pour les nouvelles campagnes, les campagnes en cours et les campagnes qui durent plus de cinq jours. Nous vous conseillons de procéder à des tests par répartition avec vos campagnes existantes pour trouver la stratégie qui répond le mieux à vos besoins.

Démarrer

Étape 1 : créer une campagne et un ensemble de publicités

Vous pouvez créer une campagne publicitaire standard pour profiter du contenu publicitaire dynamique, sous réserve des deux limites suivantes :

  • Votre objective doit être l’un des suivants : OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_AWARENESS, OUTCOME_TRAFFIC ou OUTCOME_APP_PROMOTION.
  • buying_type doit être défini sur la valeur par défaut AUCTION, ou laissé vide.

Par exemple, pour créer une campagne publicitaire avec un objective défini sur CONVERSIONS :

curl \
  -F 'name=Dynamic Creative Sample Campaign'
  -F 'objective=OUTCOME_SALES'
  -F 'status=PAUSED'
  -F 'special_ad_categories=<SPECIAL_AD_CATEGORY>'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Ensuite, créez un ensemble de publicités à l’aide du point de terminaison des ensembles de publicités standards.

  • Vous pouvez utiliser tous les types de billing_event, targeting et promoted_object, à condition qu’ils soient compatibles avec l’objective de la campagne publicitaire parente.
  • Vous devez définir optimization_goal sur OFFSITE_CONVERSIONS pour les objectifs OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS et OUTCOME_TRAFFIC.
  • Puis, définissez is_dynamic_creative sur true.

Pour créer un ensemble de publicités dans une campagne avec optimization_goal défini sur conversions :

curl \
  -F 'status=PAUSED'
  -F 'name=Dynamic Creative Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=true'
  -F 'lifetime_budget=5000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2024-04-09'
  -F 'end_time=2024-04-20'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Cette requête renvoie un nouvel ID d’ensemble de publicités :

{"id":"23842500259260001"}

Si vous utilisez asset_feed_spec avec un ensemble de publicités optimisé pour APP_INSTALLS, vous devez indiquer le paramètre link_url (par exemple http://www.abc.com). Le paramètre link_url doit être identique à object_store_url dans promoted_object. Vous devez fournir un seul paramètre link_url dans asset_feed_spec.

curl 
-F "name=Dynamic Creative AdSet"
-F "campaign_id=CAMPAIGN_ID"
-F "optimization_goal=APP_INSTALLS"
-F 'is_dynamic_creative=true'
-F "billing_event=IMPRESSIONS"
-F "is_autobid=true"
-F "promoted_object={'object_store_url':'https://itunes.apple.com/us/app/facebook/id284882215','application_id':ADVERTISED_APP_ID}"  // object_store_url must match what is provided in asset feed's link_urls 
-F "lifetime_budget=20000"
-F "end_time=1461974400"
-F "targeting={
     'geo_locations':{'countries':['US']},
     'age_min':18,
     'age_max':24,
     'publisher_platforms':['facebook', 'audience_network'],
     'user_os':['ios']
   }"
-F "access_token=ACCESS_TOKEN" 
https://graph.facebook.com/<API_VERSION>/act_AD_ACCOUNT_ID/adsets

Étape 2 : fournir du contenu publicitaire avec asset_feed_spec

Fournissez votre contenu publicitaire via le champ asset_feed_spec, aussi connu sous le nom de flux d’éléments. Dans ce champ, vous pouvez spécifier plusieurs contenus publicitaires pour chaque type d’élément. Voici quelques exemples de types d’éléments : images, vidéos, titres, liens et descriptions. Plus d’informations sur les pages suivantes :

Notez que vous devrez peut-être aussi définir page_id et instagram_actor_id.

asset_feed_id n’est pris en charge que dans l’API Marketing 3.1 et versions antérieures. Utilisez asset_feed_spec à la place.

Recadrage des images

Le contenu publicitaire dynamique prend en charge le recadrage des images. Définissez le paramètre de recadrage dans la spécification de votre image. Vous ne pouvez définir qu’un seul recadrage par image. Nous appliquons vos recadrages à tous les placements de votre image. Voir API Marketing, Recadrage des images.

À ce stade, votre ensemble de publicités doit être vide. Lorsque vous créez votre publicité, fournissez une référence à l’ID de contenu publicitaire. Vous ne pouvez créer qu’une publicité par ensemble de publicités. Cependant, vous pouvez créer d’autres publicités à contenu publicitaire dynamique dans d’autres nouveaux ensembles de publicités.

curl 
  -F 'name=Dynamic Creative Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Une fois votre publicité créée :

Vous ne pouvez pas supprimer ni archiver votre publicité à contenu publicitaire dynamique après sa création. Vous devez pour cela supprimer ou archiver l’ensemble de publicités parent.

Le contenu publicitaire dynamique prend en charge tous les placements, sauf sponsored_messages sur Messenger.

Publicités carrousel

Le contenu publicitaire dynamique offre la meilleure combinaison d’éléments avec le format publicitaire carrousel. Si votre flux comprend moins de 10 images, le nombre de fiches carrousel est égal au nombre d’images. Si vous utilisez plus de 10 images, nous affichons un carrousel de 10 fiches. Nous recommandons l’utilisation d’images carrées.

Lorsque vous associez du contenu publicitaire dynamique à un carrousel, vous ne pouvez pas utiliser les fonctionnalités suivantes des publicités carrousel :

  • BODY_LABEL
  • CALL_TO_ACTION_TYPE_LABEL
  • LINK_URL_LABEL
  • CAPTION_LABEL
  • AD_FORMAT_LABEL

Dans la répartition des statistiques relatives aux éléments, nous agrégeons les indicateurs d’impressions des éléments intégrés dans toutes les fiches pour les associer aux éléments de la première fiche. Les éléments intégrés dans les fiches incluent les images, le titre et la description.

Pour plus d’informations, voir Publicités carrousel.

Étape 4 facultative : vérifier le statut d’examen

Une fois votre campagne, votre ensemble de publicités et votre publicité créés, vérifiez le statut d’examen de la publicité :

curl -G 
-d "access_token=<ACCESS_TOKEN>" 
-d 'fields=review_feedback' 
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

Le résultat inclut des commentaires d’examen. Un tableau vide signifie que votre publicité est approuvée :

{
  "review_feedback":"[]",
  "id":"<ADSET_ID>"
}

Si votre publicité est refusée à l’examen, vous recevrez une réponse similaire à celle-ci :

{
  "review_feedback": {
    {"id":23842500258220001,"text":"Body 1","reason":["ALCOHOL"]},
    {"id":23842500258160001,"text":"Title 1","reason":["ALCOHOL"]},
    {"id":23842500258170001,"text":"Title 2","reason":["ALCOHOL"]}
  }",
  "id": "<AD_ID>"  
}