Skip to content

integration-advertiser-dataprovider-overview.md

Latest commit

 

History

History
161 lines (94 loc) · 13.6 KB

integration-advertiser-dataprovider-overview.md

File metadata and controls

161 lines (94 loc) · 13.6 KB
title Advertiser/Data Provider Integration Overview
sidebar_label Advertiser/Data Provider Integration Overview
description ユーザーデータを収集し、他の参加者へプッシュする組織向けのインテグレーションの概要。
hide_table_of_contents false
sidebar_position 7
displayed_sidebar sidebarAdvertisers

import Link from '@docusaurus/Link';

Advertiser/Data Provider Integration Overview

このガイドでは、ユーザーデータを収集し、他の UID2 参加者へプッシュする組織向けのインテグレーションオプションの概要を提供します。データコレクターには、広告主、データオンボーダー、計測プロバイダー、アイデンティティグラフプロバイダー、サードパーティデータプロバイダー、および他のデータを他の参加者に送信する組織が含まれます。

Advertiser/Data Provider Routes to Use UID2

アドテク業界では、広告主は ID を使用してオーディエンスを構築し、コンバージョンを追跡し、グラフを生成します。広告主または広告主を代表してデータプロバイダーとして、UID2 を使用してこれらの目標を達成する方法の一部の例を次の表に示します。

:::note これらのユースケース以外にも、UID2 を使用する方法があります。以下に、いくつかの例を示します。 :::

Send/Receive? Action Advantage/Result
オーディエンスを送信 API またはピクセルを介して UID2 を送信 オーディエンスを作成します。
コンバージョンを送信 UID2 をコンバージョン情報として送信 測定（アトリビューション）またはリターゲティングのためにコンバージョン情報を使用します。
グラフデータを受信 API またはピクセルを介してグラフ/データプロバイダーから UID2 を受信 グラフデータを構築します。

High-Level Steps

広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです:

  1. Generate Raw UID2s from DII

  2. Store Raw UID2s and Salt Bucket IDs

  3. Manipulate or Combine Raw UID2s

  4. Send Stored Raw UID2s to DSPs to Create Audiences or Conversions

  5. Monitor for Salt Bucket Rotations for Your Stored Raw UID2s

  6. Monitor for Opt-Out Status

Summary of Implementation Options

以下の表は、広告主およびデータプロバイダーが利用できる実装オプションを、各ステップごとに示しています。一部のステップは、独自のカスタム実装の一部としてのみ管理されます。一部のステップは、利用可能な UID2 実装オプションのいずれかを使用して管理できます。詳細は、各ステップのリンクをクリックしてください。

High-Level Step Implementation Options
1: Generate Raw UID2s from DII DII を raw UID2 にマッピングするには、以下のオプションのいずれかをします:
2: Store Raw UID2s and Salt Bucket IDs カスタム（適切な方法で）。
3: Manipulate or Combine Raw UID2s カスタム（適切な方法で）。
4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions カスタム（適切な方法で）。
5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s 以下のいずれかのオプションを使用してください:
6: Monitor for Opt-Out Status API コールを使用して、POST /optout/status エンドポイントにアクセスします。

Integration Diagram

以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了しなければならない手順を示しています。

DII とは、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化され、SHA-256 ハッシュされたメールアドレスまたは電話番号を指します。

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

Advertiser Flow

図の各部分の詳細は、次のセクションを参照してください。

1: Generate Raw UID2s from DII

raw UID2 は、直接識別情報 (DII) から生成するか、広告主を代表してデータプロバイダーなどの他の UID2 参加者から UID2 を受け取ることができます。

raw UID2 を生成するには、以下のオプションのいずれかを使用します:

2: Store Raw UID2s and Salt Bucket IDs

Step 1 のレスポンス Generate Raw UID2s from DII には、マッピング情報が含まれています。以下の情報を保存することを勧めます:

  • DII (identifier) と raw UID2 (advertising_id)、ソルトバケット (bucket_id) のマッピングをキャッシュします。
  • レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の Monitor for Salt Bucket Rotations for Your Stored Raw UID2s で返される last_updated タイムスタンプと比較できます。

3: Manipulate or Combine Raw UID2s

Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます:

  • 操作する: たとえば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。
  • 既存のオーディエンスに新しい UID2 を追加する。

4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions

UID2 を以下の目的で使用します:

  • 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。
  • 計測のために raw UID2 を使用する。

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

また、計測（アトリビューション）やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。

5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s

raw UID2 は、特定の時点におけるユーザーの識別子です。raw UID2 は、ソルトバケットのローテーションにより、少なくとも年に一度変更されます。

各ソルトバケットは、約1年に1回更新されますが、個々のバケットの更新は年間を通じて分散されます。約 1/365 のソルトバケットが毎日ローテーションされます。このため、ソルトバケットのローテーションを定期的にチェックすることを勧めます。これは、オーディエンスの更新に合わせた頻度で行うことが望ましいです。たとえば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。

ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、Determine whether the salt bucket has been rotated を参照してください。

ソルトバケットのローテーションを監視する場合については、次のいずれかを参照してください:

:::note AWS Entity Resolution では、ソルトバケットの監視方法はありません。代わりに、AWS Entity Resolution サービスを使用して定期的に raw UID2 を再生成することができます。 :::

Determine whether the salt bucket has been rotated

特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。

  1. 2 つの値を比較します:

    • ソルトバケットのローテーション時に返された、同じ bucket_id の raw UID2 の last_updated タイムスタンプ。(選択したオプションによって返されたもの)

    • 同じ bucket_id の raw UID2 生成時のタイムスタンプ。Step 1 で返され、Step 2 で保存されたもの。

  2. last_updated タイムスタンプが、以前に記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その場合、この bucket_id に関連するすべての raw UID2 を再生成する必要があります。これには、Step 1 の Generate Raw UID2s from DII に従います。

6: Monitor for Opt-Out Status

ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの UID2 を引き続き使用しないようにしてください。

UID2 Operator Service で最新のオプトアウト情報があるかを確認する方法は 2 つあります:

  • POST /identity/map (v2) エンドポイイントを使用して、raw UID2 のオプトアウトステータスを確認します。オプトアウトされた DII には、raw UID2 は生成されません。

  • POST /optout/status エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認します。

UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法についての詳細は、User Opt-Out を参照してください。

FAQs

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