API Marketing

Publicités vidéo et carrousel

Vous pouvez facilement créer, mesurer et optimiser les publicités vidéo et carrousel sur Facebook par l’intermédiaire de l’API. Consultez Facebook for Business, publicités carrousel. Pour connaître les formats vidéo pris en charge pour les publicités, consultez les Pages d’aide pour les annonceurs, vidéos.

Publicités vidéo

Documents de référence

Pour créer une publicité vidéo dans un objectif VIDEO_VIEWS et optimiser l’enchère de couverture, suivez ces étapes :

Étape 1 : Fournir des contenus publicitaires

Créez une publicité vidéo à l’aide d’un ID de vidéo existant et d’une vidéo importée sur Facebook.

Vous aurez besoin des éléments suivants :

  • Autorisations pages_read_engagement et ads_management
  • Vidéo importée dans le point de terminaison act_{ad-account-id}/advideos
curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Diaporama

Pour élargir les campagnes de marque aux téléphones avec accès au Web basiques ou lancer des campagnes sur ces appareils dans les marchés émergents, ou encore pour créer une vidéo simple, essayez les diaporamas d’images (3 images minimum). Importez des images dans une ressource vidéo. Par exemple :

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Voir Recommandations créatives pour les vidéos et Référence : Vidéos publicitaires.

Étape 2 : Créer une campagne publicitaire

Définissez l’objectif sur VIDEO_VIEWS :

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Consultez les sections Référence : campagne, AdObjectives en PHP et AdObjectives en Python

Étape 3 : Créer un ensemble de publicités

Pour avoir le coût par vue le plus bas possible, vous devez associer l’objectif de campagne de vues de vidéos à un optimization_goal=THRUPLAY de l’ensemble de publicités. Vous pouvez définir le bidding_event sur IMPRESSIONS ou THRUPLAY pour payer par impression ou par vue de vidéo. Consultez la section Enchère au CPV.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Le coût par vue est plus bas pour les ensembles de publicités avec optimization_goal=THRUPLAY par rapport au CPV de l’achat Couverture et répétition optimisé pour les vues de vidéos. Définissez une date de fin dans le futur. Consultez la section Référence : ensemble de publicités.

Étape 4 : Créer une publicité

Utilisez l’ensemble de publicités et le contenu créatif publicitaire existants :

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

Lorsque l’objectif de la campagne est VIDEO_VIEWS, la publicité obtient par défaut les bonnes spécifications de suivi qui définissent les actions suivies pour une publicité. Par exemple, pour les vues de vidéos :

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

Consultez les sections Gestionnaire de publicités : mes campagnes et Référence : publicité.

Exemple d’objectif Notoriété de la marque

Consultez le blog sur la notoriété de la marque pour créer une publicité vidéo avec cet objectif.

Exemple de Couverture et répétition

Documents de référence

Pour étendre la couverture de la vidéo à d’autres personnes, utilisez l’objectif de la campagne de vues de vidéos avec Couverture et répétition. Vous devrez créer une prévision, la réserver et l’attribuer à votre ensemble de publicités.

Suivez la procédure de création de vues de vidéos, mais appliquez l’option Couverture et répétition à votre ensemble de publicités. Précisez ces paramètres supplémentaires :

-F "rf_prediction_id=<RESERVATION_ID>" \

Vidéo à la performance

Pour inciter les personnes à passer de la sensibilisation à l’action, consultez la section Contenu publicitaire vidéo au format carrousel.

  • Toucher les personnes qui ont regardé une vidéo. De la sensibilisation à l’affinité et à la considération. Consultez la section Remarketing.
  • Interagir avec la marque et les produits. Ajoutez un call-to-action invitant à consulter une page précise de votre site web. Consultez la section Call-to-action.

Remarketing

