Paramètres d’informations clientèle

Les paramètres d’informations clientèle sont un ensemble d’identifiants utilisateur·ice que vous partagez avec vos informations d’évènement. Pour en savoir plus sur les paramètres obligatoires et recommandés, consultez la section Recommandations - API Conversions : Envoyer des paramètres obligatoires et recommandés.

La version 13.0 de l’API Graph comportait de nouvelles exigences par rapport aux combinaisons de paramètres d’informations clientèle considérées comme valides. Veuillez lire les recommandations pour vous assurer que vos intégrations de l’API Conversions ne sont pas interrompues.

Veuillez consulter le Guide Meta sur la confidentialité et l’utilisation des données pour savoir quelles données sont envoyées lorsque vous utilisez l’API Conversions.

Nos systèmes sont conçus pour ne pas accepter d’informations clientèle qui sont des coordonnées non hachées, sauf indication contraire ci-dessous. Les coordonnées désignent les informations qui permettent d’identifier personnellement les particuliers comme le nom, l’adresse e-mail et le numéro de téléphone, que nous utilisons uniquement à des fins de mise en correspondance. Si vous utilisez le SDK Meta Business, le hachage est effectué automatiquement.

Comparaison avec le pixel

Vous pouvez envoyer la plupart des paramètres d’informations clientèle via le Pixel Meta, même si certains paramètres (par exemple, client_user_agent) sont envoyés automatiquement dans le cadre du fonctionnement d’Internet. Par exemple, pour envoyer un external_id via le Pixel, utilisez le code suivant :

fbq('init', 'PIXEL_ID', {'external_id': 12345});

Vous trouverez des informations sur les autres paramètres que vous pouvez transmettre via le pixel dans la documentation sur la correspondance avancée.

Inversement, veillez à appliquer au serveur le même ensemble de paramètres d’informations clientèle que celui actuellement partagé sur le navigateur par votre système

Formatage des paramètres user_data

Vous devez fournir au moins l’un des paramètres user_data suivants avec le formatage correct dans votre demande.

Veuillez télécharger ce fichier CSV

pour voir des exemples de données correctement normalisées et hachées concernant les paramètres ci-dessous.



Télécharger (Clic droit > Enregistrer le lien sous)
ParamètreDescription
em

Adresse e-mail

Chaîne ou liste <string>

Hachage obligatoire.
Supprimez tous les espaces de début et de fin. Convertissez tous les caractères en minuscules.


Exemple :

Entrée : John_Smith@gmail.com
Format normalisé : john_smith@gmail.com
Sortie SHA256 attendue : 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f

ph

Numéro de téléphone

chaîne ou liste<string>

Hachage obligatoire
Supprimez les symboles, les lettres et les éventuels zéros non significatifs. Les numéros de téléphone doivent inclure un indicatif pays pour la mise en correspondance (par ex. le chiffre 1 doit précéder un numéro de téléphone aux États-Unis). Incluez systématiquement l’indicatif pays dans les numéros de téléphone de votre clientèle, même si toutes vos données proviennent du même pays.


Exemple :

Entrée : numéro de téléphone aux États-Unis (650)555-1212
Format normalisé : 16505551212
Sortie SHA256 attendue :

e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176

fn

Prénom

chaîne ou liste<string>

Hachage obligatoire.
L’utilisation de caractères latins a-z est recommandée. Minuscules uniquement, pas de signes de ponctuation. Si vous utilisez des caractères spéciaux, le texte doit être codé au format UTF-8.


Exemple :
Entrée : Mary
Format normalisé : mary
Sortie SHA256 attendue : 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec


Entrée :
Format normalisé : caractère UTF-8 "정"
Sortie SHA256 attendue : 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14


Entrée : Valéry
Format normalisé : valéry
Sortie SHA256 attendue : 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c

ln

Nom

chaîne ou liste<string>

