Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.

Anglais mis à jour : 20 juil. 2021

Spécifications de suivi et de conversion

Les spécifications de suivi vous permettent de consigner les actions effectuées par les utilisateurs sur votre publicité. Elles n’optimisent pas la diffusion des publicités pour une action et ne vous facturent pas en fonction de cette action.

Dans l’API Marketing 2.3 et versions antérieures, les spécifications de conversion sont des paramètres de publicité associés au CPM optimisé. Elles optimisent la diffusion des publicités en fonction d’actions spécifiques et consignent ces actions dans des rapports de conversion. Depuis la version 2.4, conversion_specs est en lecture seule. Utilisez l’optimization_goal sur l’ensemble de publicités pour sélectionner l’optimisation de la diffusion.

Définir les spécifications de suivi

Vous pouvez utiliser les spécifications de suivi avec n’importe quel type d’enchère et de contenu. Pour définir des spécifications de suivi, vous avez besoin d’un champ supplémentaire dans une publicité, intitulé tracking_specs. Le champ tracking_specs accepte les mêmes arguments que pour les spécifications d’action. Pour créer une publicité, consultez la page Création de publicités.

Spécifications de suivi par défaut

Pour les objectifs publicitaires suivants, les spécifications de suivi par défaut s’appliquent. Si vous passez à la spécification par défaut, elle sera ajoutée à la spécification existante au lieu de la remplacer.

Si votre objectif est NONE ou App Install/Engagement Ads, les spécifications de suivi par défaut seront remplacées. Pour utiliser les spécifications par défaut, vous devez les ajouter à vos spécifications personnalisées.

Vous pouvez utiliser les notations de chaîne ou de tableau dans la spécification, telles que 'APPLICATION_ID' ou ['APPLICATION_ID'].

Le CPM fait référence à billing_event=IMPRESSIONS, optimization_goal=IMPRESSIONS
Le CPC fait référence à billing_event=CLICKS, optimization_goal=CLICKS
L’oCPM fait référence à billing_event=IMPRESSIONS, optimization_goal défini sur une action
Le CPA fait référence à la fois à billing_event et optimization_goal définis sur une action