Le remarketing à l’aide de publicités Facebook permet aux annonceurs de cibler certaines audiences personnalisées à partir des vidéos organiques ou payées sur Facebook et Instagram. Utilisez cette fonctionnalité pour faire passer les personnes de la sensibilisation à des objectifs plus avancés dans le funnel, notamment l’affinité et la considération. Consultez la section Recherche : combinaisons de contenu publicitaire qui fonctionnent.

Vous avez besoin d’une autorisation d’annonceur pour la page contenant une vidéo afin de pouvoir créer une audience pour cette vidéo.

Pour l’audience, définissez subtype=ENGAGEMENT. Rédigez les règles de l’audience que vous souhaitez créer. Chaque règle a un object_id, tel qu’un ID vidéo, et un event_name. Le event_name est un des éléments suivants :

  • video_watched : nombre de fois que votre vidéo a été regardée pendant une durée cumulée d’au moins 3 secondes ou pendant quasiment toute sa durée, selon ce qui se produit en premier.
  • video_completed : nombre de fois que votre vidéo a été regardée pendant 95 % de sa durée, y compris les vues interrompues à ce moment-là.
  • video_view_10s : nombre de fois que votre vidéo a été regardée pendant une durée cumulée d’au moins 10 secondes ou pendant quasiment toute sa durée, selon ce qui se produit en premier.
  • video_view_15s : nombre de fois que votre vidéo a été regardée pendant une durée cumulée d’au moins 15 secondes ou pendant quasiment toute sa durée, selon ce qui se produit en premier.
  • video_view_25_percent : nombre de fois que votre vidéo a été regardée pendant 25 % de sa durée, y compris les vues interrompues à ce moment-là.
  • video_view_50_percent : nombre de fois que votre vidéo a été regardée pendant 50 % de sa durée, y compris les vues interrompues à ce moment-là.
  • video_view_75_percent : nombre de fois que votre vidéo a été regardée pendant 75 % de sa durée, y compris les vues interrompues à ce moment-là.

Vous pouvez associer des vidéos afin de créer une audience à partir de diverses vidéos et actions. Par exemple, une audience peut contenir des vues de trois secondes issues de la vidéo A, puis être complétée par les vidéos B et C.

Cela crée une audience issue des 14 derniers jours composée des personnes ayant vu la vidéo 1 pendant plus de trois secondes et des personnes ayant vu la vidéo 2 en entier. L’audience se remplit également automatiquement pour les spectateurs avant la création d’audience avec prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Le remplissage est pris en charge pour les vues de vidéos à compter du 16 octobre 2015.

Call to Action

La vidéo avec call-to-action (CTA) invite les personnes à se renseigner et à consulter une page précise d’un site web. Améliorez les performances lorsque votre objectif principal est de générer des vues de vidéo ou d’augmenter la notoriété de votre marque et que votre second objectif est de stimuler les clics hors site. Vous devez utiliser une publicité vidéo pour une page web pour ce dernier. Rendu des CTA :

  • Sur mobile et ordinateur, ils apparaissent dans la publication. Lorsque la vidéo est mise en pause, ils s’affichent à côté de l’option Reprendre.
  • Sur mobile, lorsqu’une personne clique sur une vidéo afin de la regarder en plein écran, un CTA flottant se superpose à la vidéo.
  • Les publications pour une page Web avec vidéo externe ne comportent pas de CTA.

Vous pouvez utiliser la vidéo avec des CTA uniquement avec les objectifs de campagne suivants :

Consultez la section Extension de la vidéo à d’autres objectifs. Cela crée une publicité vidéo avec le call-to-action GET_DIRECTIONS :

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Indicateurs des vidéos

Insights des publications vidéo organiques

Documents de référence

Apprenez-en plus sur les performances de vos vidéos sur Facebook et prenez des décisions éclairées à propos du contenu vidéo. Actuellement, nous proposons des mesures uniquement lorsque quelqu’un commence à regarder des vidéos. Cela inclut les vues de vidéo, les vues de vidéo uniques, la durée moyenne de la vue de vidéo et la rétention de l’audience. Découvrez à quel moment les personnes se détournent de vos vidéos et des parties qu’elles pourraient trouver les plus intéressantes.

