API Marketing

Règles de personnalisation des éléments

Utilisez cette solution pour définir les éléments de contenu publicitaire que vous souhaitez afficher dans vos publicités. Lors de la création de publicités, vous pouvez choisir la combinaison d’éléments que vous voulez afficher en fonction de vos règles de personnalisation des éléments. Les éléments de contenu publicitaire peuvent par exemple être des images, des vidéos, du texte et le corps d’une publicité.

Nous proposons trois API qui utilisent des règles de personnalisation des éléments :

Toutes les publicités utilisant asset_feed_spec doivent contenir au moins deux règles de personnalisation de cible. Si votre contenu publicitaire utilise asset_feed_spec et comporte moins de deux règles, vous ne pourrez pas créer cette publicité.

Premiers pas

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

Vous pouvez créer une campagne publicitaire standard pour des règles de personnalisation des éléments, mais des limitations s’appliquent :

API Objectifs de campagne pris en charge

Personnalisation des éléments de segment

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Personnalisation des éléments de placement

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LEAD_GENERATION, LINK_CLICKS, REACH, VIDEO_VIEWS.

Publicités multilingues

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Pour l’ensemble de publicités, utilisez le point de terminaison de l’ensemble de publicités standard et définissez is_dynamic_creative sur false.

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

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -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=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

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.

asset_feed_spec fournit du contenu publicitaire pour le contenu publicitaire dynamique, la personnalisation des éléments en fonction du placement, les publicités multilingues et la personnalisation des éléments de segment. Le format de la spécification est différent pour chaque solution.

Étape 2 : fournir le contenu publicitaire

Fournissez votre contenu publicitaire par le biais du paramètre asset_feed_spec. Un flux d’éléments est une collection de plusieurs éléments de contenu publicitaire, comme des images, des titres, des textes, etc. Vous pouvez spécifier plusieurs éléments de contenu publicitaire pour chaque type d’élément.

Créez une asset_feed_spec dans /adcreative. Pour appliquer des options de personnalisation, définissez des asset_customization_rules dans votre asset_feed_spec.

Une fois la configuration terminée, vérifiez votre asset_feed_spec :

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

Lorsque vous créez votre publicité, fournissez une référence à l’ID de contenu publicitaire. Vous pouvez créer plusieurs publicités par ensemble de publicités.

curl 
  -F 'name=Asset Custom Rule 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

Après la création :