Paramètres des évènements de serveur

ParamètreDescription
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 doit commencer par http:// ou https:// et doit 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

Version d’extinfo


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.
Le site Web entrant visité immédiatement avant la page de l’annonceur où le pixel Meta s’est déclenché. Il s’agit d’un référent HTTP du point de vue de JavaScript. Le referral_url est soit la page sur laquelle l’utilisateur·ice se trouvait avant de visiter la page actuelle, soit l’iFrame.