Snowflake Data Clean Rooms: アクティベーションコネクタ¶

注釈

Snowflake Data Clean Rooms は現在、データ主体の同意管理をサポートしていません。お客様は、クリーンルーム内でリンクされたデータを使用するために必要なすべての権利と同意を得ていることを確認する責任があります。また、お客様は、サードパーティコネクタとの接続を含め、Data Clean Roomsを使用する際に適用されるすべての法律および規制を遵守する必要があります。

コネクタを使用して、クリーンルーム環境をエコシステムパートナー提供するものと統合することができます。このトピックでは、クリーンルーム管理者が、クリーンルームのユーザーが分析結果をアクティベーションパートナーにプッシュできるように、コネクタを構成する方法について説明します。

プロバイダーとして、クリーンルームユーザーが分析を実行する際に、どのコネクタがオプションとして表示されるかを制御する場合は、利用可能なコネクタをカスタマイズするをご参照ください。

重要

サードパーティコネクタは、Snowflake提供ではないため、追加条件が適用される場合があります。これらの統合は、お客様の便宜のために提供されるものですが、統合に送受信されるコンテンツについては、お客様が責任を負うものとします。

お客様は、Snowflake Data Clean Roomsの使用に関連して必要な同意を取得する責任を負うものとします。アクティベーションを目的としたサードパーティコネクタとの接続も含め、Snowflake Data Clean Roomsを使用する際は、適用される法律および規制を遵守していることを確認してください。

Google広告コネクタ¶

Google広告は、広告主がウェブユーザーに簡単な広告、サービス、製品リスト、またはビデオを表示するために入札するオンライン広告プラットフォームです。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーン環境がGoogle広告アカウントと統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
Google Ads を展開します。
Google認証情報を入力します。
Account ID フィールドに、Google広告アカウントに関連付けられている ID を入力します。
API設定を指定します。 My Developer Token を選択した場合は、Google広告 API の開発者トークンを入力します。
Save を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。

Google Display & Video 360-PAIR コネクタ¶

Google Display & Video 360-PAIR は、広告主がディスプレイに入札するオンライン広告プラットフォームです。PAIR では、パブリッシャーと広告主は、広告主サイトとパブリッシャーサイトの両方を訪問したオーディエンスのファーストパーティデータを、セキュリティ保護された非公開データとして照合するオプションがあります。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

clean room環境を Display & Video 360-PAIR と統合するには、このコネクタを次のように構成する必要があります：

コネクタを構成する前に、 Google Display & Video 360 で自分のアカウント ID を CMU: Snowflake に関連付けてください。
clean room UI の左側のナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
Google DV360 - PAIR を展開します。
Account ID に、Display & Video 360-PAIR のアカウントID を入力します。 Snowflake サポートに、この ID について問い合わせてください。
Account Type で、 Advertiser または Publisher を適宜選択してください。(広告主はコンシューマーであり、パブリッシャーはプロバイダーです)。
Snowflakeデータのclean roomのユーザーが、複数のDisplay & Video 360-PAIR アカウントに結果をアクティベートすることを許可する場合は、 + Account を選択し、追加するアカウントごとに新しいアカウント ID とアカウントタイプを入力します。お客様のクリーンルームに適したデータパートナーアカウント ID については、Snowflakeサポートにお問い合わせください。
Save を選択します。

以下は、プロバイダー (パブリッシャー) とコンシューマー (広告主) が、コンシューマーの分析結果をプロバイダーのDisplay & Video 360-PAIR アカウントにアクティベートするための手順です。

一般的なガイドライン

Google Display & Video 360-PAIR を使用する場合、パブリッシャーはプロバイダーであり、広告主はコンシューマーです。
このコネクタでサポートされているテンプレートは Audience Overlap & Segmentation のみです。プロバイダーもコンシューマーも、 PAIR のバージョンでハッシュ化されたメールや電話で1つのテーブルに参加します。
プロバイダーテーブルとコンシューマーテーブルの両方に、 Googleの PAIR の要件に従ってハッシュ化されたメールまたは電話データが含まれている必要があります。
400万以上の行がclean roomにリンクされている場合は、最大のウェアハウスサイズ (4XL) を使用することをお勧めします。
PAIR clean roomで、分析およびアクティビティにデータセットを使用する際、一意の行数が1億行を超えないようにしてください。
Google Display & Video 360-PAIR コネクタをclean roomに追加すると、他のアクティベーションコネクタはそのルームに入れなくなります。clean room内で使用できるIDコネクタは、 Google DV360 - PAIR のみです。
このコネクタはプロバイダーが実行する分析やアクティベーションをサポートしません。

