Last updated 16 juil. 2024

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 :

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 ont opté pour une campagne pour les deux types de campagnes de Rokt. Rappelez-vous que les annonceurs n'ont accès à aucune donnée de partenaire en aucune circonstance.

remarque

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

Attribut	Format des données	Description	Valeur d'exemple
Code postal	Entier	Le code postal du client	10010
Pays	Texte	Le pays du client	Australia
Sexe	Texte	Le sexe du client	Male
Âge	Entier	L'âge du client	25
Date/heure	Date/Heure	La date et l'heure à laquelle le client a opté pour l'offre	43765.07083
État	Texte	L'état du client	CA
Banlieue	Texte	La ville du client	Seattle
Prix de l'offre	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	Yes, please
Texte de l'annonce	Texte	Le texte de l'offre présenté au client	Receive a call today to hear about our great value.
Texte de l'annonce (HTML)	Texte	Le texte de l'offre au format HTML	<p>Receive a call today to hear about our great value.<p>
ID de l'audience	Entier	Identifiant interne Rokt pour l'audience dont le client faisait partie La longueur et le format de cet ID peuvent changer.	2581697744617019994
Nom de l'audience	Texte	Le nom de l'audience à laquelle appartient le client	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 du navigateur (complète)	Décimal	La version du navigateur du client (y compris les informations de version majeure et mineure)	52.109
ID de la campagne	Entier	Identifiant interne Rokt pour l'offre à laquelle le client a souscrit. 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 souscrit	Brand name, Rokt, Hybrid, 2019
Code du pays	Texte	Le pays du client (au format ISO à deux chiffres)	AU
Code du coupon	Texte	Le code de coupon émis au client (applicable uniquement si la campagne contenait des coupons)	ROKT1234
Creative ID	Integer	Identifiant interne Rokt pour la création à laquelle le client a adhéré. La longueur et le format de cet ID sont susceptibles de changer.	2.26E+18
Date/time (UTC)	Date/Time	La date et l'heure à laquelle le client a adhéré à l'offre (fuseau horaire UTC)	43765.2375
Device	Text	La plateforme de l'appareil du client lorsqu'il a adhéré à l'offre	Mobile
Device manufacturer	Text	Le fabricant de l'appareil utilisé par le client lorsqu'il a adhéré à l'offre. Applicable uniquement lorsque Device est Mobile.	Samsung
Environment	Text	L'environnement dans lequel le widget du partenaire a été affiché	Purchase
Experience	Text	L'expérience dans laquelle le widget du partenaire a été affiché	Overlay
Placement	Text	L'emplacement de l'offre à laquelle le client a adhéré	Prime
Referral type	Text	Le type de parrainage de l'offre à laquelle le client a adhéré	Email
Rokt identifier	Text	Identifiant interne Rokt pour un parrainage 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 de parrainage par email 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 clients 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é.

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

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

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

6. Cliquez sur Enregistrer.

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

Modifier un modèle

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

   

2. Cliquez sur Modifier le modèle existant.

   

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

   

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

   

5. Cliquez sur Enregistrer.

   

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

   

Champs personnalisés

Pour créer un champ personnalisé pour les exportations de parrainages, vous devez :

1. Dans le menu de navigation de gauche, allez à Campagnes > Données clients, et assurez-vous d'être sur l'onglet Parrainages.

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 : égal à 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 en cas d'absence de correspondance.

9. Cliquez sur Enregistrer.

Via API

Notre plateforme de gestion des données vous permet 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 API.

Une API est le moyen le plus efficace pour Rokt de vous fournir des 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 le lead. Il y a quelques éléments techniques nécessaires pour compléter cela, qui sont décrits ci-dessous.

Exigences

Pour commencer la configuration de l'API, Rokt nécessite quelques informations.

Les détails suivants doivent être envoyés à votre gestionnaire de compte :

1. Documentation complète de l'API sur la création d'abonnés dans votre système.
2. Coordonnées techniques pour aider à résoudre les problèmes de configuration.
3. Endpoints pour tous les environnements pertinents (production, test, staging, etc.).
4. Méthode (par exemple, GET, POST, PUT)
5. Authentification (le cas échéant)
6. Encodage du corps de la requête (par exemple, JSON, XML, URL Encoded)
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 leads livrés avec succès par rapport à ceux qui ont été rejetés.

Documentation de l'API

La documentation de l'API peut englober 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 livrer des leads à votre système.

La documentation de l'API ainsi qu'un contact technique devraient suffire pour commencer le processus de configuration de l'API.

Pour un bon exemple de documentation de l'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 les questions concernant le processus de configuration de l'API.

