Last updated 24 oct. 2023

Exporter des transactions

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 façon de créer des abonnés dans votre système.
2. Coordonnées du contact technique pour aider à résoudre les problèmes de configuration.
3. Points de terminaison pour tous les environnements pertinents (production, test, mise en scène, 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 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 leads livrés avec succès par rapport à ceux qui ont été rejetés.

Configuration de la connexion API

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Intégrations.

4. Cliquez sur Connexions.

5. Cliquez sur Ajouter une connexion.

6. Sous Transactions, sélectionnez API.

   1. Donnez un nom à votre connexion.

      

   2. Entrez le point de terminaison de votre connexion.

      

   3. Entrez toutes les informations requises sous Autorisation, En-têtes et Corps.

      

   4. Entrez toutes vos règles de Gestion des réponses.

      

   5. Une fois que votre connexion API est configurée (point de terminaison, autorisation, en-têtes, corps et gestion des réponses), cliquez sur Paramètres.

      

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

      

   7. Cliquez sur Enregistrer.

   8. Cliquez sur Tester.

      

   9. Vérifiez le résultat de votre test.

   10. Répétez les tests jusqu'à ce que vous obteniez les résultats souhaités.

Emplacements des liens vers votre connexion API

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Intégrations.

4. Cliquez sur Connexions.

5. Sélectionnez Temps réel dans le menu déroulant de gauche et Transactions dans le menu déroulant de droite.

6. Développez la connexion à laquelle vous souhaitez lier vos emplacements.

   

7. Cliquez sur Afficher les emplacements non liés.

   

8. Cliquez sur Lier pour Tous les emplacements.

   

9. Tous les emplacements sont maintenant liés à votre connexion.

   

Désactiver les liens des emplacements avec votre connexion API

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Intégrations.

4. Cliquez sur Connexions.

5. Sélectionnez Temps réel dans le menu déroulant de gauche et Transactions dans le menu déroulant de droite.

6. Développez la connexion à partir de laquelle vous souhaitez désactiver les liens des emplacements.

   

7. Cliquez sur Désactiver le lien pour désactiver tous les emplacements.

   

8. Tous les emplacements sont désactivés.

Livraisons programmées

L'établissement d'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 Télécharger FileZilla Client.
2. Installez FileZilla sur votre ordinateur. Si vous avez déjà FileZilla installé, assurez-vous d'utiliser la dernière version.
3. Contactez votre responsable 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".
4. Téléchargez le fichier joint et décompressez le fichier chiffré en utilisant le mot de passe fourni dans un deuxième e-mail intitulé "E-mail pour le mot de passe du fichier avec les instructions".
5. 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.

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

  

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

Les connexions Secure File Transfer Protocol (SFTP) automatisent vos livraisons de données 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 !

Après avoir configuré une connexion SFTP, vous recevez un e-mail avec un fichier CSV contenant toutes vos données de transaction à la fréquence que vous préférez.

Connexion SFTP de Rokt

Avant de commencer

Si vous n'avez pas encore accès au SFTP de Rokt, contactez votre gestionnaire de compte.

Assurez-vous d'avoir les informations suivantes à portée de main :

1. Fréquence de livraison - à quelle fréquence et à quelles heures les transactions seront téléchargées sur le serveur SFTP.
2. Paramètres requis - les plus courants étant l'e-mail, le prénom, le nom de famille, la source et l'état. Pour tous les attributs disponibles, consultez Métadonnées de transaction.

Chemin d'accès et exigences du fichier

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

Chemin d'accès	Objectif
/downloads	Télécharger les données de transaction fournies par Rokt

remarque

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

Utilisez votre propre connexion FTP

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Intégrations.

4. Cliquez sur Connexions.

5. Cliquez sur Ajouter une connexion.

6. Sous Transactions, cliquez sur FTP.

7. Sélectionnez un modèle pour cette connexion, puis donnez un nom à votre connexion.

   

8. Entrez le répertoire et le nom du fichier.

   

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

   

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

    

11. Entrez le nom d'utilisateur et le mot de passe, ou entrez le nom d'utilisateur et téléchargez votre fichier de clé.

    

12. Sélectionnez votre planning et cliquez sur Enregistrer.

    

13. Votre connexion a été créée.

Désactiver une connexion FTP

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Intégrations.

4. Cliquez sur Connexions.

5. Sélectionnez Planifié dans le menu déroulant de gauche et Transactions dans le menu déroulant de droite.

   

6. Cliquez sur Pause.

   

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

   

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

Exportation manuelle

Quelle que soit la manière dont vous souhaitez recevoir vos données de transaction, toutes vos données sont toujours accessibles sur la plateforme Rokt en allant dans Transactions > Données client > Exporter.

Si quelque chose ne va pas, comme une défaillance de l'API ou la suppression d'un e-mail, ne vous inquiétez pas ! Vous pouvez toujours vous connecter à Rokt et télécharger toutes vos données de transaction à tout moment.

Rokt propose des données téléchargeables au format CSV. Pour télécharger :

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Transactions.

4. Cliquez sur Données client.

5. Choisissez l'emplacement pour lequel vous souhaitez afficher les données de transaction.

6. Ajustez la plage de dates dans la barre de navigation supérieure.

7. Cliquez sur Exporter.

8. Votre exportation commencera immédiatement à se télécharger sur votre ordinateur. Selon le nombre d'enregistrements dans le rapport, cela peut prendre un peu de temps pour se terminer. Vous devriez pouvoir ouvrir les fichiers CSV dans la plupart des applications de feuilles de calcul courantes.

remarque

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

Personnaliser les champs de données exportées

L'exportation utilise un modèle par défaut contenant les champs clés de vos transactions. Si nécessaire, vous pouvez personnaliser les données que vous exportez en ajoutant, supprimant et réorganisant les colonnes.

1. Connectez-vous à my.rokt.com

2. Accédez à votre compte.

3. Cliquez sur Transactions.

4. Cliquez sur Données client.

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

   

6. Sur l'écran qui apparaît, utilisez le menu déroulant pour ajouter ou supprimer des champs de données.

   

7. Mettez à jour l'ordre des colonnes dans le fichier d'exportation en faisant glisser et déposer les champs.

   

8. Cliquez sur Enregistrer sous et saisissez un nom de modèle, si vous souhaitez utiliser ce modèle pour les futures exportations.

   

9. Cliquez sur Exporter pour télécharger vos données dans un fichier CSV.