Aller au contenu principal

Accéder aux données de recommandation

Vous pouvez toujours accéder à vos données de

referral
Referral

A positive outcome of a customer's interaction with an offer. For example, the customer opts in to subscribing to an email list, downloading a mobile app, or being directed to a website.
via Rokt de la manière qui vous convient le mieux, à vous et à votre entreprise. Les options incluent notamment :

  1. Via API.
  2. Via SFTP.
  3. Via Email.
  4. Via Mailchimp.
  5. Manuellement.

Métadonnées

Le tableau suivant contient une liste des attributs de données accessibles (si disponibles et demandés par un annonceur), une fois que les clients s'inscrivent à une campagne pour les deux types de campagnes de Rokt. Rappelez-vous, les annonceurs n'ont accès à aucune donnée des partenaires dans aucune circonstance.

remarque

La liste des attributs disponibles peut varier en fonction du site partenaire où l'offre a été affichée.

AttributFormat des donnéesDescriptionValeur d'exemple
Code postalEntierLe code postal du client10010
PaysTexteLe pays du clientAustralia
GenreTexteLe genre du clientMale
ÂgeEntierL'âge du client25
Date/heureDate/HeureLa date et l'heure à laquelle le client s'est inscrit à l'offre43765.07083
ÉtatTexteL'état du clientCA
BanlieueTexteLa ville du clientSeattle
Prix de l'offreNombre décimalLe montant facturé au client pour le parrainage2.50
Date de naissanceDate/HeureLa date de naissance du client33569
Réponse à la publicitéTexteLe texte de réponse positive sur lequel le client a cliqué pour accepter l'offreYes, please
Texte de l'annonceTexteLe texte de l'offre présenté au clientReceive a call today to hear about our great value.
Texte de l'annonce (HTML)TexteLe texte de l'offre au format HTML<p>Receive a call today to hear about our great value.<p>
ID d'audienceEntierIdentifiant interne Rokt pour l'audience à laquelle le client faisait partie
La longueur et le format de cet identifiant peuvent changer.
2581697744617019994
Nom de l'audienceTexteLe nom de l'audience à laquelle appartient le clientM/F: 25+
NavigateurTexteLe navigateur du clientChrome Mobile
Version du navigateurEntierLa version du navigateur du client (version majeure)52
Version complète du navigateurNombre décimalLa version du navigateur du client (incluant les informations de version majeure et mineure)52.109
ID de campagneEntierIdentifiant interne Rokt pour l'offre que le client a acceptée.
La longueur et le format de cet identifiant peuvent changer.
1112223334445556667
Nom de la campagneTexteLe nom de l'offre que le client a acceptéeBrand name, Rokt, Hybrid, 2019
Code du paysTexteLe pays du client (au format ISO à deux chiffres)AU
Code couponTexteLe code coupon émis au client (applicable seulement si la campagne contient des coupons)ROKT1234
ID CréatifEntierIdentifiant interne de Rokt pour le créatif auquel le client a opté.
La longueur et le format de cet ID sont susceptibles de changer.
2.26E+18
Date/heure (UTC)Date/HeureLa date et l'heure à laquelle le client a opté pour l'offre (fuseau horaire UTC)43765.2375
AppareilTexteLa plateforme de l'appareil du client quand il a opté pour l'offreMobile
Fabricant de l'appareilTexteLe fabricant de l'appareil utilisé par le client lorsqu'il a opté pour l'offre.
Applicables uniquement lorsque Appareil est Mobile.
Samsung
EnvironnementTexteL'environnement sur lequel le widget du partenaire a été affichéPurchase
ExpérienceTexteL'expérience sur laquelle le widget du partenaire a été affichéOverlay
PlacementTexteLe placement de l'offre à laquelle le client a optéPrime
Type de référentTexteLe type de référent de l'offre à laquelle le client a optéEmail
Identifiant RoktTexteIdentifiant interne de Rokt pour un référent spécifique.
La longueur et le format de cet ID sont susceptibles de changer.
aa169abb-6552-3638-82b1-224b389fce5b

Modèles d'exportation de parrainage et champs personnalisés

remarque

Cette option est uniquement disponible pour une utilisation avec l'option d'exportation parrainage par e-mail et SFTP.

