Attributs des partenaires
Inclure des données riches et granulaires dans votre intégration SDK permet un ciblage amélioré et de meilleures capacités de personnalisation, conduisant à 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 Rokt prédéfinis 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 des 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 pour répondre aux exigences de traitement de la plateforme Rokt, par exemple, vérifier les chaînes vides, ou si les types de données sont analysables. D'autres vérifications de validation recherchent la justesse et les valeurs appropriées, par exemple, les dates de naissance étant entre une plage spécifique ou si un numéro de téléphone est valide.
Attributs principaux
Cette liste fondamentale d'attributs est essentielle pour offrir avec succès des offres pertinentes à vos clients
| Description | Nom de l'attribut | Format | Exemple de charge utile |
|---|---|---|---|
| chaîne | john.smith@rokt.com | ||
| Prénom | firstname | chaîne | John |
| Nom de famille | lastname | chaîne | Smith |
| Référence de confirmation | confirmationref | chaîne | XYZ123 |
| Code postal de facturation | billingzipcode | chaîne | 10014 OU 10014-1234 |
| Montant | amount | décimal | 300.5 |
| Type de paiement | paymenttype | chaînes séparées par des virgules, les Pipes (|) séparent les paiements fractionnés | Carte-cadeau | Chase, Visa |
| BIN de carte de crédit | ccbin | chaîne | 372888 |
| Mobile | mobile | chaîne | 7325558585 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Âge | age | entier | 28 |
| Genre | gender | chaîne | m |
| Langue | language | chaîne | EN |
| Adresse de facturation | billingaddress1 | chaîne | 175 Varick St |
| Ligne 2 de l'adresse de facturation | billingaddress2 | chaîne | Étage 10 |
| Devise | currency | chaîne | USD |
| Données du panier | cartItems | tout type de données complexe pris en charge (tableau, objet, chaîne) | Voir Données d'article de panier |
remarque
Les attributs de données suivants devraient être issus des informations de facturation :
- Prénom
- Nom de famille
- Devise
- Type de paiement
- CC Bin
- Ligne 1 de l'adresse
- Ligne 2 de l'adresse
- Code postal ou code postal
- Pays
amount devrait provenir du montant final de la commande, après tous frais inclus (taxes, expédition, etc.).
Données de l'article du panier
cartItems représentent toutes les données associées au panier client, y compris, pour chaque produit, le nom du produit, la catégorie du produit, la quantité, le prix, le SKU, etc. Prend en charge tout type de données complexe contenant des données de 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 des produits. | majorCat | string | Vêtements & Accessoires |
| L'ID de la catégorie principale du produit. | majorCatID | string | 123456 |
| La catégorie mineure du produit, également connue sous le nom de deuxième niveau de la taxonomie des produits. | minorCat1 | string | Vêtements |
| L'ID de la catégorie mineure du produit. | minorCatID | string | 123456 |
| Le troisième niveau de la taxonomie des produits. | minorCat2 | string | Vêtements de sports |
| Le quatrième niveau de la taxonomie des produits. | minorCat3 | string | Vêtements de cyclisme |
| Le cinquième niveau de la taxonomie des produits. | minorCat4 | string | Collants de vélo |
| Le SKU du produit | sku | string | 1234 |
| Le nom du produit. | productName | string | Collants de cyclisme pour femmes Viper Rouges |
| La quantité de chaque produit dans le panier. | quantity | number | 3 |
| Le prix du produit. | price | number | 89.9 |
| Le nombre total de produits achetés. | numberOfProducts | number | 1 |
| La description du produit. | productDescription | string | 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/womenstights |
Billetterie et divertissement
| Description | Nom de l'attribut | Format | Exemple de donnée |
|---|---|---|---|
| string | john.smith@rokt.com | ||
| Prénom | firstname | string | John |
| Nom de famille | lastname | string | Smith |
| Référence de confirmation | confirmationref | string | XYZ123 |
| Code postal de facturation | billingzipcode | string | 10014 OU 10014-1234 |
| Montant | amount | décimal | 300.5 |
| Type de paiement | paymenttype | chaînes séparées par des virgules, des barres (|) séparent les paiements partagés | Carte cadeau | Chase, Visa |
| BIN carte de crédit | ccbin | string | 372888 |
| Mobile | mobile | string | 7325558585 |
| Pays | country | Code de pays ISO Alpha-2 | Exemples |
| Âge | age | entier | 28 |
| Sexe | gender | string | m |
| Langue | language | string | EN |
| Adresse de facturation | billingaddress1 | string | 175 Varick St |
| Complément d'adresse de facturation | billingaddress2 | string | Étage 10 |
| Ville | city | string | New York |
| État / Département | state | string | NY |
| Devise | currency | string | USD |
| Nom de l'événement | eventname | string | John Smith Featuring the Smiths: Live |
| ID Événement | eventid | string | E017448281A |
| Catégorie principale | majorcat | string | Concerts |
| Sous-catégorie | minorcat | string | R&B |
| Nombre de billets | notickets | nombre | 4 |
| Description de l'événement | eventdescription | string | Le spectacle le plus incroyable du monde. |
| 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 | code postal | 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 charge utile |
|---|---|---|---|
| chaîne | john.smith@rokt.com | ||
| Prénom | firstname | chaîne | John |
| Nom de famille | lastname | chaîne | Smith |
| Référence de confirmation | confirmationref | chaîne | XYZ123 |
| Code postal de facturation | billingzipcode | chaîne | 10014 OU 10014-1234 |
| Montant | amount | décimal | 300.5 |
| Type de paiement | paymenttype | chaînes séparées par des virgules, des barres (|) séparent les paiements partagés | Gift card | Chase, Visa |
| BIN de carte de crédit | ccbin | chaîne | 372888 |
| Mobile | mobile | chaîne | 7325558585 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Âge | age | entier | 28 |
| Genre | gender | chaîne | m |
| Langue | language | chaîne | EN |
| Adresse de facturation | billingaddress1 | chaîne | 175 Varick St |
| Ligne d'adresse de facturation 2 | billingaddress2 | chaîne | Floor 10 |
| Ville | city | chaîne | New York |
| État | state | chaîne | NY |
| Devise | currency | chaîne | USD |
| Date de voyage | traveldate | aaaa-mm-jj | 20200408 |
| Heure de voyage | traveltime | format 24 heures | 1930 |
| Ville de destination | destcity | chaîne | New York |
| Aéroport de destination | destairport | Code (IATA) | Exemples |
| Code postal de l'aéroport de destination | destairportzipcode | code postal | Exemples |
| Ville de départ | departcity | Chaîne | Sydney |
| Aéroport de départ | departairport | Code (IATA) | Exemples |
| Code postal de l'aéroport de départ | departairportzipcode | code postal | Exemples |
| Nombre de passagers | pax | nombre | 2 |
| Type de voyage | triptype | chaîne | Business |
| Programme de fidélité | loyaltyprogram | chaîne | Star Alliance |
| Niveau de fidélité | loyaltytier | chaîne | 1 |
| Excédent de bagages | excessbaggage | booléen | No |
| Classe de voyage | travelclass | chaîne | Business |
| Transporteur | carrier | chaîne | Nippon Airways |
| Hôtel réservé | bookedhotel | booléen | Yes |
| Assurance achetée | purchasedinsurance | booléen | No |
| Voiture réservée | carbooked | booléen | Yes |
Vente au détail
| Description | Nom de l'attribut | Format | Exemple de charge utile |
|---|---|---|---|
| string | john.smith@rokt.com | ||
| Prénom | firstname | string | John |
| Nom de famille | lastname | string | Smith |
| Référence de confirmation | confirmationref | string | XYZ123 |
| Code postal de facturation | billingzipcode | string | 10014 OU 10014-1234 |
| Montant | amount | decimal | 300.5 |
| Type de paiement | paymenttype | chaînes séparées par des virgules, des tubes (|) séparent les paiements fractionnés | Carte-cadeau | Chase, Visa |
| BIN de la carte de crédit | ccbin | string | 372888 |
| Mobile | mobile | string | 7327572923 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Langue | language | string | EN |
| Adresse de facturation | billingaddress1 | string | 175 Varick St |
| Adresse de facturation Ligne 2 | billingaddress2 | string | Floor 10 |
| Ville | city | string | New York |
| État | state | string | NY |
| Devise | currency | string | USD |
| Code promo | couponcode | string | VIP10 |
| Identifiant client client | clientcustomerid | string | 123-xyz-456 |
| Type de client | customertype | invité / membre | invité |
| Programme de fidélité | loyaltyprogram | string | Macy’s Rewards |
| Niveau de fidélité | loyaltytier | string | 1 |
| Cadeau | gift | boolean | Oui |
| Carte de crédit de détail | retailcreditcard | boolean | Oui |
| Prix | price | decimal | 300.5 |
| Quantité | quantity | integer | 3 |
| Catégorie principale | majorcat | string | Vêtements |
| Catégorie mineure | minorcat | string | Chaussures |
| Nom du produit | productname | string | Brooks Brothers Brown Loafer |
| SKU | string | string | DSC-HX99 |
| Adresse de livraison | shippingddress1 | string | 175 Varick St |
| Adresse de livraison Ligne 2 | shippingaddress2 | string | Floor 10 |
| Code postal de livraison | shippingzipcode | string | 10014 OU 10014-1234 |
Alimentation et boissons
| Description | Nom de l'attribut | Format | Exemple de charge utile |
|---|---|---|---|
| chaîne | john.smith@rokt.com | ||
| Prénom | firstname | chaîne | John |
| Nom de famille | lastname | chaîne | Smith |
| Référence de confirmation | confirmationref | chaîne | XYZ123 |
| Code postal de facturation | billingzipcode | chaîne | 10014 OU 10014-1234 |
| Montant | amount | décimal | 300.5 |
| Type de paiement | paymenttype | chaînes séparées par des virgules, Pipes (|) séparent les paiements partagés | Carte cadeau | Chase, Visa |
| BIN de la carte de crédit | ccbin | chaîne | 372888 |
| Mobile | mobile | chaîne | 7325558585 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Langue | language | chaîne | EN |
| Devise | currency | chaîne | USD |
| Âge | age | entier | 28 |
| Sexe | gender | chaîne | m |
| Adresse de facturation | billingaddress1 | chaîne | 175 Varick St |
| Adresse de facturation Ligne 2 | billingaddress2 | chaîne | Étage 10 |
| Ville | city | chaîne | New York |
| État | state | chaîne | NY |
| Livraison | delivery | booléen | Oui/non |
| Mobile | mobile | chaîne | 7327572923 |
| Programme de fidélité | loyaltyprogram | chaîne | Chipotle Rewards |
| Niveau de fidélité | loyaltytier | chaîne | 1 |
| Prix | price | décimal | 300.5 |
| Quantité | quantity | entier | 3 |
| Catégorie principale | majorcat | chaîne | Cuisine mexicaine |
| Catégorie mineure | minorcat | chaîne | Tacos |
| Nom du produit | productname | chaîne | Tacos au steak avec guacamole |
| SKU | string | chaîne | DSC-HX99 |
# B2B
| Description | Nom de l'attribut | Format | Exemple de charge utile |
|---|---|---|---|
| chaîne de caractères | john.smith@rokt.com | ||
| Prénom | firstname | chaîne de caractères | John |
| Nom | lastname | chaîne de caractères | Smith |
| Référence de confirmation | confirmationref | chaîne de caractères | XYZ123 |
| Code postal de facturation | billingzipcode | chaîne de caractères | 10014 OU 10014-1234 |
| Montant | amount | décimal | 300.5 |
| Type de paiement | paymenttype | chaînes de caractères séparées par des virgules, des barres verticales (|) séparent les paiements divisés | Gift card | Chase, Visa |
| BIN de carte de crédit | ccbin | chaîne de caractères | 372888 |
| Mobile | mobile | chaîne de caractères | 7325558585 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Langue | language | chaîne de caractères | EN |
| Devise | currency | chaîne de caractères | USD |
| Âge | age | entier | 28 |
| Genre | gender | chaîne de caractères | m |
| Adresse de facturation | billingaddress1 | chaîne de caractères | 175 Varick St |
| Adresse de facturation Ligne 2 | billingaddress2 | chaîne de caractères | Floor 10 |
| Ville | city | chaîne de caractères | New York |
| État | state | chaîne de caractères | NY |
| Type d'expédition | shippingtype | chaîne de caractères | Priority Express |
| Nom du produit | productname | chaîne de caractères | LG Standing Desk |
| Nom de l'entreprise | businessname | chaîne de caractères | 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 | Office Supplies |
| Catégorie secondaire | minorcat | chaîne de caractères | Desks |
| 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 |
|---|---|
| Australia | AU |
| Austria | 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 |