Intégration des données
Il est important d'intégrer les éléments de données appropriés pour permettre à Rokt de charger chacun des flux d'inscription ou d'application des fournisseurs de paiement approuvés. Votre gestionnaire de compte travaillera avec vous pour recueillir les informations requises, puis vous fournira un extrait 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 l'emplacement Rokt.
| Nom de l'attribut | Type | Valeurs acceptées | Description |
|---|---|---|---|
| montant | décimal | Un nombre | Le prix total de la commande (sous-total) affiché au client sur la page. |
| pays | Code de pays ISO 3166 | US | Le code de pays correspondant à la région de votre site. |
| langue | Langue ISO 639-3 | eng | La langue de votre site. |
| devise | chaîne | - USD - AUD - CAD - EUR - GBP - NZD | La devise de la commande. |
| articlesPanier | Tout type de données complexes est pris en charge. | Voir attributs des articles du panier. | La structure de données qui représente toutes les données associées au panier du 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 complexes contenant des données de panier, y compris des tableaux multidimensionnels, des objets ou des chaînes. |
| Email (si présent) | chaîne | Doit inclure @ et le domaine. | Adresse e-mail du client. |
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, afin d'améliorer l'optimisation et d'obtenir une pertinence accrue pour les emplacements de la page de paiement :
| Nom de l'attribut | Type | Valeurs acceptées | Description |
|---|---|---|---|
| string | Doit inclure @ et le domaine. | Adresse e-mail du client. | |
| ccbin/iin | number | Un nombre de six chiffres. | Les six premiers chiffres du numéro de carte de crédit. |
| Type de paiement | string | - débit - crédit - chargeCard - payPal - applePay - googlePay - grabPay - weChatPay - aliPay - affirm - sezzle - zip - afterpay - clearpay - klarna - Splitit - giftCard - customerCredit - cash | Le type de paiement pour la commande. |
Données des articles du panier
cartItems peut être fourni dans n'importe quel format, tableaux, objets ou chaînes de caractères, 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 secondaire du produit, également connue sous le nom de deuxième niveau de la taxonomie du produit. |
| minorCat1ID | string | L'ID de la catégorie secondaire 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 (SKU) du produit. |
| productName | string | Le nom du produit. |
Attributs d'optimisation et d'analyse
Rokt vous demande de renseigner des attributs contextuels sur la transaction afin de nous aider à personnaliser les offres que le client voit. L'inclusion de ces éléments de données dans votre intégration permet d'améliorer le ciblage et les capacités d'optimisation, ce qui entraîne une augmentation de l'engagement, des revenus et une meilleure expérience client.
De nombreux attributs énumérés ci-dessous sont également importants pour que Rokt puisse fournir des analyses et des rapports liés à votre transaction de commerce électronique, par exemple, des rapports sur les revenus de la transaction et le taux de conversion du panier.
| Nom de l'attribut | Type | Valeurs acceptées (si disponibles) | Description |
|---|---|---|---|
| customerid | chaîne de caractères | Le client qui a créé la commande. | |
| cartid | identifiant | L'identifiant correspondant du panier qui est devenu cette commande. | |
| subtotal | nombre | Le total de la commande sans les taxes ni les frais de livraison appliqués. | |
| totalTax | nombre | Le montant total des taxes sur la commande. | |
| totalShipping | nombre | Le montant total des frais de livraison de la commande. | |
| margin | montant | La marge bénéficiaire moyenne sur une vente. | |
| currency | code de devise | La devise dans laquelle la commande est effectuée. | |
| shippingAddress1 | adresse | La première ligne de l'adresse de livraison de la commande. | |
| shippingAddress2 | adresse | La deuxième ligne de l'adresse de livraison de la commande. | |
| shippingCity | chaîne de caractères | La ville où la commande doit être livrée. | |
| shippingState | chaîne de caractères | 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 livrée. |
| shippingCountry | chaîne de caractères | Le pays où la commande doit être livrée. | |
| shippingCompanyName | chaîne de caractères | Le nom de l'entreprise passant la commande (si applicable). | |
| paymentMethod | chaîne de caractères | - Paiement numérique - Paiement par carte - Virement bancaire - Paiement physique | La méthode de paiement spécifie la procédure de paiement par laquelle les paiements sont effectués. |
| paymentSubMethod | string | Pour le paiement numérique: - Acheter maintenant, payer plus tard - Portefeuilles numériques Pour le paiement par carte: - Carte de crédit - Carte de débit - Carte prépayée Pour le virement bancaire: - Virement bancaire - Prélèvement automatique Pour le paiement en espèces: - Espèces - Chèque | Cela représente le mode de paiement spécifique choisi par le client. Veuillez noter que les sous-méthodes de paiement varient en fonction du mode de paiement. |
| paymentBrand | string | Exemples courants incluent: - Paypal - Venmo - Apple Pay - Google Pay - Amazon Pay - Afterpay - AMEX. | La marque associée au paiement. |
| paymentIssuer | string | Exemples courants incluent: - Barclays - Citibank - Bank of America - AMEX - JPMorgan Chase - Discover - Wells Fargo - Capital One - HSBC | Les émetteurs de paiement sont des banques ou des institutions financières qui fournissent des cartes de paiement aux particuliers ou aux entreprises. |
| paymentNetwork | string | Exemples courants incluent: - Mastercard - Visa - Discover - American Express - JCB - Interac - UnionPay | Les réseaux de paiement fournissent l'infrastructure et les règles pour transmettre en toute sécurité les informations de paiement entre le commerçant, la banque du client et le processeur de paiement. |
| billingAddress1 | address | Caractères spéciaux autorisés: -'´`",.:;#&/()+@ °ºᵃª_ \ | La première ligne de l'adresse sur le type de paiement. |
| billingAddress2 | address | Caractères spéciaux autorisés: -'´`",.:;#&/()+@ °ºᵃª_ \ | La deuxième ligne de l'adresse sur le type de paiement. |
| billingCity | string | La ville ou la banlieue de l'utilisateur de facturation selon la région. | |
| billingState | string | L'état sur le type de paiement. | |
| billingZipcode | zipcode | Validation selon les systèmes d'adressage de l'Union postale universelle. | Le code postal sur le type de facturation. |
| billingCountry | string | Le pays sur le type de facturation. | |
| title | string | - M. - Mme - Mlle - Mx | Salutation ou titre du client. |
| prénom | chaîne de caractères | Le prénom du client. | |
| nom de famille | chaîne de caractères | Le nom de famille du client. | |
| type de client | chaîne de caractères | Description du type de client. | |
| a un compte | booléen | - Vrai - Faux | Indique si le client est connecté ou non. |
| est déjà venu | booléen | - Vrai - Faux | Indique si le client a déjà été vu sur le site. |
| dernière visite | date et heure | Une date et heure valide. | La date et l'heure de la dernière activité du client sur le site. |
| est fidèle | booléen | - Vrai - Faux | Définit si le client est membre de votre programme de fidélité. |
| niveau de fidélité | chaîne de caractères | Description du niveau de fidélité pour les clients membres d'un programme de fidélité. | |
| âge | entier | L'âge de votre client. | |
| genre | chaîne de caractères | Le genre identifié de votre client. | |
| date de naissance | date | La date de naissance de votre client. |
Informations supplémentaires
Montant
La valeur fournie à l'emplacement Rokt via l'attribut montant reflète le prix total affiché au client sur la page. Sur une page de paiement ou de commande, le montant devrait être le sous-total.
| Valeurs acceptées |
|---|
| Tout entier, ou décimal avec au plus 2 chiffres significatifs après le séparateur décimal. |
Pays et langue
La valeur fournie sous country devrait refléter la région de votre magasin et la valeur sous language le contenu de votre page web.
L'emplacement Rokt ne montrera 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.
| Pays | Langue | Locale du magasin |
|---|---|---|
| États-Unis | Anglais | en_US |
Aucun autre pays ou langue n'est pris en charge pour la Place de marché des paiements pour le moment.
Devise
Lorsqu'il est fourni, cet attribut formate la devise pour une locale donnée. Fournir une valeur garantit que nous affichons les prix dans la devise correcte pour la locale du client.
Référence de confirmation
Fournir l'ID de référence de confirmation nous permet de compter les transactions distinctes à des fins de rapport.