Last updated 24 oct. 2023

Attributs du partenaire

L'inclusion de données riches et détaillées dans votre intégration SDK permet une ciblage amélioré et de meilleures capacités de personnalisation, ce qui entraîne plus de revenus et une meilleure expérience client. Vous devriez définir ces attributs dans le cadre de vos intégrations Web, iOS, Android ou React Native.

Vous pouvez trouver la liste complète des attributs prédéfinis de Rokt dans les sections ci-dessous. Vous pouvez également définir des attributs personnalisés pour compléter l'intégration standard.

Validation des attributs

Pour garantir la fiabilité de nos services, notre plateforme valide les identifiants spécifiques à Rokt et les attributs de données clients intégrés par les partenaires via des intégrations API SDK et/ou des navigateurs. La validation garantit que les données sont formatées conformément aux exigences de traitement de la plateforme Rokt, par exemple en vérifiant les chaînes vides ou si les types de données sont analysables. D'autres vérifications de validation recherchent la correction et les valeurs appropriées, par exemple, si la date de naissance se situe dans une plage spécifique ou si un numéro de téléphone est valide.

Attributs principaux

^{Les dix premiers attributs sont essentiels pour proposer des offres pertinentes à vos clients}

Description	Nom de l'attribut	Format	Exemple de données
Email	email	string	john.smith@rokt.com
Prénom	firstname	string	John
Référence de confirmation	confirmationref	string	XYZ123
Montant	amount	decimal	300.5
Type de paiement	paymenttype	string	Carte de crédit
BIN de carte de crédit	ccbin	string	372888
Code postal	zipcode	string	10014
Pays	country	Code pays ISO Alpha-2	Exemples
Langue	language	string	EN
Données du panier	cartItems	tout type de données complexes pris en charge (tableau, objet, chaîne de caractères)	Voir Données d'élément de panier
Nom de famille	lastname	string	Smith
Âge	age	integer	28
Genre	gender	string	m
Mobile	mobile	string	7325558585
Devise	currency	string	USD

remarque

Les attributs de données suivants doivent être obtenus à partir des informations de facturation :

• Prénom
• Nom de famille
• Devise
• Type de paiement
• BIN de carte de crédit
• Code postal
• Pays

amount doit provenir du montant final de la commande, après inclusion de tous les frais (taxe, livraison, etc.).

Données des articles du panier

cartItems représentent toutes les données associées au panier du client, comprenant, pour chaque produit, le nom du produit, la catégorie du produit, la quantité, le prix, le SKU, etc. Prend en charge n'importe quel type de données complexe contenant les données du panier et doit inclure les propriétés suivantes pour chaque produit dans le panier.

Description	Nom de l'attribut	Format	Exemple de charge utile
La catégorie principale du produit, également connue sous le nom de premier niveau de la taxonomie du produit.	majorCat	chaîne de caractères	Vêtements et accessoires
L'ID de la catégorie principale du produit.	majorCatID	chaîne de caractères	123456
La catégorie secondaire du produit, également connue sous le nom de deuxième niveau de la taxonomie du produit.	minorCat1	chaîne de caractères	Vêtements
L'ID de la catégorie secondaire du produit.	minorCat1ID	chaîne de caractères	123456
Le troisième niveau de la taxonomie du produit.	minorCat2	chaîne de caractères	Vêtements de sport
Le quatrième niveau de la taxonomie du produit.	minorCat3	chaîne de caractères	Vêtements de sport pour vélo
Le cinquième niveau de la taxonomie du produit.	minorCat4	chaîne de caractères	Collants de vélo
Le SKU du produit	sku	chaîne de caractères	1234
Le nom du produit.	productName	chaîne de caractères	Collants de cyclisme pour femmes Viper Rouge
La quantité de chaque produit dans le panier.	quantity	nombre	3
Le prix du produit.	price	nombre	89.9
Le nombre total de produits achetés.	numberOfProducts	nombre	1
La description du produit.	productDescription	chaîne de caractères	Arborant un design réfléchissant, notre pantalon de cyclisme long pour...
L'URL de l'image du produit.	productImageURL	URL	https://www.cycling.com/collantsfemmes