概要

このコネクタの使い方を簡単に説明します:
1. プロバイダーは、 PAIR Display & Video 360 Identity アクティベーションとIDコネクタを使用するclean roomを作成し、ハッシュ化されたメールまたは電話の列を含むテーブルにリンクします。
2. プロバイダーはIDコネクタを使用し、テーブル内でハッシュ化されたメールまたは電話の列に基づいて PAIR ID 列を生成します。
3. プロバイダーは、生成された PAIR 列を結合列として指定します。
4. プロバイダーは Audience Overlap & Segmentation テンプレート (Display & Video 360-PAIRで許可された唯一のテンプレート) を指定し、テンプレートを構成および共有して、clean roomを公開します。
5. コンシューマーはclean roomに参加し、テーブルを指定して、 PAIR Display & Video 360 Identity コネクタを選択し、ハッシュ化されたメールまたは電話の列から PAIR 列を生成します。
6. コンシューマーは、プロバイダーの PAIR 列に自分の PAIR 列を結合し、分析を実行して、結果 (PAIR ID 列) をGoogleにアクティベートします。
7. プロバイダーは、ハッシュ化されたメールや電話の値と、それに対応する PAIR の値を関連付けるマッピングテーブルをダウンロードします。プロバイダーはこのテーブルを広告サーバーまたはセルサイドプラットフォーム (SSP) に送信し、コンシューマーがDisplay & Video 360に対してアクティベートする PAIR の値と照合します。
詳しくは、以下の Provider または Consumer のセクションをご参照ください。
プロバイダーがclean roomでDisplay & Video 360-PAIR を使用するには、以下の手順が必要です:
1. Display & Video 360 のアカウントを構成して、 Snowflake Data Clean Rooms にリンクします。手順については、 Googleのドキュメントを参照してください。
2. Configuration guide タブの説明に従って、Google Display & Video 360-PAIR コネクタをインストールして構成します。
3. Google PAIR で識別列を暗号化するclean roomを作成し、そのclean roomをコンシューマーと共有します(下記を参照)。
4. SSP に送信された入札リクエスト (下記を参照) の、対応する元のバージョンとPAIRバージョンの結合列のマッピングテーブルを指定します。
clean roomの作成と共有
clean room UI にサインインして新しいclean roomを作成します。

Add Data のステップで、コンシューマーと共有するテーブルを選択します。このテーブルには、Googleの要件に従ってハッシュ化されたメールまたは電話番号の列が必要です。

Specify Join Policies ステップで、以下の値を設定します:

Identity Hub を展開し、 PAIR Display & Video 360 を選択します。

PAIR Join Columns セクションで、ハッシュ化されたメールまたは電話列を選択します。コネクタは、この列の PAIR バージョンを、元の列名に _PAIR を追加して生成します:

Generate Preview を選択すると新しい列が表示されます。

新しい列をデータセットに追加するには、 Add Identity を選択します。

Join Policies セクションで、生成された _PAIR 列を選択します。他の列では結合しないでください。

Configure Analysis & Query セクションで、 Audience Overlap & Segmentation テンプレートを構成します。

ハッシュ化されたメールまたは電話を含むテーブルを選択します。

Segmentation & Attribute Columns に任意の値を設定します。

Privacy Settings で、 Threshold Value をGoogleの要件に従って1,000またはそれ以上に指定します。

Share Clean Room セクションで、コンシューマーをコラボレーターとして選択し、 Finish を選択して、clean roomを公開および共有します。

以下の手順で PAIR ID マッピングテーブルを取得します。このテーブルは自分のSnowflakeアカウントで生成されているため、この変換テーブルの完全修飾名さえ知っていれば、ダウンロードすることも、一括エクスポートすることもできます。このテーブルを入札リクエストと一緒に SSP または広告サーバーに送信します。
入札リクエストを準備して送信する

