Tealium
Configuration du SDK Web Rokt pour Tealium
L'intégration de Tealium avec Rokt vous permet d'intégrer des données clients et transactionnelles à l'aide de variables.
Lorsque vous ajoutez le code d'intégration à votre page, assurez-vous de renseigner les données clients et transactionnelles. Veillez à configurer l'adresse e-mail du client afin que Rokt puisse identifier les clients et choisir une offre pertinente.
Renseignez toutes les attributs contextuels sur la transaction pour aider Rokt à personnaliser les offres que le client voit.
Ajouter le SDK Web Rokt
- Connectez-vous à Tealium Customer Data Hub.
- Cliquez sur iQ Tag Management > Tags.
- Cliquez sur + Ajouter un tag.
- Recherchez Rokt.
- Cliquez sur +Ajouter.
Configurer le SDK Web Rokt
- Configurez les paramètres suivants:
- ID de compte Rokt: Entrez l'ID de compte Rokt fourni par votre gestionnaire de compte.
- Email en deux étapes (Optionnel): Sélectionnez True si vous souhaitez envoyer un e-mail en cas d'engagement positif.
- Utiliser le sandbox (Optionnel): Sélectionnez True si vous souhaitez envoyer des événements vers un compte sandbox pour les tests.
- EMPLACEMENTS DE PUBLICATION: Sélectionnez Oui ou Non pour les emplacements de publication et si vous souhaitez utiliser le Drapeau de Bundle.
- PARAMÈTRES AVANCÉS:
- Timing du tag: Détermine le moment où le tag est déclenché.
- Envoyer le drapeau: Détermine si cette bibliothèque reçoit ou non des données au niveau de l'événement pour le suivi.
- Type de chargement synchrone: Défini lorsque la bibliothèque doit être chargée de manière synchrone.
- Source de script personnalisé: Défini lorsque la bibliothèque qui prend en charge ce tag est servie à partir d'un emplacement alternatif.
- Cliquez sur Suivant.
Créer une règle de chargement
Les règles de chargement dans Tealium déterminent quand et où charger une instance du Rokt Web SDK sur votre site.
- Cliquez sur + Créer une règle.
- Entrez les informations suivantes :
- Nom : Donnez un nom descriptif à votre règle.
- Notes : Entrez toutes les notes concernant la règle.
- Variable : Sélectionnez Domaine.
- Opérateur : Sélectionnez égal.
- Valeur : Entrez l'URL fournie par votre gestionnaire de compte Rokt.
- Cliquez sur Terminé.
- Cliquez sur Suivant.
Mappage des données
Le mappage est le processus d'intégration d'une variable de couche de données avec la variable de destination correspondante de la balise du fournisseur.
La variable la plus couramment utilisée est la variable JS emailAddress, comme le montre le processus ci-dessous. D'autres catégories de variables sont répertoriées ci-dessous.
- Cliquez sur la liste déroulante et recherchez JS.
- Cliquez sur Utiliser une variable personnalisée.
- Sélectionnez Email et cliquez sur Terminé.
- Ajoutez d'autres variables si nécessaire.
Les catégories Standard et Ecommerce dans Tealium correspondent à Core et Supplemental dans Rokt.
Les catégories disponibles sont :
Standard
VARIABLE | DESCRIPTION |
---|---|
(email) | |
Prénom | (firstname) |
Nom de famille | (lastname) |
Numéro de téléphone portable | (mobile) |
Code postal | (zipcode) |
Pays | (country) |
Langue | (language) |
Utiliser le mode bac à sable | (sandbox) |
Ecommerce
VARIABLE | ATTRIBUT | DESCRIPTION |
---|---|---|
Numéro de confirmation | (confirmationref) | Cette variable remplace la variable _corder. |
Montant | (amount) | Cette variable remplace la variable _ctotal. |
Devise | (currency) | Cette variable remplace la variable _ccurrency. |
Type de paiement | (paymenttype) | |
ccbin | (ccbin) | |
Liste des prix des articles | (price) | [Array] Cette liste remplace la variable _cprice. |
Liste des quantités d'articles | (quantity) | [Array] Cette liste remplace la variable _cquan. |
Liste des principales catégories d'articles | (majorcat) | [Array] Cette liste remplace la variable _ccat. |
Liste des identifiants des principales catégories d'articles | (majorcatid) | [Array] |
Liste des catégories secondaires d'articles | (minorcat) | [Array] Cette liste remplace la variable _ccat2. |
Liste des identifiants des catégories secondaires d'articles | (minorcatid) | [Array] |
Liste des noms de produits | (productname) | [Array] Cette liste remplace la variable _cprodname. |
Liste des codes SKU des articles | (sku) | [Array] Cette liste remplace la variable _csku. |
- Cliquez sur Terminer et vous êtes renvoyé au Tableau de bord des balises.
Publier le SDK Web Rokt pour Tealium
- Depuis le tableau de bord des balises, cliquez sur Enregistrer/Publier.
- Entrez un Titre (obligatoire).
- Entrez des Notes de version (obligatoire).
- Sélectionnez où vous souhaitez publier, Dev et/ou QA et/ou Prod.
- Cliquez sur Publier.
Connectez-vous à l'API d'événements Rokt pour Tealium
Informations sur l'API
Ce connecteur utilise l'API suivante :
Informations sur l'API | |
---|---|
Nom de l'API | Rokt API |
Version de l'API | 2020-05-21 |
Point de terminaison de l'API | https://api.rokt.com |
Documentation | ROKT Event API |
Limites de lot
Ce connecteur utilise des requêtes groupées pour prendre en charge les transferts de données à haut volume vers le fournisseur. Les requêtes sont mises en file d'attente jusqu'à ce que l'un des trois seuils suivants soit atteint :
Paramètre de requête | Seuil |
---|---|
Nombre maximal de requêtes | 100 |
Temps maximal depuis la plus ancienne requête | 10 minutes |
Taille maximale des requêtes | 1 Mo |
Actions du connecteur
NOM DE L'ACTION | AUDIENCESTREAM | EVENTSTREAM |
---|---|---|
Envoyer une conversion | ✓ | ✓ |
Ajouter la connexion à Rokt
- Connectez-vous à Tealium Customer Data Hub et cliquez sur Event Stream > Event Connectors.
- Cliquez sur Ajouter un connecteur.
- Recherchez et sélectionnez le connecteur Rokt.
- Cliquez sur Continuer.
- La source de données et le flux d'événements sont automatiquement sélectionnés pour vous. Cliquez sur Continuer.
- Cliquez sur Ajouter un connecteur.
- Remplissez les champs suivants :
- Nom : Donnez un nom au connecteur.
- Notes : Ajoutez des notes si nécessaire.
- ID client : Entrez votre ID d'application. Cliquez pour obtenir des informations sur la façon de générer votre ID d'application et votre secret.
- Secret client : Entrez votre secret d'application.
- ID de compte : Entrez l'ID de compte Rokt fourni par votre gestionnaire de compte.
- Cliquez sur Terminé.
- Cliquez sur Continuer.
- Entrez un nom pour l'action, puis sélectionnez le type d'action dans le menu déroulant.
Action — Envoyer la conversion
PARAMÈTRE | DESCRIPTION |
---|---|
Type d'événement | (Obligatoire) Type d'événement. |
ID de l'événement | Identifiant utilisé pour identifier de manière unique un événement. |
Heure de l'événement | Heure de l'événement en UTC. |
Email transmis en texte brut, en minuscules et sans espaces superflus. | |
Email - emailsha256 (déjà haché en SHA256) | Hachage SHA-256 de l'adresse e-mail, déjà haché. |
Email - emailsha256 (appliquer le hachage SHA256) | Hachage SHA-256 de l'adresse e-mail. Tealium effectuera le hachage. |
ID de suivi Rokt | ID généré par Rokt utilisé pour faire correspondre les événements de conversion au clic d'origine. |
Montant de la conversion | Montant de la transaction. |
Code de devise | Code de devise. |
Quantité | La quantité (entier) de l'article dans la conversion spécifique. |
Type de conversion | Utilisé pour différencier entre différents événements de conversion. |
Noms des produits | Le nom du/des produit(s) acheté(s). |
SKU des produits | L'identifiant du produit acheté (Note : n'accepte qu'un seul SKU). |
Type de paiement | Le mode de paiement utilisé lors de la transaction. |
BIN de la carte de crédit | BIN de la carte de crédit du paiement de conversion. |
Marge | Marge bénéficiaire de la conversion. |
ID de transaction | ID de transaction, utilisé pour identifier une transaction unique. |
ID de référence de confirmation | ID de référence de confirmation. |
Prénom du client | Prénom du client. |
Prénom du client (déjà haché en SHA256) | Hachage SHA-256 du prénom, déjà haché. |
Prénom du client (appliquer le hachage SHA256) | Hachage SHA-256 du prénom. Tealium effectuera le hachage. |
Nom de famille du client | Nom de famille du client. |
Nom de famille du client (déjà haché en SHA256) | Hachage SHA-256 du nom de famille, déjà haché. |
Nom de famille du client (appliquer le hachage SHA256) | Hachage SHA-256 du nom de famille. Tealium effectuera le hachage. |
Numéro de téléphone portable | Numéro de téléphone portable du client convertissant. |
Numéro de téléphone portable (déjà haché en SHA256) | Hachage SHA-256 du numéro de téléphone, déjà haché. |
Numéro de téléphone portable (appliquer le hachage SHA256) | Hachage SHA-256 du numéro de téléphone. Tealium effectuera le hachage. |
Adresse IP du client | Adresse IP du client. |
Adresse IP du client (déjà hachée en SHA256) | Hachage SHA-256 de l'adresse IP du client, déjà hachée. |
Adresse IP du client (appliquer le hachage SHA256) | Hachage SHA-256 de l'adresse IP du client. Tealium pour hacher. |
Agent utilisateur | Agent utilisateur du navigateur du client converti. |
Type d'appareil | Type d'appareil. |
Système d'exploitation de l'appareil | Système d'exploitation de l'appareil. |
Version du système d'exploitation | Version du système d'exploitation. |
Navigateur | Navigateur. |
Version du navigateur | Version du navigateur. |
Titre du client | Titre du client. |
Genre du client | Genre du client. |
Date de naissance du client | Au format yyyymmdd. |
Âge du client | Âge du client. |
Langue | Langue associée à l'achat. |
Numéro d'unité | Numéro d'unité associé à l'adresse. |
Adresse 1 | Première ligne de l'adresse de rue. |
Adresse 2 | Deuxième ligne de l'adresse de rue. |
Code postal du client | Code postal du client. |
Ville du client | Ville du client. |
État du client | État du client. |
Pays du client | Pays du client. |
Métadonnées | Informations non critiques pour l'entreprise sur l'événement. |
- Complétez les sections Données de conversion et Métadonnées selon les besoins. Consultez POST Events pour plus d'informations.
- Cliquez sur Terminer.
- Cliquez sur Enregistrer et publier.
- Donnez un Titre et une Description à votre connecteur.
- Cliquez sur OK.