Aller au contenu principal

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

  1. Connectez-vous à Tealium Customer Data Hub.
  2. Cliquez sur iQ Tag Management > Tags.
  3. Cliquez sur + Ajouter un tag. Tealium_add_rokt_tag
  4. Recherchez Rokt.
  5. Cliquez sur +Ajouter. Tealium_add_rokt

Configurer le SDK Web Rokt

  1. 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.
  2. 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.

  1. Cliquez sur + Créer une règle. Tealium_create_rule
  2. 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.
  3. Cliquez sur Terminé. Tealium_load_rules
  4. 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.

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 répertoriées ci-dessous.

  1. Cliquez sur la liste déroulante et recherchez JS.
  2. Cliquez sur Utiliser une variable personnalisée. Tealium_js_emai_custom
  3. Sélectionnez Email et cliquez sur Terminé.tealium_js_email_done
  4. Ajoutez d'autres variables si nécessaire.
remarque

Les catégories Standard et Ecommerce dans Tealium correspondent à Core et Supplemental dans Rokt.

Les catégories disponibles sont :

Standard

VARIABLEDESCRIPTION
Email(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

VARIABLEATTRIBUTDESCRIPTION
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.
  1. Cliquez sur Terminer et vous êtes renvoyé au Tableau de bord des balises.

Publier le SDK Web Rokt pour Tealium

  1. Depuis le tableau de bord des balises, cliquez sur Enregistrer/Publier.
  2. Entrez un Titre (obligatoire).
  3. Entrez des Notes de version (obligatoire).
  4. Sélectionnez où vous souhaitez publier, Dev et/ou QA et/ou Prod.
  5. Cliquez sur Publier. Tealium_publish_sdk

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'APIRokt API
Version de l'API2020-05-21
Point de terminaison de l'APIhttps://api.rokt.com
DocumentationROKT 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êteSeuil
Nombre maximal de requêtes100
Temps maximal depuis la plus ancienne requête10 minutes
Taille maximale des requêtes1 Mo

Actions du connecteur

NOM DE L'ACTIONAUDIENCESTREAMEVENTSTREAM
Envoyer une conversion

Ajouter la connexion à Rokt

  1. Connectez-vous à Tealium Customer Data Hub et cliquez sur Event Stream > Event Connectors.
  2. Cliquez sur Ajouter un connecteur. Tealium_add_event_connector
  3. Recherchez et sélectionnez le connecteur Rokt. Tealium_marketplace_rokt
  4. Cliquez sur Continuer. Tealium_events_continue
  5. La source de données et le flux d'événements sont automatiquement sélectionnés pour vous. Cliquez sur Continuer.
  6. Cliquez sur Ajouter un connecteur.
  7. 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.
  8. Cliquez sur Terminé.
  9. Cliquez sur Continuer.
  10. Entrez un nom pour l'action, puis sélectionnez le type d'action dans le menu déroulant.

Action — Envoyer la conversion

PARAMÈTREDESCRIPTION
Type d'événement(Obligatoire) Type d'événement.
ID de l'événementIdentifiant utilisé pour identifier de manière unique un événement.
Heure de l'événementHeure de l'événement en UTC.
EmailEmail 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 RoktID généré par Rokt utilisé pour faire correspondre les événements de conversion au clic d'origine.
Montant de la conversionMontant de la transaction.
Code de deviseCode de devise.
QuantitéLa quantité (entier) de l'article dans la conversion spécifique.
Type de conversionUtilisé pour différencier entre différents événements de conversion.
Noms des produitsLe nom du/des produit(s) acheté(s).
SKU des produitsL'identifiant du produit acheté (Note : n'accepte qu'un seul SKU).
Type de paiementLe mode de paiement utilisé lors de la transaction.
BIN de la carte de créditBIN de la carte de crédit du paiement de conversion.
MargeMarge bénéficiaire de la conversion.
ID de transactionID de transaction, utilisé pour identifier une transaction unique.
ID de référence de confirmationID de référence de confirmation.
Prénom du clientPré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 clientNom 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 portableNumé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 clientAdresse 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 utilisateurAgent utilisateur du navigateur du client converti.
Type d'appareilType d'appareil.
Système d'exploitation de l'appareilSystème d'exploitation de l'appareil.
Version du système d'exploitationVersion du système d'exploitation.
NavigateurNavigateur.
Version du navigateurVersion du navigateur.
Titre du clientTitre du client.
Genre du clientGenre du client.
Date de naissance du clientAu format yyyymmdd.
Âge du clientÂge du client.
LangueLangue associée à l'achat.
Numéro d'unitéNuméro d'unité associé à l'adresse.
Adresse 1Première ligne de l'adresse de rue.
Adresse 2Deuxième ligne de l'adresse de rue.
Code postal du clientCode postal du client.
Ville du clientVille du client.
État du clientÉtat du client.
Pays du clientPays du client.
MétadonnéesInformations non critiques pour l'entreprise sur l'événement.
  1. Complétez les sections Données de conversion et Métadonnées selon les besoins. Consultez POST Events pour plus d'informations.
  2. Cliquez sur Terminer.
  3. Cliquez sur Enregistrer et publier.
  4. Donnez un Titre et une Description à votre connecteur.
  5. Cliquez sur OK.
Cet article vous a-t-il été utile ?