元のメールまたは電話の列と、 PAIR で暗号化およびハッシュ化された対応するメールまたは電話の列の変換テーブルを、エクスポートして SSP に送信します。SSP では、コンシューマーから送信された暗号化値に対応するハッシュ化値を、このデータを使用して検索します。入札リクエストでこれらの IDs を入力する際には、Base64エンコードなど URL のセキュリティを保護する形式を使用することをお勧めします。

完全なスコープ URLは以下の形式になります:
SAMOOHA_CLEANROOM_<cleanroom ID>.SHARED_SCHEMA.PROVIDER_<source database>__<source schema>__<source table>_PAIR<digit>
Copy
cleanroom ID
これはclean room ID であり、clean room名では ありません 。clean room名を指定してclean room ID を検索するには、次のように呼び出します:

CALL samooha_by_snowflake_local_db.provider.view_cleanrooms();

Copy
source database、 source schema、 source table
テンプレートで使用されるclean roomにリンクされたソーステーブルのデータベース、スキーマ、名前。ドットで区切るのではなく、以下のようにシングルまたはダブルのアンダースコアで区切ってください。

PAIRdigit
1桁の数字、通常は0または1。
以下は、完全なスコープテーブル名の例です:
SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0
Copy
以下のようにテーブルをクエリするか、一括エクスポートを使用し、データを平文ファイルとして、ステージやコンピューターにダウンロードします。
SELECT * FROM SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0;
Copy
コンシューマーが PAIR の重複データをGoogleにアクティベートするには、以下の手順が必要です:
1. Display & Video 360 のアカウントを構成して、 Snowflake Data Clean Rooms にリンクします。手順については、 Googleのドキュメントを参照してください。
2. Configuration guide タブの説明に従って、Google Display & Video 360-PAIR コネクタをインストールして構成します。
3. clean roomをインストールして PAIR対応にします (下記を参照)。
4. 分析結果を Display & Video 360アカウントにアクティベートします (下記を参照)。
clean roomの参加と構成
1. clean room UI にサインインし、該当するclean roomに参加します。
2. Add Data セクションで、clean roomに入れたいテーブルを選択します。このテーブルには、Googleの要件に従ってハッシュ化されたメールまたは電話番号の列が必要です。
3. Specify Join Policies ステップで、以下の値を設定します:
  1. PAIR Join Columns セクションで、ハッシュ化されたメールまたは電話列を選択します。コネクタはこの列の元の名前に_ PAIR を追加してPAIR バージョンの列名を生成します:
    
    Generate Preview を選択すると、新しい列が表示されます。
    
    Add Identity を選択して、これらの新しい列をスキーマに追加します。この手順を繰り返すと、さらに同じ列が生成されます。
  2. 結合ポリシーセクションで、 _PAIR 列をプロバイダーの対応する _PAIR 列と照合し、追加の結合ポリシーを定義します。
4. Configure Analysis & Query セクションで、 Audience Overlap & Segmentation テンプレートを構成します。
  - Tables の値をテーブルに設定します。
  - Segmentation & Attribute Columns に任意の値を設定します。
5. Finish を選択し、次に説明するように分析を実行します。
分析の実行と結果のアクティベート
1. Joined タブでclean roomを実行します。
2. 分析に必要な情報を入力して、 Audience Overlap & Segmentation 分析を実行します。作成した _PAIR 列と結合します。
3. クエリが正常に完了したら、結果ページを開き、 Activate を選択します。
4. Google Display & Video 360 - PAIR を選択します。
5. Account ID フィールドで、Display & Video 360 アカウントを選択します。
6. Segment Name フィールドに、結果の説明的な名前を入力します。
7. Description フィールドに、Display & Video 360に送信するデータの説明を入力します。
8. Publisher Name に、コラボレーションするプロバイダー名を入力します。
9. PAIR ID 列と、これらの識別子のタイプを選択します。
10. Push Data を選択し、Googleに結果をアクティベートします。

LiveRampコネクタ¶

LiveRamp は、ブランドやそのパートナーが製品や体験を提供するために活用する、業界をリードするコネクティビティ・プラットフォームです。LiveRamp RampID デジタルと物理的な世界全体で人、データ、デバイスをつなぎ、人ベースのマーケティングを強化し、コンシューマーがブランドや製品と安全につながることを可能にします。

注釈