Hachage obligatoire.
L’utilisation de caractères latins a-z est recommandée. Minuscules uniquement, pas de signes de ponctuation. Si vous utilisez des caractères spéciaux, le texte doit être codé au format UTF-8.


Voir Prénom (fn) pour des exemples.

db

Date de naissance

chaîne ou liste<string>

Hachage obligatoire.
Nous acceptons le format AAAAMMJJ correspondant à diverses combinaisons incluant le jour, le mois et l’année, avec ou sans signes de ponctuation.

  • Année : utilisez le format AAAA de 1900 à l’année en cours.
  • Mois : utilisez le format MM : de 01 à 12.
  • Date : utilisez le format JJ : de 01 à 31.

Exemple :

Entrée : 2/16/1997
Format normalisé : 19970216
Sortie SHA256 attendue : 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c

ge

Genre

chaîne ou liste<string>

Hachage obligatoire.
Nous acceptons que le genre soit indiqué sous la forme d’une initiale en minuscule.


Exemple :

  • f pour féminin
  • m pour masculin
ct

Ville

chaîne ou liste<string>

Hachage obligatoire.
L’utilisation de caractères latins a-z est recommandée. Caractères minuscules uniquement, sans signes de ponctuation, sans caractères spéciaux et sans espaces. Si vous utilisez des caractères spéciaux, le texte doit être codé au format UTF-8.


Exemple :
paris
londres
newyork

st

État

chaîne ou liste<string>

Hachage obligatoire.
Utilisez le code d’abréviation ANSI à 2 caractères, en lettres minuscules. Normalisez les états situés hors des États-Unis : en minuscules, sans signes de ponctuation, sans caractères spéciaux et sans espaces.


Exemple :
az
ca

zp

Code postal

chaîne ou liste<string>

Hachage obligatoire.
Utilisez des caractères minuscules sans espaces et sans tiret. Utilisez uniquement les cinq premiers chiffres pour les codes postaux aux États-Unis. Utilisez le format région, circonscription et secteur pour le Royaume-Uni.


Exemple :
Code postal aux États-Unis : 94035
Code postal en Australie : 1987
Code postal en France : 75018
Code postal au Royaume-Uni : m11ae

country

Pays

chaîne ou liste<string>

Hachage obligatoire.
Utilisez les indicatifs pays à 2 lettres en minuscules au format ISO 3166-1 alpha-2.
Note importante : incluez systématiquement le pays de votre client·e, même si tous vos indicatifs pays proviennent du même pays. Sachant que nous effectuons une recherche à l’échelle mondiale, cette simple précaution nous permet donc de trouver un maximum de comptes de l’Espace Comptes à partir de votre liste.


Exemple :
Entrée : États-Unis
Format normalisé : us
Sortie SHA256 attendue : 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621

external_id

ID externe

chaîne ou liste<string>

Hachage recommandé.
Tout ID unique émanant de l’annonceur, tel qu’un ID de programme de fidélité, un ID d’utilisateur·ice et un ID de cookie externe. Vous pouvez envoyer un ou plusieurs ID externes pour un évènement donné.
Si un ID externe est envoyé via d’autres canaux, il doit être au même format que lorsqu’il est envoyé via l’API Conversions.

client_ip_address

Adresse IP du client ou de la cliente

chaîne

Ne pas hacher.
L’adresse IP du navigateur correspondant à l’évènement doit être une adresse IPV4 ou IPV6 valide. Une adresse IPV6 est préférable à une adresse IPV4 pour les utilisateur·ices compatibles IPV6. Le paramètre de données utilisateur client_ip_address ne doit jamais être haché.
Aucun espace ne doit être inclus. Fournissez toujours l’adresse IP réelle pour garantir que les évènements soient relatés avec précision.
Remarque : ces informations sont ajoutées automatiquement aux évènements envoyés via le navigateur, mais elles doivent être configurées manuellement pour les évènements envoyés via le serveur.