Insights des publicités vidéo, payées

Utilisez l’API Ad Insights. La réponse contient divers indicateurs vidéo.

Type de vidéo

Récupérez des statistiques de publicités vidéo regroupées par type de vidéo, notamment avec lecture automatique ou click-to-play. Incluez action_video_type dans action_breakdowns. Les valeurs attendues pour action_video_type sont total, click_to_play et auto_play.

Nous sommes actuellement en test limité pour l’option action_video_type. Pour identifier les clients avec la répartition, consultez CAN_USE_VIDEO_METRICS_BREAKDOWN pour le compte publicitaire.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

La réponse inclut des objets avec action_type comme video_view et contient une clé action_video_type :

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Consultez la section API Ad Insights.

Obtenez plus d’espace publicitaire dans le flux et attirez des personnes vers votre site Web ou votre application mobile afin qu’elles génèrent des conversions. Deux options s’offrent à vous pour créer une publicité carrousel :

Les publicités carrousel ne sont pas prises en charge pour les Stories Facebook.

Créer en contexte

Créez une publication de Page pour une publicité carrousel tout en créant un contenu créatif publicitaire. Spécifiez le contenu de la publication de Page dans la object_story_spec afin de créer une publication de Page non publiée depuis adcreatives. Consultez la section Contenus publicitaires. Par exemple :

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Cette réponse est un ID de contenu publicitaire :

{"id":"<CREATIVE_ID>"}

Créer une publication, puis une publicité

Créez une publication de Page non publiée. child_attachments est un ensemble d’objets de lien. Sur chaque objet de lien, picture, name et description sont facultatifs. Vous pouvez les publier par le biais de la Page uniquement à l’aide d’un token d’accès de Page.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Fournissez ensuite le contenu créatif publicitaire avec la publication de Page non publiée. Utilisez l’id pour l’object_story_id dans votre contenu publicitaire.

curl -X 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

Créer une publicité carrousel vidéo

Les publicités carrousel vidéo peuvent comporter une légende dans la pièce jointe enfant afin de personnaliser l’URL d’affichage sur l’écran final :

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Pour obtenir des détails sur une pièce jointe enfant, appelez le point de terminaison vidéo avec l’ID de la vidéo. Voir la API Graph, Vidéo, Référence.

Créer une publicité pour une application mobile

Limites :

  • Les publicités carrousel pour une application mobile ne prennent en charge qu’une seule application.
  • Minimum de trois images par rapport à deux sur les publicités carrousel autres que pour une application.
  • Les publicités carrousel pour une application mobile doivent contenir un call-to-action.
  • La fiche finale qui affiche généralement la photo de profil de la Page ne s’affiche pas dans les publicités carrousel pour une application mobile. Notez que vous devez spécifier le même lien App Store dans chaque child_attachment. Vous n’avez pas besoin de spécifier le lien à nouveau dans le call_to_action:{'value':{'link':... }}}.

Par exemple, pour créer une publicité carrousel pour les installations d’applications mobiles :

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Vous pouvez uniquement publier au nom de la Page Facebook associée à l’application mobile. Et vous devez utiliser un token d’accès de Page.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Utilisez l’id de la réponse pour créer le contenu publicitaire :

curl -X 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

Spécification des champs

Voici une publicité carrousel sur iOS, illustrant la façon dont les champs décrits sont utilisés.

Nom Description

child_attachments

type : objet

Une série de deux à dix objets avec lien est requise pour les publicités carrousel. Vous devez utiliser au moins trois objets pour des performances optimales ; Deux objets servent à effectuer des intégrations légères, donc l’utilisation de deux objets risque de minimiser les résultats de la campagne.

child_attachments.link

type : chaîne