データがSnowflake共有を使用してアップロードされるように LiveRamp コネクタを構成することを選択した場合、 LiveRamp は、ユーザーが LiveRamp を使用してアクティブ化する前に、共有取り込みを設定する必要があります。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーン環境が LiveRamp アカウントと統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
LiveRamp を展開します。
Select Upload Type ドロップダウンリストを使用して、以下のいずれかを実行します。
- SFTP を使用して LiveRamp とデータを共有したい場合:
  1. SFTP を選択します。
  2. SFTP を利用するために LiveRamp から提供されたユーザー名とパスワードを入力します。
- Snowflakeデータ共有を使用して LiveRamp とデータを共有したい場合:
  1. Snowflake Share を選択します。
  2. Account ドロップダウンを使用して、 LiveRamp Snowflakeアカウントを選択します。
  3. Generate Share を選択します。
  4. お客様のアカウント名と生成された共有を LiveRamp 担当者にお送りください。
Authenticate を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。

LiveRamp コネクタを使用して分析結果をアクティベートする方法を説明します。これらの説明は、このコネクタが適切にインストールされ、構成されていることを前提としています。

分析結果を LiveRamp にプッシュしてアクティベーションするには:

アクティブ化できるデータを返す分析を実行する。たとえば、 Audience Overlap & Segmentation テンプレートを使用した分析をアクティベートできます。

分析の実行については、プロバイダーとして分析を実行するまたはコンシューマーとして分析を実行するをご参照ください。
Results セクションで、 Activate を選択します。
Activation Hub ダイアログで、 LiveRamp を選択します。
Segment Name フィールドに、結果の説明的な名前を入力します。この名前はアルファベットで始まり、アルファベット、数字、アンダースコアのみを含む必要があります。

この名前には文字列 _SNOWDCR が付加されます。
RampID ドロップダウンで、 RampID を含む列をテーブルから選択します。
Push Data を選択します。

Meta Ads Managerコネクタ¶

Meta Ads Managerは、ターゲットを絞ったキャンペーンを構築し、広告費を最適化できる広告プラットフォームです。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーン環境がMeta広告マネージャアカウントと統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
Meta Ads Manager を展開します。
Meta Business Managerの認証情報を入力します。
Meta Ads Manager Account ID フィールドに、Meta Ads Managerアカウントの ID を入力します。
Save を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。

The Trade Desk - CRM コネクタ¶

The Trade Desk CRM は、顧客関係管理（CRM）データを統合し、パーソナライズされた広告キャンペーンのためにThe Trade Deskのプラットフォーム内でオーディエンスセグメントをアクティブ化し、ターゲットを絞ります。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーンルーム環境がThe Trade Desk - CRM のアカウントと統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
The Trade Desk - CRM を展開します。
Username フィールドに、The Trade Deskのアカウントに関連付けられているユーザー名を入力します。
Password フィールドに、The Trade Deskのアカウントパスワードを入力します。
Advertiser ID フィールドに、The Trade Deskアカウントに関連する広告主 ID を入力します。
Region フィールドで、The Trade Deskアカウントの地域を選択します。
Authenticate を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。

The Trade Desk - UID 2.0コネクタ¶

The Trade Desk - UID 2.0は、広告主が様々なチャネルでデジタル広告キャンペーンを計画、購入、管理するためのテクノロジープラットフォームを提供するデマンドサイドプラットフォーム（DSP）です。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーンルーム環境がThe Trade Desk - UID 2.0のアカウントと統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
The Trade Desk - UID 2.0 を展開します。
Advertiser ID フィールドに、The Trade Deskアカウントに関連する広告主 ID を入力します。
Secret Key フィールドに、The Trade Deskアカウントに関連する秘密キーを入力します。
Data Center ドロップダウンリストを使用して、The Trade Deskのデータセンターを選択します。
Authenticate を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。

Yahoo DSP コネクタ¶

Yahoo DSP は、広告主が様々なチャネルでデジタル広告の在庫をプログラマティックに購入し、最適化することを可能にするデマンドサイドプラットフォームです。

このコネクタを構成するには、 MANAGE_DCR_CONNECTORS ロールが必要です。

クリーンルーム環境がYahoo DSP と統合されるようにコネクタを構成するには:

ウェブアプリの左ナビゲーションで、 Connectors を選択します。
Activation タブを選択します。
Yahoo DSP を展開します。
Yahooアカウントに関連付けられた MDMID を入力します。
Authenticate を選択します。

このコネクタを使用して結果をアクティブにする方法については、 user guide タブをご参照ください。