Tealium
Configuration du SDK Web Rokt pour Tealium
L'intégration de Tealium avec Rokt vous permet d'intégrer des données client et transactionnelles à l'aide de variables.
Lorsque vous ajoutez le code d'intégration à votre page, assurez-vous de remplir les données client et transactionnelles. Assurez-vous de configurer l'adresse e-mail du client afin que Rokt puisse identifier les clients et choisir une offre pertinente.
Remplissez tous les attributs de données concernant la transaction pour aider Rokt à mieux personnaliser les offres que le client voit.
Ajouter le SDK Web Rokt
- Connectez-vous au Hub de données client Tealium.
- 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 responsable de compte.
- Email à deux étapes (Optionnel) : Sélectionnez Vrai si vous souhaitez envoyer un e-mail lors d'un engagement positif.
- Utiliser Sandbox (Optionnel) : Sélectionnez Vrai si vous souhaitez envoyer des événements à un compte sandbox pour des tests.
- LOCATIONS 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 du déclenchement du tag.
- Drapeau d'envoi : Détermine si cette bibliothèque a des données de niveau événement envoyées pour le suivi.
- Type de chargement synchrone : Définit quand la bibliothèque doit être chargée de manière synchrone.
- Source de script personnalisé : Définit lorsque la bibliothèque qui prend en charge ce tag est servie depuis 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 à votre règle un nom descriptif.
- 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 responsable de compte Rokt.
- Cliquez sur Terminé.
- Cliquez sur Suivant.
Cartographie des données
La cartographie est le processus d'intégration d'une variable de couche de données avec la variable de destination correspondante de la balise fournisseur.
remarque
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 énumérées ci-dessous.
- Cliquez sur le menu déroulant et recherchez JS.
- Cliquez sur Utiliser une variable personnalisée.
- Sélectionnez Email et cliquez sur Terminé.
- Ajoutez d'autres variables si nécessaire.
remarque
Les catégories Standard et Ecommerce dans Tealium correspondent à Core et Supplémentaire dans Rokt.
Les catégories disponibles sont :
Standard
| VARIABLE | DESCRIPTION |
|---|---|
| (email) | |
| Prénom | (firstname) |
| Nom | (lastname) |
| Numéro de mobile | (mobile) |
| Code postal | (zipcode) |
| Pays | (country) |
| Langue | (language) |
| Utiliser Sandbox | (sandbox) |
Ecommerce
| VARIABLE | ATTRIBUTE | 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] Ce tableau remplace la variable _cprice. |
| Liste des quantités des articles | (quantity) | [Array] Ce tableau remplace la variable _cquan. |
| Liste des catégories majeures des articles | (majorcat) | [Array] Ce tableau remplace la variable _ccat. |
| Liste des ID de catégories majeures des articles | (majorcatid) | [Array] |
| Liste des catégories mineures des articles | (minorcat) | [Array] Ce tableau remplace la variable _ccat2. |
| Liste des ID de catégories mineures des articles | (minorcatid) | [Array] |
| Liste des noms de produits | (productname) | [Array] Ce tableau remplace la variable _cprodname. |
| Liste des SKU des articles | (sku) | [Array] Ce tableau remplace la variable _csku. |
- Cliquez sur Terminer et vous êtes renvoyé au Tableau de bord des étiquettes.
Publier le SDK Web Rokt pour Tealium
- Depuis le tableau de bord des balises, cliquez sur Enregistrer/Publicer.
- 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.
Se connecter à 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 des 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 demande | Seuil |
|---|---|
| Nombre maximum de requêtes | 100 |
| Temps maximum depuis la plus ancienne requête | 10 minutes |
| Taille maximum des requêtes | 1 Mo |
Actions de Connecteur
| NOM DE L'ACTION | AUDIENCESTREAM | EVENTSTREAM |
|---|---|---|
| Envoyer la Conversion | ✓ | ✓ |
Ajouter la connexion à Rokt
- Connectez-vous à Tealium Customer Data Hub et cliquez sur Event Stream > Event Connectors.
- Cliquez sur Add Connector.
- Recherchez et sélectionnez le connecteur Rokt.
- Cliquez sur Continue.
- La Source de Données et le Flux d'Événements sont automatiquement sélectionnés pour vous. Cliquez sur Continue.
- Cliquez sur Add Connector.
- Complétez les éléments suivants :
- Nom : Donnez un nom au connecteur.
- Notes : Ajoutez des notes si nécessaire.
- Client ID : Entrez votre ID d'Application. Cliquez pour des informations sur la façon de Générer votre ID d'Application et Secret.
- Client Secret : Entrez votre Secret d'Application.
- Account ID - Entrez l'ID de Compte Rokt fourni par votre responsable de compte.
- Cliquez sur Done.
- Cliquez sur Continue.
- 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 | (Requis) Type d'événement. |
| ID d'Événement | Un identifiant utilisé pour identifier de manière unique un événement. |
| Heure de l'Événement | Heure de l'événement en UTC. |
| Email passé en texte brut, en minuscules et sans espaces à la fin. | |
| 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 | Un ID généré par Rokt utilisé pour associer les événements de conversion au clic d'origine. |
| Montant de 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 les différents événements de conversion. |
| Noms de Produits | Le nom du(des) produit(s) acheté(s). |
| SKU de Produits | L'identifiant du produit acheté (Remarque : N'accepte qu'un seul SKU). |
| Type de Paiement | Le mode de paiement utilisé lors de la transaction. |
| BIN de Carte de Crédit | BIN de carte de crédit du paiement en 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 Mobile | Numéro de téléphone mobile du client en conversion. |
| Numéro de Téléphone Mobile (déjà haché en SHA256) | Hachage SHA-256 du numéro de téléphone, déjà haché. |
| Numéro de Téléphone Mobile (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é en SHA256) | Hachage SHA-256 de l'adresse IP du client, déjà haché. |
| Adresse IP du Client (appliquer le hachage SHA256) | Hachage SHA-256 de l'adresse IP du client. Tealium effectuera le hachage. |
| Agent Utilisateur | Agent utilisateur du navigateur du client en conversion. |
| Type d'Appareil | Type d'appareil. |
| Système d'Exploitation de l'Appareil | Système d'exploitation de l'appareil. |
| Version OS | 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. |
| Adresse 2 | Deuxième ligne de l'adresse. |
| 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 concernant l'événement. |
- Complétez les sections Données de Conversion et Métadonnées comme requis. 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.