Billetterie et divertissement

Description	Nom de l'attribut	Format	Exemple de données
Email	email	string	john.smith@rokt.com
Prénom	firstname	string	John
Nom	lastname	string	Smith
Adresse ligne 1	address1	string	123 Fake Street
Adresse ligne 2	address2	string	Building A
Ville	city	string	New York
État	state	string	NY
Code postal	zipcode	string	10014
Mobile	mobile	string	7325558585
Référence de confirmation	confirmationref	string	XYZ123
Devise	currency	string	USD
Montant	amount	decimal	300.5
Type de paiement	paymenttype	string	Carte de crédit
BIN de la carte de crédit	ccbin	string	372888
Pays	country	Code pays ISO Alpha-2	Exemples
Langue	language	string	EN
Catégorie principale	majorcat	string	Concerts
Catégorie mineure	minorcat	string	R&B
Nombre de billets	notickets	number	4
Nom de l'événement	eventname	string	John Smith Featuring the Smiths: Live
ID de l'événement	eventid	string	E017448281A
Description de l'événement	eventdescription	string	Le spectacle le plus incroyable sur terre.
Date de l'événement	eventdate	yyyymmdd	20200822
Heure de l'événement	eventtime	Format 24 heures	0800
Code postal de l'événement	eventzipcode	zipcode	Exemples de format
Lieu de l'événement	eventvenue	string	Austin Big Stadium
Nom de l'artiste principal	primaryartistname	string	John Mayer

Voyage

Description	Nom de l'attribut	Format	Exemple de données
Email	email	string	john.smith@rokt.com
Prénom	firstname	string	John
Nom	lastname	string	Smith
Adresse ligne 1	address1	string	123 Fake Street
Adresse ligne 2	address2	string	Building A
Ville	city	string	New York
État	state	string	NY
Pays	country	Code pays ISO Alpha-2	Exemples
Code postal	zipcode	string	10014
Mobile	mobile	string	7325558585
Référence de confirmation	confirmationref	string	XYZ123
Devise	currency	string	USD
Langue	language	string	EN
Montant	amount	décimal	300.5
Type de paiement	paymenttype	string	Carte de crédit
BIN de la carte de crédit	ccbin	string	372888
Heure de voyage	traveltime	Format 24 heures	1930
Date de voyage	traveldate	yyyymmdd	20200408
Ville de destination	destcity	string	New York
Destination Airport	destairport	Code (IATA)	Examples
Destination Airport Zip Code	destairportzipcode	zipcode	Examples
Departure City	departcity	String	Sydney
Departure Airport	departairport	Code (IATA)	Examples
Departure Airport Zip Code	departairportzipcode	zipcode	Examples
Number of passengers	pax	number	2
Trip type	triptype	string	Business
Loyalty program	loyaltyprogram	string	Star Alliance
Loyalty tier	loyaltytier	string	1
Excess baggage	excessbaggage	boolean	No
Travel class	travelclass	string	Business
Carrier	carrier	string	Nippon Airways
Booked Hotel	bookedhotel	boolean	Yes
Purchased insurance	purchasedinsurance	boolean	No
Booked car	carbooked	boolean	Yes

Vente au détail

Description	Nom de l'attribut	Format	Exemple de données
Email	email	string	john.smith@rokt.com
Prénom	firstname	string	John
Nom	lastname	string	Smith
Adresse ligne 1	address1	string	123 Fake Street
Adresse ligne 2	address2	string	Building A
Ville	city	string	New York
État	state	string	NY
Pays	country	Code pays ISO Alpha-2	Exemples
Code postal	zipcode	string	10014
Mobile	mobile	string	7327572923
Montant	amount	décimal	300.5
Devise	currency	string	USD
Numéro de carte de crédit	ccbin	string	372888
Type de paiement	paymenttype	string	Carte de crédit
Référence de confirmation	confirmationref	string	XYZ123
Code de coupon	couponcode	string	VIP10
Langue	language	string	EN
Identifiant client	clientcustomerid	chaîne	123-xyz-456
Type de client	customertype	invité / membre	invité
Programme de fidélité	loyaltyprogram	chaîne	Macy’s Rewards
Niveau de fidélité	loyaltytier	chaîne	1
Cadeau	gift	booléen	Oui
Carte de crédit de détail	retailcreditcard	booléen	Oui
Prix	price	décimal	300.5
Quantité	quantity	entier	3
Catégorie principale	majorcat	chaîne	Vêtements
Catégorie secondaire	minorcat	chaîne	Chaussures
Nom du produit	productname	chaîne	Brooks Brothers Brown Loafer
Sku	chaîne	chaîne	DSC-HX99