Exemple :
IPV4 : 168.212.226.204
IPV6 : 2001:0db8:85a3:0000:0000:8a2e:0370:7334

client_user_agent

Agent utilisateur du client ou de la cliente

chaîne

Ne pas hacher.
Agent utilisateur du navigateur correspondant à l’évènement. Le paramètre client_user_agent est obligatoire pour les évènements de site Web partagés via l’API Conversions.

L’envoi des deux paramètres client_ip_address et client_user_agent pour l’ensemble des évènements que vous envoyez via l’API Conversions peut permettre d’améliorer la mise en correspondance des évènements et également la diffusion des publicités pour toutes les campagnes publicitaires optimisées sur les évènements que vous envoyez via l’API Conversions.
Remarque : ces informations sont ajoutées automatiquement aux évènements envoyés via le navigateur, mais elles doivent être configurées manuellement pour les évènements envoyés via le serveur.


Exemple :
Mozilla/5.0 (Windows NT 10.0 ; Win64 ; x64)
AppleWebKit/537.36 (KHTML, comme Gecko)
Chrome/87.0.4280.141
Safari/537.36

fbc

ID du clic

chaîne

Ne pas hacher.
La valeur de l’ID du clic Facebook est stockée dans le cookie de navigateur _fbc sous votre domaine. Consultez la section Gestion des paramètres fbc et fbp pour savoir comment obtenir cette valeur ou la générer à partir d’un paramètre de requête fbclid.

Son format est fb.${subdomain_index}.${creation_time}.${fbclid}.


Exemple :
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

fbp

ID de navigateur

chaîne

Ne pas hacher.
La valeur de l’ID de navigateur Facebook est stockée dans le cookie de navigateur _fbp sous votre domaine. Consultez la section Gestion des paramètres fbc et fbp pour savoir comment obtenir cette valeur.

Son format est fb.${subdomain_index}.${creation_time}.${random_number}.


Exemple :
fb.1.1596403881668.1116446470

subscription_id

ID d’abonnement

chaîne

Ne pas hacher.
ID d’abonnement de l’utilisateur·ice dans cette transaction ; similaire à l’ID de commande d’un produit individuel.

fb_login_id

ID Facebook Login

nombre entier

Ne pas hacher.
ID émis par Meta lorsqu’un·e utilisateur·ice se connecte pour la première fois à l’instance d’une application. Cet ID est également appelé ID spécifique à une application.

lead_id

ID de prospect

nombre entier

Ne pas hacher.
ID associé à un prospect, généré par les publicités à formulaire de Meta.

anon_id
chaîne

Ne pas hacher.
Votre ID d’installation. Ce champ représente des instances d’installation de l’application uniques.


Remarque : ce paramètre sert uniquement aux évènements d’application.

madid
chaîne

Ne pas hacher.
Votre ID d’annonceur mobile, l’ID publicitaire d’un appareil Android ou l’identifiant publicitaire d’un appareil Apple (IDFA).


Remarque : Ce paramètre sert uniquement aux évènements d’application.

page_id
chaîne

Ne pas hacher.
Votre ID de Page. Indique l’ID de Page associé à l’évènement. Utilisez l’ID de Page Facebook de la Page associée au bot.

page_scoped_user_id
chaîne

Ne pas hacher.
Indique l’identifiant utilisateur·ice spécifique à la Page associé au bot Messenger qui enregistre l’évènement. Employez l’ID utilisateur·ice spécifique à la Page, qui a été fourni à votre webhook.

ctwa_clid
chaîne

Ne pas hacher.
ID de clic généré par Meta pour les publicités clic vers WhatsApp.

ig_account_id
chaîne

Ne pas hacher.
ID du compte Instagram associé à l’entreprise.

ig_sid
chaîne

Ne pas hacher.
Les utilisateur·ices qui interagissent avec Instagram portent des identifiants utilisateur·ice spécifiques à Instagram (IGSID). L’IGSID peut être obtenu à partir de ce webhook.