Last updated 31 mars 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 étape par étape 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 connecter l'activité marketing, telle qu'une Référence, à des résultats qui stimulent la valeur commerciale, comme une Conversion client (par exemple, achats, abonnements ou téléchargements d'applications).

remarque

Actuellement en version Bêta 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 identifiants 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 (ID de clic Rokt) est nécessaire pour fournir un signal significatif à Rokt.

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

Nom de 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'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 Conversions View que vous avez définie précédemment.

2. Sur la même page et 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 conversions avec Rokt.

   

3. Au sein de la même vue "Security", sélectionnez l'onglet "Connections".

   • I. Lorsque vous êtes dans cet onglet, veuillez cliquer sur le bouton "Review" pour la "Connections bubble".

   • II. Acceptez que l'application enverra des données à l'URL api.rokt.com de Rokt, et configurez vos informations d'identification 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 de votre gestionnaire de compte Rokt.

   

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

Intégration des données de conversion

L'application va désormais, avec une cadence horaire, lire toutes les lignes dans la vue de conversion qui sont nouvelles dans l'heure précédente, et intégrer ces données avec l'API d'événement 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');