Last updated 31 janv. 2025

Snowflake

Snowflake est une entreprise de stockage de données basée sur le cloud. Avec l'application native Rokt Conversions API, 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 pas-à-pas pour configurer l'application native Rokt Conversions API au sein de votre instance Snowflake. Grâce à cette configuration, vous pouvez facilement envoyer des données de conversion complètes à Rokt pour lier l'activité marketing, telle qu'une Référence, à 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

Authentification

S'authentifier à l'API de Rokt via l'application Snowflake nécessite une Clé Publique Rokt, un Secret Rokt et un ID de Compte. Contactez votre Responsable de Compte pour obtenir ces informations d'identification si vous ne les avez pas déjà.

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 toute colonne 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 que l'intégration fonctionne. De plus, l'un des éléments suivants email, emailsha256, ou passbackconversiontrackingid (RoktID) est nécessaire pour fournir un signal significatif à Rokt.

Nous recommandons d'envoyer, avec l'une des fonctionnalités requises, mobile, firstname et lastname pour des performances optimales.

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 des événements de conversion.

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

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

   

3. Dans le même onglet "Security", sélectionnez l'onglet "Connections".

   • I. Dans cet onglet, veuillez cliquer sur le bouton "Review" pour la "Connections bubble".

   • II. Acceptez que l'application envoie 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 gestionnaire de compte Rokt.

   

4. Ouvrez un classeur au sein de l'application ROKT_CONVERSIONS_API dans le schéma CORE. Initialisez l'application avec votre Rokt AccountID. Instructions 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 retourner "Successfully initialized Rokt integration!" à la console.

Intégration des données de conversion

L'application va maintenant, sur une base horaire, lire toutes les lignes de la vue de conversion qui sont nouvelles au cours de l'heure précédente, et intégrer ces données avec l'API d'événements de Rokt.

Mise à jour des artefacts de l'application

Ouvrez un tableau 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');