Reliez l’URL ou l’URL de la boutique d’applications associée à la publication. Obligatoire.

child_attachments.picture

type : URL

Image d’aperçu associée au lien. Format d’image 1:1 et minimum de 458 x 458 pixels pour le meilleur affichage possible. Les champs picture ou image_hash doivent être spécifiés.

child_attachments.image_hash

type : chaîne

Hachage de l’image d’aperçu associée au lien de votre bibliothèque d’images ; utilisez les proportions 1:1 et un minimum de 458 × 458 pixels pour le meilleur affichage possible. Le champ picture ou image_hash doit être spécifié.

child_attachments.name

type : chaîne

Titre de l’aperçu du lien. S’il n’est pas précisé, titre de la page reliée utilisée. Généralement tronqué après 35 caractères. Vous devez définir un name unique, car les interfaces Facebook montrent les actions triées par name.

child_attachments.description

type : chaîne

Saisissez un prix, une remise ou un domaine de site web. En cas d’absence de précision, le contenu de la page reliée est extrait et utilisé. Généralement tronqué après 30 caractères.

child_attachments.call_to_action

type : objet

Call-to-action facultatif. Consultez la section Call-To-Action. Vous n’avez pas besoin de spécifier à nouveau le lien dans call_to_action:{'value':{'link':... }}}.

child_attachments.video_id

type : chaîne

ID de la vidéo publicitaire. Peut être utilisé dans n’importe quel élément secondaire. Si ce champ est spécifié, vous devez également définir image_hash ou picture.

message

type : chaîne

Texte principal de la publication, également appelé message de statut.

link

type : chaîne

URL vers un lien pour en « Voir plus ». Obligatoire.

caption

type : chaîne

URL à afficher dans le lien « Voir plus ». Ne s’applique pas aux publicités carrousel dans le cas d’une application mobile.

multi_share_optimized

type : booléen

S’il est défini sur true, les images et les liens sont sélectionnés automatiquement et classés. Sinon, utiliser l’ordre initial des éléments secondaires. Valeur par défaut : true

multi_share_end_card

type : booléen

S’il est défini sur false, la fiche de fin qui montre l’icône de la Page est supprimée. Valeur par défaut : true.

Statistiques publicitaires par produit

Actions de groupe pour les publicités carrousel selon chaque produit avec actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Chaque child_attachment a un ID de fiche différent. action_carousel_card_id et action_carousel_card_name s’appliquent uniquement aux publicités carrousel.

Obtenez les statistiques suivantes par fiche :

  • website_ctr : disponible lors de la spécification de fields=['website_ctr']
  • app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.* : disponibles lors de la spécification de fields=['actions']. Les autres actions ne sont pas disponibles avec une répartition des fiches.
curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Réponse :

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Vous pouvez également demander cost_per_action_type pour une répartition des coûts par type d’action :

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Exemple de réponse :

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}
  • Les indicateurs de répartition carrousel pour action_report_time=impression sont imprécis avant la date du 20 juin 2015.
  • Les indicateurs de répartition carrousel pour action_report_time=conversion sont imprécis avant la date du 20 juin 2015.

Placements

Si vous sélectionnez uniquement right_hand_column comme placement, vous ne pourrez utiliser qu’un format à une seule vidéo ou un format carrousel dans votre groupe publicitaire. Nous ne prenons pas en charge le format vidéo avec un seul placement right_hand_column sélectionné. Consultez la section Ciblage avancé et placement.

Par exemple, créez un ensemble de publicités avec right_hand_column comme placement unique :

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Fournissez un contenu publicitaire avec vidéo :

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Ou fournissez un format publicitaire Canvas pour le contenu publicitaire :

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Si vous tentez de créer une publicité comprenant un ensemble de publicités et un contenu publicitaire :

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Si vous recevez un code d’erreur, vous devez fournir un contenu publicitaire pris en charge ou modifier votre ciblage.

Voir aussi