Intégration des données
Il est important que vous intégriez les éléments de données appropriés pour permettre à Rokt de charger chacun des processus d'inscription ou de demande des fournisseurs de paiement approuvés. Votre gestionnaire de compte travaillera avec vous pour recueillir les informations nécessaires et vous fournira ensuite un extrait de code personnalisé en fonction de vos besoins spécifiques.
Attributs principaux - Page des paiements
Si vous avez besoin de modifier l'un de ces attributs, veuillez travailler avec votre gestionnaire de compte.
Ce tableau montre les attributs principaux requis pour sélectionner et afficher le placement Rokt. Ces attributs doivent être intégrés lorsqu'ils sont disponibles sur la page des paiements.
| Description | Nom de l'attribut | Format | Exemple de charge utile |
|---|---|---|---|
| Montant | amount | décimal | 300.5 |
| E-mail (si présent) | chaîne | john.smith@rokt.com | |
| Prénom | firstname | chaîne | John |
| Nom de famille | lastname | chaîne | Smith |
| Code Postal de Facturation | billingzipcode | chaîne | 10014 OU 10014-1234 |
| Pays | country | Code pays ISO Alpha-2 | Exemples |
| Langue | language | chaîne | EN |
| 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 du panier |
Attributs principaux - Page de confirmation
Il est extrêmement important d'ajouter les attributs suivants à l'intégration de la page de confirmation, s'ils ne sont pas déjà disponibles, pour améliorer l'optimisation et rendre plus pertinente la diffusion des pages de paiement:
| 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 (plate-forme, marque de carte, réseau de paiement). Les pipes (|) séparent les paiements fractionné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 |
| Sexe | gender | chaîne | m |
| Langue | language | chaîne | EN |
| Adresse de facturation | billingaddress1 | chaîne | 175 Varick St |
| Adresse de facturation Ligne 2 | billingaddress2 | chaîne | Floor 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 de l'article du panier |
Données de l'article du panier
cartItems peut être fourni dans n'importe quel format, tableaux, objets ou chaînes, et doit contenir les propriétés suivantes pour chaque produit dans le panier.
| Nom de l'attribut | Type | Description |
|---|---|---|
| majorCat | string | La catégorie principale du produit, également connue sous le nom de premier niveau de la taxonomie du produit. |
| majorCatID | string | L'ID de la catégorie principale du produit. |
| minorCat1 | string | La catégorie mineure du produit, également connue sous le nom de deuxième niveau de la taxonomie du produit. |
| minorCatID | string | L'ID de la catégorie mineure du produit. |
| minorCat2 | string | Le troisième niveau de la taxonomie du produit. |
| minorCat3 | string | Le quatrième niveau de la taxonomie du produit. |
| minorCat4 | string | Le cinquième niveau de la taxonomie du produit. |
| sku | string | L'unité de gestion des stocks ou SKU du produit. |
| productName | string | Le nom du produit. |
Attributs d'optimisation et d'analyse
Rokt vous demande de remplir les attributs de données concernant la transaction pour nous aider à mieux personnaliser les offres que le client voit. Inclure ces éléments de données dans votre intégration permet d'améliorer les capacités de ciblage et d'optimisation menant à un engagement accru, plus de revenus, et une meilleure expérience client.
Beaucoup des attributs listés ci-dessous sont également importants pour Rokt afin de fournir des analyses et des rapports liés à votre transaction ecommerce, par exemple, des rapports sur les revenus de transaction et le taux de conversion du panier.
| Nom de l'attribut | Type | Valeurs acceptées (si disponibles) | Description |
|---|---|---|---|
| customerid | string | Le client qui a créé la commande. | |
| cartid | id | L'ID correspondant du panier devenu cette commande. | |
| subtotal | number | Le total de la commande sans les taxes ou les frais de port appliqués. | |
| totalTax | number | Le montant total de la taxe sur la commande. | |
| totalShipping | number | Le montant total des frais de port sur la commande. | |
| margin | amount | La marge bénéficiaire moyenne sur une vente. | |
| currency | currency code | La devise de la commande. | |
| shippingAddress1 | address | La première ligne de l'adresse de livraison. | |
| shippingAddress2 | address | La deuxième ligne de l'adresse de livraison. | |
| shippingCity | string | La ville où la commande doit être livrée. | |
| shippingState | string | L'état où la commande doit être livrée. | |
| shippingZipcode | code postal | Validation selon les systèmes d'adressage de l'Union postale universelle. | Le code postal où la commande doit être expédiée. |
| shippingCountry | chaîne de caractères | Le pays où la commande doit être expédiée. | |
| shippingCompanyName | chaîne de caractères | Le nom de l'entreprise passant la commande (si applicable). | |
| billingAddress1 | adresse | Caractères spéciaux autorisés: -'´`",.:;#&/()+@ °ºᵃª_ \ | La première ligne de l'adresse sur le type de paiement. |
| billingAddress2 | adresse | Caractères spéciaux autorisés: -'´`",.:;#&/()+@ °ºᵃª_ \ | La deuxième ligne de l'adresse sur le type de paiement. |
| billingCity | chaîne de caractères | La ville ou le quartier de l'utilisateur de facturation selon la région. | |
| billingState | chaîne de caractères | L'état sur le type de paiement. | |
| billingZipcode | code postal | Validation selon les systèmes d'adressage de l'Union postale universelle. | Le code postal sur le type de facturation. |
| billingCountry | chaîne de caractères | Le pays sur le type de facturation. | |
| title | chaîne de caractères | - Mr - Mrs - Miss - Mx | Salutation ou titre du client. |
| firstName | chaîne de caractères | Le prénom du client. | |
| lastName | chaîne de caractères | Le nom de famille du client. | |
| customerType | chaîne de caractères | Description du type de client. | |
| hasAccount | booléen | - True - False | Décrit si le client est connecté ou non. |
| isReturning | booléen | - True - False | Décrit si le client a déjà été vu sur le site. |
| lastVisited | datetime | Une date et une heure valides. | La date et l'heure de la dernière activité du client sur le site. |
| isLoyalty | booléen | - True - False | Définit si le client est membre de votre programme de fidélité. |
| loyaltyTier | chaîne de caractères | Description du niveau de fidélité pour les clients membres d'un programme de fidélité. | |
| age | entier | L'âge de votre client. | |
| gender | chaîne de caractères | Le genre identifié de votre client. | |
| dob | date | La date de naissance de votre client. |
Informations supplémentaires
Type de paiement
Les partenaires doivent fournir toutes les informations relatives au paiement dans le champ paymentType, formaté comme suit :
- Les valeurs d'attribut doivent être séparées par des virgules (,) (par exemple, plate-forme, marque de carte, réseau de paiement).
- Les barres verticales (|) séparent les paiements fractionnés (par exemple, carte cadeau + carte de crédit).
- Les paiements fractionnés seront capturés en tant qu'attributs séparés (c'est-à-dire paymentType, paymentType2). Cela maintient la compatibilité avec les systèmes en aval existants. Au lancement, nous capturerons jusqu'à deux méthodes de paiement par transaction. Les clients envoyant plus de deux méthodes doivent mettre en premier les deux méthodes qui représentent la plus grande partie du solde de la transaction.
Montant
La valeur fournie au Placement Rokt via l'attribut amount reflète le prix total affiché au client sur la page. Sur une page de paiement, le montant doit être le sous-total.
| Valeurs acceptées |
|---|
| Tout entier ou double avec au plus 2 chiffres significatifs après le séparateur décimal. |
Pays et langue
La valeur fournie sous country doit refléter la région de votre magasin et la valeur sous language le contenu de votre page web. Le placement Rokt n'affichera que des offres dans la même langue que la page web où elles apparaissent, et des produits pertinents pour l'emplacement d'achat des clients.
| Country | Language | Store locale |
|---|---|---|
| United States | English | en_US |
Aucun autre pays ou langue n'est pris en charge pour le Payments Marketplace pour le moment.
Devise
Lorsqu'il est fourni, cet attribut formatte la devise pour une localisation donnée. Fournir une valeur garantit que nous affichons les prix dans la bonne devise pour la localisation du client.
Référence de confirmation
Fournir l'identifiant de référence de confirmation nous permet de compter les transactions distinctes à des fins de rapport.