event_name chaîne | Obligatoire. Nom d’un évènement standard ou personnalisé. Ce champ est utilisé pour dédupliquer les évènements envoyés à la fois par le Web (via le pixel Meta) ou l’application (via le SDK ou l’API App Events) et par l’API Conversions. Le paramètre event_id est également utilisé pour la déduplication.
Pour la même action clientèle, le paramètre event de l’évènement de navigateur ou d’application correspond au paramètre event_name de l’évènement de serveur. Si nous établissons une correspondance entre des évènements envoyés au cours de la même période de 48 heures, nous ne conservons que le premier des deux. Lorsqu’un évènement de serveur et un évènement de navigateur/d’application se produisent à peu près au même moment (c’est-à-dire à 5 minutes d’intervalle), nous privilégions l’évènement de navigateur/d’application. Pour en savoir plus, consultez la page Déduplication des évènements de pixel et de serveur. |
event_time entier | Obligatoire. Horodatage Unix exprimé en secondes indiquant l’heure à laquelle l’évènement s’est réellement produit. L’heure spécifiée peut être antérieure à l’heure à laquelle vous avez envoyé l’évènement à Facebook, pour permettre un traitement groupé et l’optimisation des performances du serveur. Vous devez envoyer cette date dans le fuseau horaire GMT.
La valeur du paramètre event_time peut remonter jusqu’à 7 jours avant l’envoi d’un évènement à Facebook. Si une valeur event_time dans data remonte à plus de 7 jours, une erreur est renvoyée pour l’ensemble de la requête, et aucun évènement n’est traité. |
user_data objet | Obligatoire. Carte contenant les données des informations clientèle. Consultez les paramètres des informations clientèle pour connaître les options disponibles. Pour connaître les options équivalentes disponibles pour les données envoyées via le pixel Meta, consultez la page Correspondance avancée. |
custom_data objet | Facultatif. Carte incluant les données professionnelles supplémentaires relatives à l’évènement. Consultez la page Paramètres de données personnalisés pour en savoir plus. |
event_source_url chaîne | Facultatif. URL de navigateur sur laquelle l’évènement est survenu. L’URL devrait correspondre au domaine vérifié.
Remarque : le paramètre event_source_url est obligatoire pour les évènements de site Web partagés via l’API Conversions. |
opt_out booléen | Facultatif. Marquage spécifiant que cet évènement ne doit pas être utilisé pour optimiser la diffusion des publicités. S’il est défini sur true , l’évènement est uniquement utilisé pour l’attribution. |
event_id chaîne | Facultatif. Cet ID peut être n’importe quelle chaîne unique choisie par l’annonceur. Les paramètres event_id et event_name sont utilisés pour dédupliquer les évènements envoyés à la fois par le Web (via le pixel Meta) ou l’application (via le SDK ou l’API App Events) et par l’API Conversions. Veuillez noter que, bien que le paramètre event_id soit facultatif, il est recommandé pour la déduplication des évènements.
Dans le cadre de la déduplication, l’eventID d’un évènement de navigateur ou d’application doit correspondre à l’event_id de l’évènement de serveur correspondant. Pour en savoir plus, rendez-vous sur la page Gestion des évènements dupliqués de pixel et de l’API Conversions.
Un numéro de commande ou un ID de transaction sont deux identifiants potentiels qu’il est possible d’utiliser pour event_id . Par exemple, si un·e client·e effectue deux achats sur votre site Web avec les numéros de commande 123 et 456, chaque appel de l’API Conversions devra inclure son numéro de commande respectif pour event_id . Cela nous permet de considérer ces deux évènements d’achat comme des commandes distinctes. Il est nécessaire que les deux évènements d’achat Pixel sur navigateur correspondants envoient également les mêmes numéros de commande dans le paramètre eventID pour que nous puissions comprendre qu’il n’y a eu que deux évènements, et non quatre achats uniques.
Pour les autres évènements sans numéro d’ID intrinsèque, il est possible d’utiliser un numéro aléatoire (à condition que le même numéro aléatoire soit envoyé entre les évènements de navigateur et de serveur). |
action_source chaîne | Obligatoire. Ce champ vous permet de spécifier où ont eu lieu vos conversions. La localisation de vos évènements vous aidera à diffuser vos publicités aux bonnes personnes. En utilisant l’API Conversions, vous certifiez que le paramètre action_source est à votre connaissance exact.
Les valeurs que vous pouvez envoyer dans le champ action_source sont les suivantes :
email : la conversion s’est faite par e-mail.
website : la conversion a eu lieu sur votre site Web.
app : la conversion a eu lieu dans votre application mobile.
phone_call : la conversion a été réalisée sur téléphone.
chat : la conversion a été réalisée sur une application de messagerie, par SMS ou via une fonctionnalité de messagerie en ligne.
physical_store : la conversion a été réalisée en personne dans votre magasin.
system_generated : la conversion a été effectuée automatiquement. Par exemple, un renouvellement d’abonnement configuré en paiement automatique tous les mois.
business_messaging : la conversion a été réalisée à partir de publicités de type clic vers Messenger, Instagram ou WhatsApp.
other : la conversion s’est faite d’une façon qui n’est pas répertoriée.
Remarque : toutes les valeurs d’origine de l’action activent les fonctions de mesure des publicités et de création d’audience personnalisée. À l’exception de physical_store , toutes les origines de l’action activent les fonctions d’optimisation des publicités. |
data_processing_options tableau | Facultatif Options de traitement des données que vous souhaitez activer pour un évènement donné. La valeur actuellement acceptée est LDU (pour Limited Data Use, Utilisation limitée des données). Vous pouvez envoyer une grille vide pour explicitement indiquer que les restrictions LDU ne doivent pas s’appliquer à cet évènement. En savoir plus sur les options de traitement des données. Consultez les exemples d’implémentation de l’API Conversions. |
data_processing_options_country entier | Obligatoire, si vous envoyez LDU dans les data_processing_options . Pays que vous souhaitez associer à cette option de traitement des données. Les valeurs actuellement acceptées sont 1 (pour les États-Unis) ou 0 pour que nous géolocalisions l’évènement. Pour en savoir plus, rendez-vous sur la page Options de traitement des données. Consultez les exemples d’implémentation de l’API Conversions. |
data_processing_options_state entier | Obligatoire dans certains cas. (Voir la note ci-dessous pour en savoir plus.) État que vous souhaitez associer à cette option de traitement des données. Les valeurs actuellement acceptées sont 1000 (pour la Californie) ou 0 pour que nous géolocalisions l’évènement.
Remarque : Si vous spécifiez un pays, vous devez également indiquer un État. Sinon, nous appliquons notre logique de géolocalisation à l’évènement dans son intégralité. Ce champ est obligatoire si vous envoyez la valeur LDU dans les data_processing_options , sans fournir d’adresse IP.
Pour en savoir plus, consultez la page Options de traitement des données. Consultez les exemples d’implémentation de l’API Conversions. |
app_data
objet | Obligatoire pour les évènements d’application Paramètres permettant de partager des données d’application et des informations sur l’appareil avec l’API Conversions. extinfo est un sous-paramètre de app_data .
|
extinfo
objet | Obligatoire pour les évènements d’application Informations étendues sur l’appareil, comme la largeur et la hauteur de l’écran. Ce paramètre est un tableau dont les valeurs sont séparées par une virgule. Lorsque extinfo est utilisé, toutes les valeurs sont obligatoires et doivent apparaître dans l’ordre indiqué ci-dessous. Si une valeur est manquante, remplissez-la à l’aide d’une chaîne vide servant d’espace réservé.
Remarque :
La version doit être a2 pour Android La version doit être i2 pour iOS
|
0
chaîne | Obligatoire extinfo version
Exemple : i2 |
1
chaîne | nom du package de l’application
Exemple : com.facebook.sdk.samples.hellofacebook |
2
chaîne | version courte (entier ou chaîne)
Exemple : 1.0 |
3
chaîne | version longue
Exemple : 1.0 long |
4
chaîne | Obligatoire version du système d’exploitation
Exemple : 13.4.1 |
5
chaîne | nom du modèle d’appareil
Exemple : iPhone5,1 |
6
chaîne | paramètre linguistique
Exemple : En_US |
7
chaîne | fuseau horaire abrégé
Exemple : PDT |
8
chaîne | opérateur
Exemple : AT&T |
9
int64 | largeur de l’écran
Exemple : 320 |
10
int64 | hauteur de l’écran
Exemple : 568 |
11
chaîne | densité de l’écran
Exemple : 2 |
12
int64 | nombre de cœurs du processeur
Exemple : 2 |
13
int64 | taille du stockage externe en Go
Exemple : 13 |
14
int64 | espace libre sur le stockage externe en Go
Exemple : 8 |
15
chaîne | fuseau horaire de l’appareil
Exemple : USA/New York |
referrer_url chaîne | Facultatif. L’en-tête du référent HTTP tel que noté par la Page déclenchant l’évènement d’API Conversions ou de pixel Meta. Il s’agit généralement de la page précédente dans le navigateur. |
original_event_data objet | Facultatif. Tous les champs de métadonnées que les annonceurs peuvent utiliser pour préciser comment un évènement « retardé » devrait être associé à un évènement d’acquisition passé. Nous vous recommandons vivement d’utiliser original_event_data lorsqu’il y a un délai entre l’envoi d’un évènement et un évènement d’acquisition passé auquel il devrait être associé. Pour en savoir plus, consultez la page Paramètres de données d’évènement d’origine. |