Last updated 16 juil. 2024

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 techniques pour aider à résoudre les problèmes de configuration.
3. Points de terminaison 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.

Configurer 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 pour 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 votre connexion API 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 votre résultat de test.

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

Lier des emplacements à 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 non liés.

   

8. Cliquez sur Lier pour Tous les emplacements.

   

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

   

Délier des emplacements de 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 de laquelle vous souhaitez délier vos emplacements.

   

7. Cliquez sur Délier pour délier tous les emplacements.

   

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

Livraisons programmées

É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à FileZilla installé, assurez-vous d'exécuter la dernière version.
3. Contactez votre gestionnaire de compte Rokt pour demander l'accès au SFTP de Rokt. Une fois que vous avez obtenu l'accès, vous devriez recevoir un email de Rokt avec le sujet "You've been granted access to Rokt's SFTP server."
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 for password for file with 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 naviguez vers File > Site Manager

7. À gauche, cliquez sur New Site et remplissez les informations suivantes :

• Protocol: SFTP – SSH File Transfer Protocol

• Host: ftp.rokt.com

• Port: 22

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

  

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

Le protocole de transfert de fichiers sécurisé (SFTP) automatise vos livraisons de données et nécessite peu d'effort pour être configuré. 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 email 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 à quels moments les transactions seront 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. Pour tous les attributs disponibles, voir Métadonnées de transaction.

Chemin de fichier et exigences

Les fichiers de données de transaction sont placés dans le chemin de fichier suivant :

Chemin de fichier	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 de votre serveur FTP et le port.

   

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 calendrier 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 email est désactivée.

   

8. Vous pouvez inverser ces étapes pour ré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 à Transactions > Données clients > Exporter.

Si quelque chose ne va pas, comme une défaillance de l'API ou un email supprimé, 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 clients.

5. Choisissez le placement pour lequel vous souhaitez voir 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 certain temps. Vous devriez pouvoir ouvrir les fichiers CSV dans la plupart des applications de tableur courantes.

remarque

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

Personnaliser les champs de données d'exportation

L'exportation utilise un modèle par défaut contenant les champs clés pour 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 clients.

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 en déposant les champs.

   

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

   

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