Last updated 5 déc. 2024

Flocon de Neige

Flocon de Neige est une entreprise de stockage de données basée sur le cloud. Avec l'application native de l'API Rokt Conversions, les utilisateurs peuvent intégrer des données de conversion pour améliorer la précision du ciblage, la personnalisation et les résultats globaux des campagnes.

Ce guide fournit des instructions étape par étape pour configurer l'application native de l'API Rokt Conversions au sein de votre instance Snowflake. Grâce à cette configuration, vous pouvez facilement envoyer des données de conversion complètes à Rokt pour relier l'activité marketing, telle qu'un Référencement, à des résultats qui génèrent de la valeur commerciale, tels qu'une Conversion client (par exemple, achats, abonnements ou téléchargements d'applications).

remarque

Actuellement en version Beta Publique

Configuration de l'Intégration

Prérequis de Données

L'application native de l'API Rokt Conversions nécessite un accès à une vue à jour des données de Conversions.

Tous les noms de colonnes suivants doivent être présents dans la vue ; pour toutes les colonnes que vous ne souhaitez pas intégrer avec Rokt, remplissez la colonne avec la valeur "ROKT_FILLER_VALUE". L'intégration de champs de données supplémentaires avec Rokt permet une meilleure optimisation des campagnes.

remarque

Les colonnes en gras sont nécessaires pour le bon fonctionnement de l'intégration. De plus, l'un des champs email, emailsha256, ou passbackconversiontrackingid (RoktID) est nécessaire pour fournir un signal significatif à Rokt.

Nous recommandons d'envoyer, en plus de l'un des champs requis, mobile, firstname et lastname pour une performance optimale.

Nom de la Colonne	Type de Colonne
eventtime	TIMESTAMP
clienteventid	VARCHAR
email	VARCHAR
emailsha256	VARCHAR
passbackconversiontrackingid	VARCHAR
amount	VARCHAR
conversiontype	VARCHAR
firstname	VARCHAR
firstnamesha256	VARCHAR
lastname	VARCHAR
lastnamesha256	VARCHAR
mobile	VARCHAR
mobilesha256	VARCHAR
ipaddress	VARCHAR
ipaddresssha256	VARCHAR
address1	VARCHAR
address2	VARCHAR
zipcode	VARCHAR
city	VARCHAR
stateName	VARCHAR
country	VARCHAR

Des définitions détaillées pour chaque colonne peuvent être trouvées ici.

Installer

Installez l'application via le Snowflake Marketplace.

Configurer

1. Accordez à l'application un accès en lecture seule à la vue de données contenant les événements de conversion.

   1. Dans le panneau de gauche de l'UI Snowflake, cliquez sur Produits de données >> Applications.
   2. Sélectionnez l'application "Rokt Conversions API".
   3. Dans le coin supérieur droit, cliquez sur l'icône du bouclier de sécurité.
   4. Accordez à l'application l'accès à la Vue de Conversions que vous avez définie précédemment.

2. Sur la même page et l'onglet, accordez à l'application le privilège EXECUTE TASK et EXECUTE MANAGED TASK. Cela permet à la procédure stockée en 4) de créer une tâche pour intégrer régulièrement les données de conversion avec Rokt.

   

3. Dans la même vue "Sécurité", sélectionnez l'onglet "Connexions".

   • I. Lorsque vous êtes dans cet onglet, veuillez cliquer sur le bouton "Examiner" pour la "bulle Connexions".

   • II. Acceptez que l'application enverra des données à l'URL api.rokt.com de Rokt, et configurez vos identifiants d'authentification.

   

   Pour le Nom d'utilisateur, entrez le jeton rpub. Pour le Mot de passe, entrez le jeton rsec. Vous pouvez obtenir ces valeurs auprès de votre responsable de compte Rokt.

   

4. Ouvrez un carnet de notes dans l'application ROKT_CONVERSIONS_API dans le schéma CORE. Initialisez l'application avec votre Rokt AccountID. Directions pour obtenir votre accountid.

call initialize_rokt_integration('MY_ACCOUNT_ID');

La procédure stockée devrait s'exécuter en moins d'une minute et renvoyer "Rokt integration initialized successfully!" à la console.

Intégration des données de conversion

L'application lira désormais, sur une cadence horaire, toutes les lignes de la vue de conversion qui sont nouvelles dans l'heure précédente, et intégrera ces données avec l'API des événements de Rokt.

Mise à jour des artefacts de l'application

Ouvrez un classeur dans l'application ROKT_CONVERSIONS_API dans le schéma CORE.

Exécutez les requêtes suivantes pour supprimer les artefacts existants puis les remplacer par une nouvelle version des artefacts.

call drop_rokt_integration_artifacts();
call initialize_rokt_integration('MY_ACCOUNT_ID');