Snowflake

Snowflakeはクラウドベースのデータストレージ会社です。 Rokt Conversions APIネイティブアプリケーションを使用することで、 ユーザーはターゲティングの精度、パーソナライゼーション、全体的なキャンペーン成果を向上させるためにコンバージョンデータを統合できます。

このガイドは、Snowflakeインスタンス内でRokt Conversions APIネイティブアプリケーションを設定するためのステップバイステップの手順を提供します。 このセットアップを通じて、紹介などのマーケティング活動を 顧客のコンバージョン（例：購入、サブスクリプション、アプリケーションのダウンロード）などのビジネス価値を生み出す成果に結びつけるために、包括的なコンバージョンデータを簡単にRoktに送信できます。

統合セットアップ

認証

Snowflakeアプリケーションを介してRoktのAPIに認証するには、Rokt Public Key、Rokt Secret、およびAccount IDが必要です。 これらの資格情報をまだお持ちでない場合は、アカウントマネージャーにお問い合わせください。

データの前提条件

Rokt Conversions APIネイティブアプリケーションは、最新のコンバージョンデータビューへのアクセスを必要とします。

以下のすべての列名がビューに存在する必要があります。 Roktと統合したくない列には、値 "ROKT_FILLER_VALUE"を入力してください。Roktと追加のデータフィールドを統合することで、キャンペーンの最適化が向上します。

注記

太字の列は統合が機能するために必要です。さらに、email、emailsha256、または passbackconversiontrackingid（Rokt Click ID）のいずれかが、Roktに意味のあるシグナルを提供するために必要です。

必要な機能の1つとともに、mobile、firstname、およびlastnameを送信することをお勧めします。最適なパフォーマンスのために。

列名	列タイプ
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

各列の詳細な定義はEvents APIフィールドリファレンスにあります。

インストール

アプリを Snowflake Marketplace からインストールします。

設定

1. アプリケーションに、コンバージョンイベントを含むデータビューへの読み取り専用アクセスを許可します。

   1. Snowflake UI の左側のパネルで、「Data Products >> Apps」をクリックします。
   2. 「Rokt Conversions API」アプリを選択します。
   3. 右上隅のセキュリティシールドアイコンをクリックします。
   4. 以前に定義したコンバージョンビューへのアクセスをアプリケーションに許可します。

2. 同じページとタブで、アプリケーションに EXECUTE TASK と EXECUTE MANAGED TASK の権限を付与します。これにより、4) のストアドプロシージャが Rokt と定期的にコンバージョンデータを統合するタスクを作成できるようになります。

   

3. 同じ「セキュリティ」ビュー内で、「Connections」タブを選択します。

   • I. このタブにいるとき、「Connections bubble」の「Review」ボタンをクリックしてください。

   • II. アプリケーションが Rokt の api.rokt.com URL にデータを送信することを受け入れ、 認証資格情報を設定します。

   

   ユーザー名には rpub トークンを入力します。パスワードには rsec トークンを入力します。これらの 値は Rokt アカウントマネージャーから取得できます。

   

4. CORE スキーマ内の ROKT_CONVERSIONS_API アプリケーションでワークブックを開きます。Rokt AccountID でアプリケーションを初期化します。 Rokt Account ID の見つけ方 に従ってください。

call initialize_rokt_integration('MY_ACCOUNT_ID');

ストアドプロシージャは1分以内に実行され、「Successfully initialized Rokt integration!」を コンソールに返すはずです。

コンバージョンデータの統合

アプリケーションは、毎時、過去1時間以内に新しく追加されたコンバージョンビュー内のすべての行を読み取り、 そのデータを Rokt の Event API と統合します。

注記

Rokt が広告キャンペーンを最適化するために使用できるイベントタイプのみがコンバージョンビューに含まれていることを確認してください。

アプリアーティファクトの更新

CORE スキーマ内の ROKT_CONVERSIONS_API アプリケーションでワークブックを開きます。

既存のアーティファクトを削除し、新しいバージョンのアーティファクトで置き換えるために、次のクエリを実行します。

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