Objectif	Contenu publicitaire, type d’enchère	Spécification de suivi	Description
CANVAS_APP_ ENGAGEMENT	Publicités d’interactions avec une application Canvas avec `optimization_goal= APP_INSTALLS`	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	Consultez les spécifications méta app_engagement et post_engagement
CANVAS_APP_ INSTALLS	Publicités pour installer une application Canvas avec l’optimisation non définie sur `optimization_goal= APP_INSTALLS`	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	Consultez les spécifications méta app_engagement et post_engagement
CONVERSIONS	Publicités pour une page web publiée par une Page et publicités photo avec `promoted_object` défini sur un ID de pixel et `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Spécifications Interactions avec la publication, Mention J’aime la Page. Nombre de clics sur un lien sur la publication de Page s’il n’y a qu’un seul lien, nombre d’interactions avec la publication et nombre de fois que les utilisateurs génèrent des stories ou interagissent avec une page
CONVERSIONS	Publicités pour une page web publiée par une Page et publicités photo avec l’optimisation non définie sur `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Spécifications Conversions, Interactions avec la publication, Mention J’aime la Page. Nombre de clics sur un lien sur la publication de Page s’il n’y a qu’un seul lien, nombre d’interactions avec la publication et nombre de fois que les utilisateurs génèrent des stories ou interagissent avec une page
CONVERSIONS	Publicités de domaine avec `promoted_object` défini sur un ID de pixel et `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Spécifications Mention J’aime la Page, Clics sur un lien. Nombre de clics sur un lien sur la publication de Page s’il n’y a qu’un seul lien, nombre d’interactions avec la publication et nombre de fois que les utilisateurs génèrent des stories ou interagissent avec une page.
CONVERSIONS	Publicités de domaine avec l’optimisation non définie sur `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Spécifications Conversion, Mention J’aime la Page, Clics sur un lien. Nombre de clics sur un lien sur la publication de Page s’il n’y a qu’un seul lien, nombre d’interactions avec la publication et nombre de fois que les utilisateurs génèrent des stories ou interagissent avec une page.
EVENT_RESPONSES	Publicités pour un évènement avec l’optimisation non définie sur `optimization_goal= EVENT_RESPONSES`	[{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}, {'action.type':'rsvp' , 'response':'maybe', 'event':'EVENT_ID'}, [{'action.type':'rsvp' , 'response':'no', 'event':'EVENT_ID'}]	Nombre de réponses (oui, peut-être, non) à un évènement.
EVENT_RESPONSES	Publicités pour un évènement avec `optimization_goal= EVENT_RESPONSES`	vide (la spécification de conversion couvrira les actions suivies)	Nombre de réponses (oui, peut-être, non) à un évènement.
LINK_CLICKS	Publicités pour une page web publiée par une Page et publicités photo avec n’importe quelle option d’enchère	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	Interactions avec la publication. Nombre de fois que des utilisateurs ont cliqué sur un lien hors ligne, un lien associé à un domaine particulier, ou un lien hors ligne sur une page ou une publication.
LINK_CLICKS	Publicités de domaine avec `optimization_goal= LINK_CLICKS`	{'action.type':'like', 'page':PAGE_ID}]	Mentions J’aime la Page. Nombre de fois que des utilisateurs ont cliqué sur un lien hors ligne, un lien associé à un domaine particulier, ou un lien hors ligne sur une page ou une publication.
LINK_CLICKS	Publicités de domaine avec l’optimisation non définie sur `optimization_goal= LINK_CLICKS`	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Clic vers le site web, Mentions J’aime la Page. Nombre de fois que des utilisateurs ont cliqué sur un lien hors ligne, un lien associé à un domaine particulier, ou un lien hors ligne sur une page ou une publication.
MOBILE_APP_ ENGAGEMENT	Publicités d’interactions avec une application mobile avec n’importe quelle option d’enchère	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} Pour les publicités d’interactions avec une application, vous devez explicitement indiquer une spécification de suivi à l’aide de l’ID d’app Facebook : [{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type': 'app_custom_event', 'application':APP_ID}]	Consultez les spécifications méta post_engagement. Également, nombre de fois qu’un app event se produit.
MOBILE_APP_ INSTALLS	Publicités pour installer une app mobile avec n’importe quelle option d’enchère	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} Pour les publicités d’installation d’application, vous devez explicitement indiquer une spécification de suivi à l’aide de l’ID d’app Facebook : [{'action.type': 'app_custom_event', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]	Consultez les spécifications méta post_engagement. Également, nombre de fois que des utilisateurs installent l’app via une publicité pour installer une app mobile en présence d’une version iOS/Android, et nombre de fois qu’un app event se produit.
NONE	Tout type de publicité	Consultez les spécifications de suivi par défaut par type de publicité
PAGE_LIKES	Publicités J’aime la Page ou de publication de Page avec n’importe quelle option d’enchère	{'action.type': 'page_engagement', 'page':'PAGE_ID'}	Consultez les spécifications méta d’interactions sur la page
POST_ENGAGEMENT	Publicités de publication de Page avec l’optimisation non définie sur `optimization_goal= POST_ENGAGEMENT`	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	Consultez les spécifications méta d’interactions avec les publications de la Page
POST_ENGAGEMENT	Publicités de publication de Page avec `optimization_goal= POST_ENGAGEMENT`	vide	Consultez les spécifications méta d’interactions avec les publications de la Page
POST_ENGAGEMENT (test)	toute publicité	{'action.type': 'dwell', 'post':'POST_ID', 'page':'PAGE_ID'}	Un petit pourcentage de ce type de publicité est associé au type de suivi `dwell`, mettant l’accent sur les utilisateurs qui passent un minimum de temps sur les publicités.
PRODUCT_ CATALOG_SALES	Publicités de produits dynamiques	{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}	Nombre de clics sur un lien sur la publication de Page s’il n’y a qu’un seul lien, nombre d’interactions avec la publication et nombre de fois que les utilisateurs génèrent des stories ou interagissent avec une Page. Vous pouvez spécifier un ensemble de produits différent de celui associé à l’objet dont vous faites la promotion, mais l’ensemble de produits par défaut est celui spécifié dans cet objet.

Spécifications méta

Vous pouvez indiquer plusieurs types d’actions sur un seul objet à l’aide d’une spécification unique.

Objet	Spécification de conversion	Description
Application	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Nombre de fois que des utilisateurs génèrent des stories via `app_story` ou interagissent avec le contenu via app_use, app_install, credit_spent.
Page	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Nombre de fois que des utilisateurs effectuent les actions suivantes sur une Page spécifique : visite, ajout de commentaire, abonnement, mention J’aime, mention J’aime sur la publication de Page, mention, publication sur une Page, partage d’une publication, ajout d’une réponse à une question. Inclut le nombre de fois où les utilisateurs effectuent l’une des actions suivantes dans le contexte de la Page spécifiée : cliquer sur un lien, afficher une photo, lire une vidéo FB native.
Publication de Page	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Nombre de fois que des utilisateurs effectuent les actions suivantes sur une publication spécifique : ajout de commentaire, suivi d’une question, mention J’aime, partage, ajout de réponse à une question. Inclut le nombre de fois où les utilisateurs effectuent l’une des actions suivantes : cliquer sur un lien, aimer la Page, afficher une photo, lire une vidéo hébergée sur Facebook ou lire une vidéo en ligne sur YouTube. Pour les vidéos non intégrées, utilisez link_click.

Spécifications de suivi personnalisées

Pour définir vos propres spécifications, utilisez la structure de spécification des actions. Consultez Spécifications des actions : documentation de référence.

Action (types d’objets)	Description, détails sur les spécifications de suivi	Spécification de suivi ou de conversion
app_custom_event (application)	Évènement personnalisé dans une app. Nombre d’évènements personnalisés dans une app mobile.	{'action.type': 'app_custom_event', 'application':APP_ID}
app_install (application)	Installation d’une app. Nombre d’installations dans un canevas ou une app mobile	[{'action.type':'app_install', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application':APP_ID}]
app_use (application)	Nombre de fois qu’une app a été utilisée.	{'action.type':'app_use', 'application':APP_ID}
checkin (site)	Visite d’un site. Nombre de visites sur un site ou sur des emplacements appartenant à cette Page.	{'action.type':'checkin', 'page': PAGE_ID}, {'action.type':'checkin', 'page.parent:PAGE_ID}
comment (publication)	Ajout de commentaire sur une publication. Nombre de commentaires sur une publication de la Page.	{'action.type':'comment', 'post.wall':PAGE_ID}, {'action.type':'comment', 'post':POST_ID, 'post.wall':PAGE_ID}
credit_spend (application)	Cas d’utilisation de crédit dans une app.	'action.type':'credit_spent', 'application':APP_ID}
follow (question)	Abonnement à un objet. Nombre de réponses à une question ou de suivis.	{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}
leadgen_quality_conversion (pixel)	Évènements (CRM) de conversion de prospects en aval du funnel.	{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}
like (page, publication)	Ajout d’une mention J’aime sur un objet. Nombre de mentions J’aime ajoutées sur une Page ou une publication.	{'action.type':'like', 'page':PAGE_ID} , {'action.type':'like', 'post.wall':PAGE_ID} , {'action.type':'like', 'post':POST_ID, 'post.wall':PAGE_ID}
link_click (page, publication, url, domaine d’url)	Clic sur un lien. Nombre de fois que des utilisateurs ont cliqué sur un lien hors ligne, un lien associé à un domaine particulier, ou un lien hors ligne sur une Page ou une publication.	{'action.type':['link_click'], 'object':['URL']}, {'action.type':['link_click'], 'object.domain': ['URL_DOMAIN']}, {'action.type':['link_click'], 'post.wall':['PAGE_ID']}, {'action.type':['link_click'], 'post':['POST_ID'], 'post.wall':['PAGE_ID']}
mention (page)	Mention d’une Page. Nombre de mentions relatives à une Page.	{'action.type':'mention', 'object':PAGE_ID'}
offsite_conversion (pixel)	Nombre de conversions hors ligne et de chiffre d’affaires cumulé.	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}
photo_view (page)	Consultation d’une photo. Nombre de consultations de photo, de lecture de vidéo ou de clics sur un lien en rapport avec des photos/vidéos/partages d’une publication sur une Page.	{'action.type':'photo_view', 'post.wall':PAGE_ID} {'action.type':'photo_view', 'post':POST_ID, 'post.wall':PAGE_ID}
post (publication)	Partage d’une story. Nombre de publications d’utilisateurs sur une Page.	{'action.type':'post', 'post.wall':PAGE_ID}
receive_offer (offre)	Demande d’une offre. Nombre de personnes ayant demandé une offre spécifique.	{'action.type':'receive_offer', 'offer':OFFER_ID}
rsvp (évènement)	Réponse à un évènement. Nombre de réponses (oui et peut-être) à un évènement. Les valeurs correctes sont les suivantes : `yes`, `maybe` et `no`.	{'action.type':'rsvp', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'yes', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'no', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'maybe', 'event': EVENT_ID}
tab_view (page)	Consultation de l’onglet d’une Page Nombre de consultations d’un onglet de Page. Pour le nombre de consultations de tous les onglets, spécifiez uniquement la Page.	{'action.type':'tab_view', 'page.tab.name': 'PAGE_TAB_NAME', 'page':PAGE_ID}, {'action.type':'tab_view', 'page':PAGE_ID}
video_play (publication)	Lecture d’une vidéo. Nombre de lectures d’une vidéo dans la publication d’une Page.	{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID, 'post.wall':PAGE_ID}

Exemples

Suivi des pixels

Effectuez le suivi des performances de différents pixels dans une publicité en spécifiant le pixel de suivi dans le champ tracking_specs de la publicité. Par exemple :

tracking_specs="[
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:1&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:2&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:3&#125;
]"

Dans cet exemple, on suit les performances des pixels « 1 », « 2 » et « 3 ». Pour procéder à une optimisation du pixel « 1 » uniquement, définissez le promoted_object de l’ensemble de publicités parent. Cette opération est utile pour optimiser CHECKOUT, mais aussi pour suivre le nombre de REGISTRATION et de ADD_TO_CART.

Les pixels optimisés via la spécification de l’ID de pixel dans promoted_object sont automatiquement suivis. Vous n’avez donc pas à les spécifier dans tracking_specs.

Utilisation des spécifications de conversion

conversion_specs est un champ destiné aux publicités. Il suit le format {'action.type':'{ACTION}', ... }, où chaque action s’applique à un objet. Voici des exemples de spécifications de conversion pour différents types de publicités :

Type de publicité	Spécification de conversion
Publicité de domaine avec contexte social	{'action.type':'link_click', 'object':'URL'}
Publicité pour aimer une Page	{'action.type':'like', 'page':PAGE_ID}
Publicité pour une page web publiée par une Page	{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}
Toutes les autres publicités de publication de Page	{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}
Publicité pour un évènement	{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}
Publicité pour une offre	{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}
Publicité pour installer une app mobile	N/A : impossible de créer ce type de publicité avec l’objectif NONE.
Publicités d’interactions avec une application mobile	N/A : seuls les types d’enchères CPC et CPM sont acceptés
Publicité pour installer une app Canvas	N/A : impossible de créer ce type de publicité avec l’objectif NONE
Publicité d’interaction avec une app Canvas	N/A : impossible de créer ce type de publicité avec l’objectif NONE

Certaines spécifications de conversion contiennent plusieurs actions s’appliquant à un seul objet. Il s’agit des spécifications méta. Exemples :

Objet	Spécification de conversion	Description
Page	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Nombre de fois qu’un utilisateur effectue les actions suivantes sur une Page spécifique : visite, ajout de commentaire, abonnement, mention J’aime, mention J’aime sur la publication de Page, mention, publication sur une Page, partage d’une publication, ajout d’une réponse à une question. Cela inclut également ces actions : consultation d’une photo, lecture d’une vidéo Facebook native.
Publication de Page	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Nombre de fois qu’un utilisateur effectue l’une des actions suivantes dans une publication spécifique : ajout de commentaire, suivi d’une question, mention J’aime, partage, demande d’offre, ajout de réponse à une question. Cela inclut également ces actions : clic sur un lien, mention J’aime sur une Page, consultation de photo, lecture d’une vidéo hébergée sur Facebook ou d’une vidéo YouTube intégrée. Pour les vidéos non intégrées, utilisez `link_click`.
Application	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Nombre de fois qu’un utilisateur génère une story via `app_story` ou interagit avec du contenu dans le cadre de `app_use`, `app_install` ou `credit_spent`.