Vous pouvez créer et gérer des modèles pour les exportations de parrainage en utilisant les instructions suivantes :

Créer un modèle

  1. Allez à la page Campagnes > Données client depuis le menu de navigation de gauche, et assurez-vous d'être sur l'onglet Parrainages.

  2. Dans le menu déroulant Modèle, sélectionnez Créer un modèle personnalisé.

Création de Modèle

  1. Entrez un nom pour votre modèle personnalisé.

Création de Modèle

  1. Sélectionnez les champs requis pour votre modèle.

Création de Modèle

  1. Réorganisez vos champs dans votre modèle comme souhaité.

Création de Modèle

  1. Cliquez sur Enregistrer.

Création de Modèle

  1. Sélectionnez votre nouveau modèle personnalisé dans le menu déroulant des modèles.

Création de Modèle

Modifier un modèle

  1. Sélectionnez le modèle personnalisé que vous souhaitez modifier.

    Template Editing

  2. Cliquez sur Modifier le modèle existant.

    Template Editing

  3. Ajoutez ou supprimez des champs à votre modèle personnalisé existant.

    Template Editing

  4. Réorganisez vos champs dans votre modèle dans l'ordre souhaité.

    Template Editing

  5. Cliquez sur Enregistrer.

    Template Editing

  6. Sélectionnez votre nouveau modèle personnalisé dans le menu déroulant des modèles.

    Template Editing

Champs personnalisés

Pour créer un champ personnalisé pour les exports de parrainage, vous devez :

  1. À partir du menu de navigation de gauche, allez dans Campaigns > Customer Data, et assurez-vous d'être sur l'onglet Referrals.

  2. Cliquez sur Personnaliser les champs.

  3. Cliquez sur Nouveau champ personnalisé.

  4. Sélectionnez un champ à transformer et entrez un nom pour votre champ personnalisé.

  5. Sélectionnez une condition : égale ou contient.

  6. Entrez la valeur que vous souhaitez mapper et le nouveau nom du champ.

  7. Sélectionnez comment le champ personnalisé doit être géré s'il est vide.

  8. Sélectionnez la valeur par défaut au cas où aucune correspondance ne serait trouvée.

  9. Cliquez sur Enregistrer.

Via API

Notre plateforme de gestion des données vous offre la possibilité d'accéder de manière sécurisée aux données de recommandation pour vos campagnes. L'une des options populaires est l'intégration directe avec votre CRM via API.

Une API est le moyen le plus efficace pour que Rokt vous livre 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 communiquer la piste. Il y a quelques éléments techniques nécessaires pour compléter cela, qui sont expliqués 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 :

  1. Documentation complète de l'API sur la façon de créer des abonnés dans votre système.
  2. Coordonnées techniques pour aider à résoudre les problèmes de configuration.
  3. Points de terminaison pour tous les environnements pertinents (production, test, préproduction, etc.).
  4. Méthode (ex. : GET, POST, PUT)
  5. Authentification (si nécessaire)
  6. Encodage du corps de la requête (ex. : JSON, XML, URL Encodé)
  7. Paramètres API requis (Découvrez quels attributs Rokt peut partager).
  8. Réponses API attendues pour aider Rokt à catégoriser avec précision les pistes correctement livrées par rapport à celles rejetées.

Documentation de l'API

La documentation de l'API peut inclure certains ou tous les points listés comme exigences tels que :

  • Point de terminaison
  • Méthode
  • Corps

Cela devrait détailler exactement comment Rokt peut acheminer des prospects vers votre système.

La documentation de l'API ainsi que le contact technique devraient être suffisants pour commencer le processus de configuration de l'API.

Pour un bon exemple de documentation d'API, consultez la documentation de l'API Mailchimp.

Coordonnées 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 questions concernant le processus de configuration de l'API.

Le contact technique devrait pouvoir aider avec :

  • Vérification que les prospects de test ont été enregistrés avec succès dans votre système
  • Explication de la raison pour laquelle nous recevons un statut de réponse de 403

Par exemple :

John Smith

Support Technique

john.smith@company.com

Point de terminaison

C'est l'emplacement où Rokt doit livrer les données. Si vous avez un point de terminaison de mise en scène ou de test, cela aidera l'équipe Rokt pendant le processus de configuration et de test afin qu'aucun prospect de test ne soit livré à votre CRM en direct.

