メインコンテンツまでスキップ

Advertiser/Data Provider Integration Guide

このガイドでは、ユーザーデータを収集し、DSP にプッシュする組織のためのインテグレーション手順について説明します。データコレクターには、広告主、データオンボーダー、測定プロバイダー、ID グラフプロバイダー、サードパーティデータプロバイダー、および DSP にデータを送信する他の組織が含まれます。

Snowflake Data Marketplace でホストされる Open Operator Service を使用する場合は、Snowflake Integration Guide も参照してください。

Integration Steps​

次の図は、データコレクターがオーディエンスの構築とターゲティングのために directly identifying information (DII) を UID2 識別子にマッピングするために完了する必要がある手順の概要を示しています。

DII とは、正規化されたメールアドレスや電話番号、あるいは正規化され SHA-256 ハッシュ化されたメールアドレスや電話番号のことです。

Advertiser Flow

図の各部の詳細については、以下のセクションを参照してください:

  1. Retrieve a raw UID2 for DII using the identity map endpoints
  2. Send stored raw UID2s to DSPs to create audiences
  3. Monitor for salt bucket rotations related to your stored raw UID2s

1: Retrieve a raw UID2 for DII using the identity map endpoint​

StepEndpointDescription
1-aPOST /identity/mapリクエストDII を含むリクエストを ID マッピングエンドポイントに送信します。
1-bPOST /identity/map レスポンスレスポンスで返される advertising_id (raw UID2) は、関連する DSP でオーディエンスをターゲティングするために使用できます。
このレスポンスは、ユーザーの raw UID2 と、ソルトバケットに対応する bucket_id を返します。バケットに割り当てられたソルトは毎年ローテーションされ、生成される raw UID2 に影響を与えます。ソルトバケットのローテーションをチェックする方法の詳細は 3: Monitor for salt bucket rotations を参照してください。
メンテナンスを簡単にするために、ユーザの raw UID2 と bucket_id をマッピングテーブルに格納することを推奨します。インクリメンタルな更新に関するガイダンスについては、Use an incremental process to continuous-update raw UID2s を参照してください。

2: Send stored raw UID2s to DSPs to create audiences​

Step 1-b で返された advertising_id (raw UID2) を、オーディエンスを構築しながら DSP に送信します。各 DSP はオーディエンスを構築するための独自のインテグレーションプロセスを持っています。raw UID2 を送信してオーディエンスを構築するには、DSP が提供するインテグレーションガイダンスに従ってください。

raw UID2 は、特定の時点のユーザーに対する識別子です。特定のユーザーの raw UID2 は、ソルトのローテーションの結果、少なくとも 1 年に 1 回は変化します。

ソルトバケットの更新は 1 年に 1 回程度ですが、個々のバケットの更新は 1 年に分散しています。全ソルトバケットの約 1/365 を毎日ローテーションしています。

important

あなたのインテグレーションが最新の raw UID2 を持っていることを確認するために、アクティブなユーザーのソルトバケットのローテーションを毎日チェックしてください。

StepEndpointDescription
3-aPOST /identity/buckets特定のタイムスタンプ以降に変更されたすべてのソルトバケットについて、バケットステータスエンドポイントにリクエストを送信します。
3-bPOST /identity/bucketsUID2 service: バケットステータスエンドポイントは bucket_id と last_updated のタイムスタンプのリストを返します。
3-cPOST /identity/map返されたbucket_idを、キャッシュしておいた raw UID2 のソルトバケットと比較します。
1 つ以上の raw UID2 についてソルトバケットが更新されていることがわかったら、新しい raw UID2 について ID マッピングサービスに DII を再送信します。
3-dPOST /identity/mapadvertising_idとbucket_idに返された新しい値を保存します。

Use an Incremental Process to Continuously Update Raw UID2s​

UID2 ベースのオーディエンス情報を正確かつ最新の状態に保つために、毎日以下のインテグレーション手順を実行してください:

  1. UID2 retrieval step のレスポンスにはマッピング情報が含まれています。以下をキャッシュします:
  • DII (identifier) と raw UID2 (advertising_id) とソルトバケット (bucket_id) のマッピング。
  • 最新の last_updated タイムスタンプ。

  1. Step 3の結果を使用して、Monitor for salt bucket rotations related to your stored raw UID2s、 Step1 の Retrieve a raw UID2 for DII using the identity map endpoint に従って、ソルトバケットがローテーションされた ID の新しい raw UID2 を取得して、ソルトバケットの raw UID2 を再マッピングします。

    次に、Step 2のsend raw UID2 to a DSP に従って、リフレッシュされた UID2 を使ってオーディエンスを更新します。

Check Opt-Out Status​

ユーザーのオプトアウトステータスを受け入れることは重要です。最新のオプトアウト情報を確認するために、次の 2 つの方法を使用できます:

  • UID2 Operator Service は、広告主やデータプロバイダーに、POST /identity/map エンドポイントを介してオプトアウト情報を配布します。

  • 広告主やデータプロバイダーは、POST /optout/status エンドポイントを使用して、生の UID2 のオプトアウトステータスを確認できます。

FAQs​

UID2 フレームワークを使用する広告主およびデータプロバイダー向けのよくある質問は、FAQs for Advertisers and Data Providers を参照してください。