Le contact technique devrait être capable d'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 de 403

Par exemple :

John Smith

Support Technique

john.smith@company.com

Endpoint

C'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 le processus de configuration et de test afin qu'aucun lead 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 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 plusieurs formes, telles que :

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

Paramètres API

Fournissez une liste de paramètres que Rokt doit inclure dans chaque requête API. Si possible, spécifiez tout :

• Attributs requis (attributs qui doivent être envoyés pour que la requête réussisse)
• Attributs optionnels
• Noms des paramètres pour chaque attribut (qu'il s'agisse de 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 rapport à ceux qui n'ont pas été livrés 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 de corps de réponse :

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

attention

Travaillez avec votre gestionnaire 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. Allez à la page Integrations > Connections dans le menu de navigation de gauche.

3. Cliquez sur Add connection.

4. Sous Referrals, cliquez sur API.

   

5. Donnez un nom à votre connexion.

   

6. Entrez le point de terminaison pour votre connexion.

   

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

   

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

   

Tester votre connexion API

1. Une fois votre connexion API configurée (point de terminaison, autorisation, en-têtes, corps et gestion de la réponse), cliquez sur Paramètres.

   

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

   

3. Cliquez sur Enregistrer.

4. Cliquez sur Tester.

   

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

6. Répétez les tests jusqu'à ce que vous ayez obtenu 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.

   

3. Cliquez sur Afficher non lié.

   

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

   

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

   

Dissocier les campagnes de votre connexion API

1. Allez à la page Real-time Referral.

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

   

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

   

4. Cliquez sur Show unlinked.

   

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

   

Via SFTP

Les connexions Secure File Transfer Protocol (FTP) vous permettent d'automatiser vos livraisons de recommandations 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 avec un fichier .csv contenant toutes vos nouvelles recommandations 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 gestionnaire de compte pour obtenir l'accès.

Vous devez également disposer des informations suivantes 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 gestionnaire 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 obtenu l'accès au serveur SFTP de Rokt."
4. Téléchargez le fichier joint et décompressez 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écompresser 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.

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

7. À gauche, cliquez sur Nouveau site et remplissez les champs suivants :

• 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 disque local (voir image ci-dessous).

  

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

Chemin de fichier et exigences

Les fichiers de recommandation sont placés dans le chemin de fichier suivant :

Chemin de fichier	Objectif
/downloads	Té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 Intégrations > Connexions depuis le menu de navigation de gauche.

3. Cliquez sur Ajouter une connexion.

4. Sous Recommandations, sélectionnez FTP.

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

   

6. Entrez le Répertoire et nom de fichier.

   

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

   

8. Sélectionnez votre méthode FTP souhaitée.

   

9. 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.

   

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

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.

   

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

   

3. Votre connexion est désactivée.

   

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

Par email

Rokt peut planifier la livraison de fichiers de recommandation (en format .csv) 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 de commencer à obtenir des données de recommandation de One Platform. Vous pouvez toujours passer à une solution SFTP ou API à l'avenir.

Avant de commencer

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

1. Adresse email (ou une liste de plusieurs adresses email) où les recommandations doivent être livrées.
2. Fréquence de livraison—qui spécifie à quelle fréquence et à quels moments vous souhaitez recevoir les emails de recommandation.
3. Paramètres requis—les plus courants étant email, prénom, nom de famille, source et état. En savoir plus sur les attributs que Rokt peut fournir.

Configuration d'une connexion par e-mail

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

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

3. Cliquez sur Ajouter une connexion.

4. Sous Parrainages, cliquez sur Email.

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

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

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

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

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

Désactivation d'une connexion par e-mail

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

   

2. Cliquez sur l'icône de pause.

3. Votre connexion par e-mail est désactivée.

4. Vous pouvez inverser ces étapes pour 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 vos données CRM Mailchimp aussi à jour que possible (Rokt publie de nouvelles recommandations toutes les cinq minutes) afin que vous puissiez consacrer plus d'énergie à la stratégie de vos campagnes et moins à leur gestion.

remarque

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

Récupération des clés API de Mailchimp

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

   

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

   

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.

   

   • 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 certaine période, ou si vous avez besoin de faire des dépannages ponctuels.

Si quelque chose ne va pas avec une connexion existante, comme une défaillance de l'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 recommandation pour vos campagnes.

La configuration pour accéder à vos données de recommandation sur la plateforme Rokt est simple et directe :

1. Informez votre gestionnaire de compte que vous souhaitez avoir accès, et il 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 consulter.
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 le téléchargement du fichier de recommandation. Rokt enverra un fichier .csv à votre email une fois terminé.

remarque

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