Par exemple : https://us9.api.mailchimp.com/3.0/lists/abcdefghij/members

Méthode

C'est le type de requête HTTP que Rokt utilise pour livrer des données à votre liste. La majorité 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 pourrait prendre plusieurs formes, telles que :

  • Combinaison de nom d'utilisateur et mot de passe
  • Une clé API
  • ID client et secret

Paramètres de l'API

Fournissez une liste de paramètres pour que Rokt les inclue dans chaque requête API. Si possible, précisez les :

  • Attributs requis (attributs qui doivent être envoyés pour que la requête réussisse)
  • Attributs optionnels
  • Noms de paramètres pour chaque attribut (si l'on doit utiliser firstname, FirstName ou first-name, par exemple)

Les attributs courants incluent :

  • Email
  • 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
  • Encodé URL
  • Texte brut
  • XML

Réponses API attendues

En fournissant une liste de réponses API possibles, Rokt peut configurer une logique de gestion des réponses pour identifier rapidement les prospects qui ont été livrés avec succès, par opposition à ceux qui n'ont pas réussi à livrer ou qui ont été étiquetés comme doublons.

La gestion des réponses pourrait être créée en fonction du code de statut que nous recevons ou du corps de la réponse, selon la configuration de votre API.

Exemples de codes de statut :

  • 201 (prospect créé avec succès)
  • 400 (non autorisé)
  • 500 (erreur serveur)

Exemples de valeurs du corps de la réponse :

  • "successfully delivered"
  • {"status": "duplicate"}
  • {"success": false}
attention

Travaillez avec votre responsable de compte Rokt pour compléter le processus de configuration de l'API décrit ci-dessous.

Configuration de la connexion API

  1. Connectez-vous à One Platform, et cliquez sur votre compte sur la page d'accueil.

  2. Rendez-vous sur la page Integrations > Connections dans le menu de navigation à gauche.

  3. Cliquez sur Add connection.

  4. Sous Referrals, cliquez sur API.

    Referral Export via API

  5. Donnez un nom à votre connexion.

    Referral Export via API

  6. Entrez le point de terminaison pour votre connexion.

    Referral Export via API

  7. Entrez toutes les informations requises sous Authorization, Headers, et Body.

    Referral Export via API

  8. Entrez toutes vos règles de Response handling.

    Referral Export via API

Tester votre connexion API

  1. Une fois votre connexion API configurée (endpoint, autorisation, en-têtes, corps et gestion des réponses), cliquez sur Paramètres.

    Exportation de références via API

  2. Modifiez les paramètres de test selon vos critères de test.

    Exportation de références via API

  3. Cliquez sur Enregistrer.

  4. Cliquez sur Tester.

    Exportation de références via API

  5. Vérifiez votre résultat de test.

  6. Répétez les tests jusqu'à ce que vous ayez atteint le résultat souhaité.

Lier des campagnes à votre connexion API

  1. Allez à la page Référence en temps réel.

  2. Développez la connexion à laquelle vous souhaitez lier une campagne.

    Exportation de références via API

  3. Cliquez sur Afficher non lié.

    Exportation de références via API

  4. Trouvez la campagne que vous souhaitez lier à votre connexion et cliquez sur Lier.

    Exportation de références via API

  5. La campagne est maintenant liée à votre connexion.

    Exportation de références via API

Dissocier les campagnes de votre connexion API

  1. Allez à la page Référencement en temps réel.

  2. Développez la connexion à laquelle vous souhaitez associer une campagne.

    Exportation de parrainage via API

  3. Trouvez la campagne que vous souhaitez dissocier de votre connexion et cliquez sur Dissocier.

    Exportation de parrainage via API

  4. Cliquez sur Afficher les campagnes dissociées.

    Exportation de parrainage via API

  5. Confirmez que votre campagne est maintenant dissociée de votre connexion.

    Exportation de parrainage via API

Via SFTP

Les connexions Secure File Transfer Protocol (FTP) vous permettent d'automatiser vos livraisons de parrainage et nécessitent peu d'efforts pour être configurées. 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 recevoir régulièrement un e-mail contenant un fichier .csv avec tous vos nouveaux parrainages et les métadonnées associées.

Vous pouvez soit utiliser votre propre connexion SFTP, soit celle 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 responsable de compte pour obtenir l'accès.

Vous devriez également avoir les informations suivantes prêtes avant de configurer votre connexion au SFTP de Rokt :

  1. Fréquence de livraison : à quelle fréquence et à quels moments les références doivent être téléchargées sur le serveur SFTP.
  2. Paramètres requis : les plus courants étant l'email, 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.

  1. Dans votre navigateur, accédez à https://filezilla-project.org/ et cliquez sur Download FileZilla Client.
  2. Installez FileZilla sur votre ordinateur. Si vous avez déjà installé FileZilla, assurez-vous de disposer de la dernière version.
  3. Contactez votre responsable de compte Rokt pour demander l'accès au SFTP de Rokt. Une fois l'accès accordé, vous devriez recevoir un email de Rokt avec le sujet "Vous avez reçu l'accès au serveur SFTP de Rokt."
  4. Téléchargez le fichier joint et dézippez le fichier crypté en utilisant le mot de passe fourni dans un second email "Email pour le mot de passe du fichier avec instructions."
  5. Le fichier crypté que vous venez de dézipper contient un fichier .pem qui est votre fichier clé pour accéder au dossier SFTP de Rokt.
remarque

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.

  1. Ouvrez FileZilla et accédez à Fichier > Gestionnaire de sites

Rokt SFTP Setup

  1. À gauche, cliquez sur New Site et remplissez les informations suivantes :
  • Protocole : SFTP – SSH File Transfer Protocol

  • Hôte : ftp.rokt.com

  • Port : 22

  • Fichier clé : Parcourez votre fichier clé local (.pem) et sélectionnez-le depuis votre lecteur local (voir image ci-dessous).

    Rokt SFTP Setup

  1. Cliquez sur Connecter. Vous devriez être connecté et able voir vos dossiers accessibles pour télécharger des fichiers.

Chemin d'accès et exigences

Les fichiers de recommandation sont placés dans le chemin d'accès suivant :

Chemin d'accèsObjectif
/downloadsTélécharger les données de recommandation fournies par Rokt
remarque

Les fichiers de recommandation sont automatiquement supprimés de ce dossier après 14 jours.

Utiliser votre propre connexion SFTP

Établir la connexion

  1. Connectez-vous à One Platform, puis cliquez sur votre compte sur la page d'accueil.

  2. Allez à la page Integrations > Connections depuis le menu de navigation à gauche.

  3. Cliquez sur Ajouter une connexion.

  4. Sous Referrals, sélectionnez FTP.

  5. Sélectionnez la Campagne et le Modèle pour cette connexion, puis donnez un nom à votre connexion.

    Exportation de recommandation via le SFTP Client

  6. Entrez Répertoire et nom de fichier.

    Exportation de recommandation via le SFTP Client

  7. Entrez les détails de l'hôte de votre serveur FTP et le port.

    Exportation de recommandation via le SFTP Client

  8. Sélectionnez votre méthode FTP désirée.

    Exportation de recommandation via le SFTP Client

  9. Entrez votre Nom d'utilisateur et Mot de passe, ou entrez votre nom d'utilisateur et téléchargez votre fichier clé si vous utilisez le SFTP.

    Exportation de recommandation via le SFTP Client

  10. Sélectionnez votre calendrier et cliquez sur Enregistrer.

Exportation de recommandation via le SFTP Client 11. Votre connexion a été créée.

Désactivation de votre connexion FTP

  1. Allez dans l'onglet Connexions et sélectionnez Planifié dans le menu déroulant le plus à gauche.

    Referral Export Via Client SFTP

  2. Sous Actions, cliquez sur l'icône de pause.

    Referral Export Via Client SFTP

  3. Votre connexion est désactivée.

    Referral Export Via Client SFTP

  4. Vous pouvez inverser ces étapes pour réactiver votre connexion.

Par email

Rokt peut programmer la livraison de fichiers de parrainage (au format .csv) à vous par email. Bien que cette méthode soit moins sécurisée et nécessite un traitement manuel pour télécharger les fichiers depuis votre compte email, elle peut être un moyen utile pour commencer à obtenir des données de parrainage de One Platform. Vous pouvez toujours passer à une solution SFTP ou API à l'avenir.

Avant de commencer

Une configuration de livraison par email nécessite uniquement les informations suivantes :

  1. Adresse email (ou une liste de plusieurs adresses email) où les parrainages doivent être envoyés.
  2. Fréquence de livraison—qui précise à quelle fréquence et à quels moments vous souhaitez recevoir les emails de parrainage.
  3. Paramètres requis—les plus courants étant l'email, 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 e-mail

  1. Accédez à votre compte dans One Platform.

  2. Allez à Intégrations > Connexions dans la navigation de gauche.

  3. Cliquez sur Ajouter une connexion.

  4. Sous Références, cliquez sur E-mail.

  5. Sélectionnez la campagne et le modèle pour cette connexion.

Exportation de Références par E-mail

  1. Donnez un nom à votre connexion et cliquez sur Suivant.

Exportation de Références par E-mail

  1. Entrez les adresses e-mail de destination et cliquez sur Suivant.

Exportation de Références par E-mail

  1. Sélectionnez l'horaire souhaité et cliquez sur Enregistrer pour créer votre connexion e-mail.

Exportation de Références par E-mail

  1. Votre connexion e-mail a été créée pour la campagne liée.

Exportation de Références par E-mail

Désactivation d'une connexion e-mail

  1. Dans le menu de navigation à gauche, allez à la page Intégrations > Connexions et sélectionnez Programmé dans le menu déroulant.

    Referral Export via Email

  2. Cliquez sur l'icône pause.

Referral Export via Email 3. Votre connexion e-mail est désactivée.

Referral Export via Email

  1. Vous pouvez inverser ces étapes pour réactiver votre connexion.

Via Mailchimp

Vous pouvez intégrer Rokt avec Mailchimp, un fournisseur de services de messagerie et une plateforme d'automatisation du marketing spécialisée dans les entreprises de commerce électronique. Cela permet de garder les données CRM de Mailchimp aussi à jour que possible (Rokt poste de nouvelles recommandations toutes les cinq minutes), vous permettant ainsi de consacrer plus d'énergie à la stratégie de vos campagnes et moins à leur gestion.

remarque

Une configuration de l'API plus complexe est disponible sous l'option API sur la page Connexions. Vous serez toujours tenu de configurer une tâche de livraison de recommandations en plus de la configuration de l'API. Trouvez les instructions ici. Il y a une configuration distincte pour l'import des listes d'audience personnalisées via Mailchimp que vous pouvez trouver ici.

Récupérer les clés API depuis Mailchimp

  1. Connectez-vous à votre compte Mailchimp. Cliquez sur votre nom dans le coin supérieur droit. Dans le menu déroulant, choisissez Profile.

    Referral Export via Mailchimp

  2. Allez dans le menu déroulant Extras et choisissez API keys.

    Referral Export via Mailchimp

  3. Vous pouvez soit utiliser une clé API que vous avez déjà créée, soit en créer une nouvelle en cliquant sur Create a key.

    Referral Export via Mailchimp

    • Notez la clé API que Mailchimp a générée pour vous.
  4. 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 recommandations sur une période donnée, ou si vous avez besoin de réaliser des dépannages ponctuels.

Si quelque chose ne fonctionne pas avec une connexion existante, comme une panne API ou un email qui a été supprimé, 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 au sein de la plateforme Rokt est simple et directe :

  1. Informez votre gestionnaire de compte que vous souhaitez y accéder, et il vous enverra une invitation à votre adresse email.
  2. Connectez-vous à la plateforme et cliquez sur votre compte sur la page d'accueil.
  3. Allez dans Campaigns > Customer Data dans le menu de navigation de gauche.
  4. Dans l'onglet Referrals, sélectionnez tous les filtres tels que la période, les campagnes, ou les attributs de données que vous souhaitez afficher.
  5. Téléchargez les données en cliquant sur Export. Vous pouvez également sélectionner Export Via Email si vous ne voulez pas attendre que le fichier de recommandation soit téléchargé. Rokt vous enverra un fichier .csv par email une fois terminé.

Referral Export Manually

remarque

Un maximum de 100 000 enregistrements peuvent être téléchargés à la fois.

Cet article vous a-t-il été utile ?