Accéder aux données de parrainage
Vous pouvez toujours accéder à vos données de
Un résultat positif de l'interaction d'un client avec une offre. Par exemple, le client s'inscrit pour s'abonner à une liste de diffusion par e-mail, télécharger une application mobile ou être redirigé vers un site Web.
Métadonnées
Le tableau suivant contient une liste d'attributs de données accessibles (si disponibles et demandés par un annonceur), une fois que les clients ont opté pour une campagne pour les deux types de campagnes de Rokt. N'oubliez pas que les annonceurs n'ont pas accès à des données partenaires dans toutes les circonstances.
La liste des attributs disponibles peut varier en fonction du site partenaire où l'offre a été affichée.
Attribut | Format de données | Description | Valeur d'exemple |
---|---|---|---|
Code postal | Entier | Le code postal du client | 10010 |
Pays | Texte | Le pays du client | Australie |
Genre | Texte | Le genre du client | Homme |
Âge | Entier | L'âge du client | 25 |
Date/heure | Date/Heure | La date et l'heure auxquelles le client a opté pour l'offre | 43765.07083 |
État | Texte | L'état du client | CA |
Banlieue | Texte | La ville du client | Seattle |
Prix d'enchère | Décimal | Le montant facturé au client pour la recommandation | 2.50 |
Date de naissance | Date/Heure | La date de naissance du client | 33569 |
Réponse à l'annonce | Texte | Le texte de réponse positive sur lequel le client a cliqué pour accepter l'offre | Oui, s'il vous plaît |
Texte de l'annonce | Texte | Le texte de l'offre présentée au client | Recevez un appel aujourd'hui pour découvrir notre offre exceptionnelle. |
Texte de l'annonce (HTML) | Texte | Le texte de l'offre au format HTML | <p>Recevez un appel aujourd'hui pour découvrir notre offre exceptionnelle.<p> |
ID de l'audience | Entier | Identifiant interne de Rokt pour l'audience à laquelle le client appartenait La longueur et le format de cet ID peuvent changer. | 2581697744617019994 |
Nom de l'audience | Texte | Le nom de l'audience à laquelle le client appartient | M/F: 25+ |
Navigateur | Texte | Le navigateur du client | Chrome Mobile |
Version du navigateur | Entier | La version du navigateur du client (version majeure) | 52 |
Version complète du navigateur | Décimal | La version complète du navigateur du client (incluant les informations majeures et mineures) | 52.109 |
ID de la campagne | Entier | Identifiant interne de Rokt pour l'offre à laquelle le client a adhéré. La longueur et le format de cet ID peuvent changer. | 1112223334445556667 |
Nom de la campagne | Texte | Le nom de l'offre à laquelle le client a adhéré | Nom de la marque, Rokt, Hybrid, 2019 |
Code pays | Texte | Le pays du client (au format ISO à deux chiffres) | AU |
Code de coupon | Texte | Le code de coupon attribué au client (uniquement applicable si la campagne contenait des coupons) | ROKT1234 |
ID de création | Entier | Identifiant interne de Rokt pour la création à laquelle le client a adhéré. La longueur et le format de cet ID sont sujets à modification. | 2.26E+18 |
Date/heure (UTC) | Date/Heure | La date et l'heure auxquelles le client a adhéré à l'offre (fuseau horaire UTC) | 43765.2375 |
Appareil | Texte | La plateforme de l'appareil utilisée par le client lorsqu'il a adhéré à l'offre | Mobile |
Fabricant de l'appareil | Texte | Le fabricant de l'appareil utilisé par le client lorsqu'il a adhéré à l'offre. Uniquement applicable lorsque Appareil est Mobile. | Samsung |
Environnement | Texte | L'environnement dans lequel le widget du partenaire a été affiché | Purchase |
Expérience | Texte | L'expérience sur laquelle le widget du partenaire a été affiché | Overlay |
Placement | Texte | L'emplacement de l'offre à laquelle le client a adhéré | Prime |
Type de parrainage | Texte | Le type de parrainage de l'offre à laquelle le client a adhéré | Email |
Identifiant Rokt | Texte | Identifiant interne de Rokt pour un parrainage spécifique. La longueur et le format de cet ID sont sujets à modification. | aa169abb-6552-3638-82b1-224b389fce5b |
Modèles d'exportation de parrainage et champs personnalisés
Cette option est uniquement disponible en combinaison avec l'option d'exportation de parrainage par e-mail et SFTP.
Vous pouvez créer et gérer des modèles pour les exportations de parrainage en suivant les instructions suivantes :
Créer un modèle
Accédez à la page Campagnes > Données client dans le menu de navigation de gauche, et assurez-vous d'être sur l'onglet Parrainages.
Dans le menu déroulant Modèle, sélectionnez Créer un modèle personnalisé.
- Entrez un nom pour votre modèle personnalisé.
- Sélectionnez les champs requis pour votre modèle.
- Réorganisez les champs de votre modèle selon vos souhaits.
- Cliquez sur Enregistrer.
- Sélectionnez votre nouveau modèle personnalisé dans le menu déroulant des modèles.
Modifier un modèle
Sélectionnez le modèle personnalisé que vous souhaitez modifier.
Cliquez sur Modifier un modèle existant.
Ajoutez ou supprimez des champs à votre modèle personnalisé existant.
Réorganisez les champs de votre modèle dans l'ordre souhaité.
Cliquez sur Enregistrer.
Sélectionnez votre nouveau modèle personnalisé dans la liste déroulante des modèles.
Champs personnalisés
Pour créer un champ personnalisé pour les exportations de recommandations, vous devez :
Dans le menu de navigation de gauche, allez sur Campagnes > Données clients, et assurez-vous d'être sur l'onglet Recommandations.
Cliquez sur Personnaliser les champs.
Cliquez sur Nouveau champ personnalisé.
Sélectionnez un champ à transformer et entrez un nom pour votre champ personnalisé.
Sélectionnez une condition : égal à ou contient.
Entrez la valeur que vous souhaitez mapper et le nouveau nom du champ.
Sélectionnez comment le champ personnalisé doit être géré s'il est vide.
Sélectionnez la valeur par défaut en cas de non correspondance.
Cliquez sur Enregistrer.
Via API
Notre plateforme de gestion des données offre la possibilité d'accéder en toute sécurité aux données de recommandation pour vos campagnes. L'une des options populaires est l'intégration directe avec votre CRM via une API.
Une API est le moyen le plus efficace pour Rokt de vous fournir les données de recommandation. Cela fonctionne en temps réel, ce qui signifie que dès qu'une recommandation est générée pour votre campagne, Rokt peut vous transmettre le lead. Il y a quelques éléments techniques nécessaires pour mener à bien cette intégration, qui sont décrits ci-dessous.
Exigences
Pour commencer la configuration de l'API, Rokt a besoin de quelques informations.
Les détails suivants doivent être envoyés à votre gestionnaire de compte:
- Documentation API complète sur la façon de créer des abonnés dans votre système.
- Coordonnées du contact technique pour aider à résoudre les problèmes de configuration.
- Points de terminaison pour tous les environnements pertinents (production, test, mise en scène, etc.).
- Méthode (par exemple, GET, POST, PUT)
- Authentification (le cas échéant)
- Encodage du corps de la requête (par exemple, JSON, XML, URL Encoded)
- Paramètres API requis (Découvrez quels attributs Rokt peut partager).
- Réponses API attendues pour aider Rokt à catégoriser avec précision les leads livrés avec succès par rapport à ceux qui ont été rejetés.
Documentation de l'API
La documentation de l'API peut inclure certains ou tous les points énumérés comme exigences, tels que:
- Point de terminaison
- Méthode
- Corps
Cela devrait détailler exactement comment Rokt peut fournir des leads à votre système.
La documentation de l'API ainsi qu'un contact technique devraient être suffisants pour démarrer le processus de configuration de l'API.
Pour un bon exemple de documentation de l'API, consultez la documentation de l'API Mailchimp.
Détails du contact technique
Fournissez le contact pertinent (vous-même ou quelqu'un d'autre de votre équipe) qui est le mieux placé pour répondre à toutes les questions sur le processus de configuration de l'API.
Le contact technique devrait pouvoir aider avec:
- Vérifier que les leads de test ont été enregistrés avec succès dans votre système
- Expliquer pourquoi nous recevons un statut de réponse 403
Par exemple:
John Smith
Support technique
Endpoint
Ceci est l'emplacement où Rokt doit livrer les données. Si vous avez un endpoint de staging ou de test, cela aidera l'équipe Rokt pendant la configuration et le processus de test afin de ne pas livrer de leads de test à votre CRM en direct.
Par exemple:
https://us9.api.mailchimp.com/3.0/lists/abcdefghij/members
Méthode
Ceci est le type de requête HTTP que Rokt utilise pour livrer les données à votre liste. La plupart du temps, il s'agit d'une requête POST.
Rokt prend en charge les méthodes de soumission suivantes:
- GET
- POST
- PUT
Authentification
Fournissez tous les détails d'authentification nécessaires pour que Rokt puisse appeler votre API. Cela peut prendre différentes formes, telles que :
- Nom d'utilisateur et mot de passe
- Une clé d'API
- Identifiant client et secret
Paramètres de l'API
Fournissez une liste de paramètres à inclure dans chaque requête API pour Rokt. Si possible, précisez les éléments suivants :
- Attributs requis (attributs qui doivent être envoyés pour que la requête réussisse)
- Attributs optionnels
- Noms de paramètres pour chaque attribut (par exemple, utiliser
firstname
,FirstName
oufirst-name
)
Les attributs courants incluent :
- Prénom
- Nom de famille
- Source
- Pays
Pour référence, Rokt peut partager n'importe lequel de ces attributs.
Rokt prend en charge les encodages de corps suivants :
- JSON
- Encodage URL
- Texte brut
- XML
Réponses API attendues
En fournissant une liste des réponses API possibles, Rokt peut mettre en place une logique de traitement des réponses pour identifier rapidement les leads qui ont été livrés avec succès, par rapport à ceux qui n'ont pas pu être livrés ou qui ont été étiquetés comme des doublons.
Le traitement des réponses peut être créé en fonction du code d'état que nous recevons ou du corps de la réponse, en fonction de la configuration de votre API.
Exemples de codes d'état :
- 201 (lead créé avec succès)
- 400 (non autorisé)
- 500 (erreur du serveur)
Exemples de valeurs du corps de la réponse :
"livraison réussie"
{"status": "doublon"}
{"success": false}
Travaillez avec votre responsable de compte Rokt pour finaliser le processus de configuration de l'API décrit ci-dessous.
Configuration de la connexion API
Connectez-vous à One Platform et cliquez sur votre compte sur la page d'accueil.
Accédez à la page Intégrations > Connexions dans le menu de navigation de gauche.
Cliquez sur Ajouter une connexion.
Sous Références, cliquez sur API.
Donnez un nom à votre connexion.
Entrez le point de terminaison pour votre connexion.
Entrez toutes les informations requises sous Autorisation, En-têtes et Corps.
Entrez toutes vos règles de Gestion des réponses.
Testez votre connexion API
Une fois que votre connexion API est configurée (point de terminaison, autorisation, en-têtes, corps et gestion de la réponse), cliquez sur Paramètres.
Modifiez les paramètres de test en fonction de vos critères de test.
Cliquez sur Enregistrer.
Cliquez sur Tester.
Vérifiez votre résultat de test.
Répétez les tests jusqu'à ce que vous obteniez le résultat souhaité.
Lier des campagnes à votre connexion API
Accédez à la page Référence en temps réel.
Développez la connexion à laquelle vous souhaitez lier une campagne.
Cliquez sur Afficher les non liés.
Trouvez la campagne que vous souhaitez lier à votre connexion et cliquez sur Lier.
La campagne est maintenant liée à votre connexion.
Désactiver les campagnes de votre connexion API
Accédez à la page Référence en temps réel.
Développez la connexion à laquelle vous souhaitez lier une campagne.
Trouvez la campagne que vous souhaitez désactiver de votre connexion et cliquez sur Désactiver.
Cliquez sur Afficher les désactivés.
Confirmez que votre campagne est maintenant désactivée de votre connexion.
Via SFTP
Le protocole de transfert de fichiers sécurisé (SFTP) vous permet d'automatiser vos livraisons de références et nécessite peu d'efforts à mettre en place. Tout ce dont vous avez besoin, ce sont vos identifiants SFTP, et vous êtes prêt à partir!
Une fois que vous avez configuré une connexion SFTP, vous pouvez régulièrement recevoir un e-mail contenant un fichier .csv
contenant toutes vos nouvelles références et les métadonnées associées.
Vous pouvez utiliser votre propre connexion SFTP ou la connexion de Rokt.
Connexion FTP de Rokt
Avant de commencer
Assurez-vous d'avoir accès au SFTP de Rokt. Si ce n'est pas le cas, contactez votre gestionnaire de compte pour obtenir l'accès.
Vous devez également avoir les informations suivantes prêtes avant de configurer votre connexion au SFTP de Rokt:
- Fréquence de livraison - à quelle fréquence et à quelles heures les références doivent être téléchargées sur le serveur SFTP.
- Paramètres requis - les plus courants étant l'e-mail, le prénom, le nom de famille, la source et l'état. En savoir plus sur les métadonnées que Rokt peut fournir.
Établir une connexion depuis un ordinateur hôte (par exemple, votre ordinateur portable) vers un serveur FTP sécurisé nécessite un logiciel client tiers. Ce tutoriel suggère le client populaire et gratuit FileZilla, disponible pour les systèmes d'exploitation Windows, Mac et Linux.
- Dans votre navigateur, accédez à https://filezilla-project.org/ et cliquez sur Télécharger FileZilla Client.
- Installez FileZilla sur votre ordinateur. Si vous avez déjà FileZilla installé, assurez-vous d'utiliser la dernière version.
- Contactez votre gestionnaire de compte Rokt pour demander l'accès au SFTP de Rokt. Une fois que vous aurez obtenu l'accès, vous devriez recevoir un e-mail de Rokt avec pour objet "Vous avez obtenu l'accès au serveur SFTP de Rokt."
- Téléchargez le fichier joint et décompressez le fichier chiffré à l'aide du mot de passe fourni dans un deuxième e-mail intitulé "E-mail pour le mot de passe du fichier avec les instructions."
- Le fichier chiffré que vous venez de décompresser contient un fichier
.pem
qui est votre fichier clé pour accéder au dossier SFTP de Rokt.
Les étapes suivantes sont les mêmes pour les systèmes d'exploitation Windows, Mac et Linux et sont basées sur la dernière version de FileZilla.
- Ouvrez FileZilla et accédez à
Fichier > Gestionnaire de sites
- À gauche, cliquez sur Nouveau site et remplissez les informations suivantes:
Protocole: SFTP - Protocole de transfert de fichiers SSH
Hôte: ftp.rokt.com
Port: 22
Fichier clé: Parcourez votre fichier clé local (
.pem
) et sélectionnez-le depuis votre disque local (voir l'image ci-dessous).
- Cliquez sur Connecter. Vous devriez être connecté et pouvoir voir vos dossiers accessibles pour télécharger des fichiers.
Chemin du fichier et exigences
Les fichiers de recommandation sont placés dans le chemin d'accès suivant:
Chemin d'accès | Objectif |
---|---|
/downloads | Télécharger les données de recommandation fournies par Rokt |
Les fichiers de recommandation sont automatiquement supprimés de ce dossier après 14 jours.
Utilisation de votre propre connexion SFTP
Établir la connexion
Connectez-vous à One Platform, puis cliquez sur votre compte sur la page d'accueil.
Accédez à la page Intégrations > Connexions dans le menu de navigation de gauche.
Cliquez sur Ajouter une connexion.
Sous Recommandations, sélectionnez FTP.
Sélectionnez la Campagne et le Modèle pour cette connexion, puis donnez un nom à votre connexion.
Entrez Répertoire et nom de fichier.
Entrez les détails de votre serveur FTP et le port.
Sélectionnez votre méthode FTP souhaitée.
Entrez votre Nom d'utilisateur et Mot de passe, ou entrez votre nom d'utilisateur et téléchargez votre fichier de clé si vous utilisez SFTP.
Sélectionnez votre planning et cliquez sur Enregistrer.
11. Votre connexion a été créée.
Désactiver votre connexion FTP
Allez dans l'onglet Connexions et sélectionnez Planifié dans le menu déroulant le plus à gauche.
Sous Actions, cliquez sur l'icône de pause.
Votre connexion est désactivée.
Vous pouvez inverser ces étapes pour activer votre connexion.
Via email
Rokt peut planifier la livraison des fichiers de recommandation (au format .csv
) par courrier électronique. Bien que cette méthode soit moins sécurisée et nécessite un traitement manuel pour télécharger les fichiers à partir de votre compte de messagerie, elle peut être un moyen utile de commencer à obtenir des données de recommandation à partir de la plateforme One. Vous pouvez toujours passer à une solution SFTP ou API à l'avenir.
Avant de commencer
La configuration de la livraison par courrier électronique ne nécessite que les informations suivantes :
- Adresse e-mail (ou une liste de plusieurs adresses e-mail) où les recommandations doivent être livrées.
- Fréquence de livraison - qui spécifie à quelle fréquence et à quelles heures vous souhaitez recevoir les e-mails de recommandation.
- Paramètres requis - les plus courants étant l'e-mail, le prénom, le nom de famille, la source et l'état. En savoir plus sur les attributs que Rokt peut fournir.
Configuration d'une connexion email
Accédez à votre compte sur One Platform.
Allez dans Intégrations > Connexions dans la navigation de gauche.
Cliquez sur Ajouter une connexion.
Sous Références, cliquez sur Email.
Sélectionnez la campagne et le modèle pour cette connexion.
- Donnez un nom à votre connexion et cliquez sur Suivant.
- Entrez les adresses email de destination et cliquez sur Suivant.
- Sélectionnez votre planning souhaité et cliquez sur Enregistrer pour créer votre connexion email.
- Votre connexion email a été créée pour la campagne liée.
Désactiver une connexion email
Dans le menu de navigation de gauche, accédez à la page Intégrations > Connexions et sélectionnez Planifié dans le menu déroulant.
Cliquez sur l'icône de pause.
3. Votre connexion email est désactivée.
- Vous pouvez inverser ces étapes pour activer votre connexion.
Via Mailchimp
Vous pouvez intégrer Rokt avec Mailchimp, un fournisseur de services de messagerie électronique et une plateforme d'automatisation marketing spécialisée dans les entreprises de commerce électronique. Cela permet de maintenir vos données CRM Mailchimp aussi à jour que possible (Rokt publie de nouvelles recommandations toutes les cinq minutes), afin que vous puissiez vous concentrer davantage sur la stratégie de vos campagnes et moins sur leur gestion.
Une configuration d'API plus complexe est disponible dans l'option API de la page Connections. Vous devrez toujours configurer une tâche de livraison de recommandations en plus de la configuration de l'API. Vous trouverez les instructions ici. Il existe également une configuration distincte pour l'importation de listes d'audience personnalisées via Mailchimp, que vous pouvez trouver ici.
Récupération des clés API depuis Mailchimp
Connectez-vous à votre compte Mailchimp. Cliquez sur votre nom dans le coin supérieur droit. Dans le menu déroulant, choisissez Profil.
Allez dans le menu déroulant Extras et choisissez Clés API.
Vous pouvez utiliser une clé API que vous avez déjà créée, ou en créer une nouvelle en cliquant sur Créer une clé.
- Prenez note de la clé API générée par Mailchimp pour vous.
Contactez votre gestionnaire de compte Rokt pour finaliser la configuration.
Manuellement
Vos données sont toujours accessibles sur la plateforme Rokt. Cela est utile si vous souhaitez consulter toutes vos références sur une certaine période, ou si vous avez besoin de résoudre des problèmes ponctuels.
Si quelque chose ne va pas avec une connexion existante, comme une défaillance de l'API ou la suppression d'un e-mail, ne vous inquiétez pas ! Vous pouvez toujours vous connecter à la plateforme Rokt et télécharger les données de référence pour vos campagnes.
La configuration pour accéder à vos données de référence dans la plateforme Rokt est simple et directe :
- Informez votre gestionnaire de compte que vous souhaitez y accéder, et il vous enverra une invitation à votre adresse e-mail.
- Connectez-vous à la plateforme et cliquez sur votre compte sur la page d'accueil.
- Allez dans Campagnes > Données client dans le menu de navigation de gauche.
- Sur l'onglet Références, sélectionnez les filtres tels que la plage de temps, les campagnes ou les attributs de données que vous souhaitez consulter.
- Téléchargez les données en cliquant sur Exporter. Vous pouvez également sélectionner Exporter par e-mail si vous ne souhaitez pas attendre le téléchargement du fichier de référence. Rokt vous enverra un fichier
.csv
par e-mail une fois le téléchargement terminé.
Un maximum de 100 000 enregistrements peut être téléchargé à la fois.