Nourriture et boissons

Description	Nom de l'attribut	Format	Exemple de données
Email	email	string	john.smith@rokt.com
Prénom	firstname	string	John
Nom	lastname	string	Smith
Adresse ligne 1	address1	string	123 Fake Street
Adresse ligne 2	address2	string	Building A
Ville	city	string	New York
État	state	string	NY
Code postal	zipcode	string	10014
Pays	country	Code pays ISO Alpha-2	Exemples
Mobile	mobile	string	7325558585
Référence de confirmation	confirmationref	string	XYZ123
Langue	language	string	EN
Devise	currency	string	USD
Montant	amount	décimal	300.5
Type de paiement	paymenttype	string	Carte de crédit
BIN de la carte de crédit	ccbin	string	372888
Livraison	delivery	booléen	Oui/non
Mobile	mobile	string	7327572923
Programme de fidélité	loyaltyprogram	string	Chipotle Rewards
Niveau de fidélité	loyaltytier	string	1
Prix	price	décimal	300.5
Quantité	quantité	entier	3
Catégorie principale	majorcat	chaîne	Nourriture mexicaine
Catégorie secondaire	minorcat	chaîne	Tacos
Nom du produit	productname	chaîne	Tacos de steak avec guacamole
Sku	string	chaîne	DSC-HX99

B2B

Description	Nom de l'attribut	Format	Exemple de charge utile
Email	email	chaîne	john.smith@rokt.com
Prénom	firstname	chaîne	John
Nom de famille	lastname	chaîne	Smith
Adresse ligne 1	address1	chaîne	123 Fake Street
Adresse ligne 2	address2	chaîne	Building A
Ville	city	chaîne	New York
État	state	chaîne	NY
Code postal	zipcode	chaîne	10014
Pays	country	Code pays ISO Alpha-2	Exemples
Langue	language	chaîne	EN
Référence de confirmation	confirmationref	chaîne	XYZ123
Devise	currency	chaîne	USD
Montant	amount	décimal	300.5
Type de paiement	paymenttype	chaîne	Carte de crédit
BIN de carte de crédit	ccbin	chaîne	372888
Type d'expédition	shippingtype	chaîne	Priorité Express
Nom du produit	productname	chaîne	Bureau debout LG
Nom de l'entreprise	businessname	chaîne	Rokt
Programme de fidélité	loyaltyprogram	chaîne de caractères	Star Alliance
Niveau de fidélité	loyaltytier	chaîne de caractères	1
Mobile	mobile	chaîne de caractères	7325558585
Prix	price	décimal	300.5
Quantité	quantity	entier	3
Catégorie principale	majorcat	chaîne de caractères	Fournitures de bureau
Catégorie secondaire	minorcat	chaîne de caractères	Bureaux
Nom du produit	productname	chaîne de caractères	LG Standing Desk
Sku	string	chaîne de caractères	DSC-HX99

Annexe

Pays	Code pays ISO Alpha-2
Australie	AU
Autriche	AT
Belgique	BE
Canada	CA
Danemark	DK
Finlande	FI
France	FR
Allemagne	DE
Irlande	IE
Japon	JP
Pays-Bas (les)	NL
Nouvelle-Zélande	NZ
Norvège	NO
Singapour	SG
Espagne	ES
Suède	SE
Royaume-Uni	UK
États-Unis	US