Frequently Asked Questions
UID2 に関するよくある質問は、以下のカテゴリーに分かれています:
FAQs—General
UID2 フレームワークに関するよくある質問を紹介します。
- EUID インフラのすべてのインテグレーションパートナー(SSP、サードパーティデータプロバイダー、測定プロバイダー)は、自動的に UID2 にインテグレーションされますか?
- ユーザーは、自分の UID2 ID に基づいたターゲティング広告をオプトアウ トできますか?
- UID2 に DII を送信すると、UID2 はその情報を保存しますか?
- UID2 は HIPAA で規制されているデータの処理を許可しますか?
モバイルパブリッシャーインテグレーションに関する FAQs については、FAQs for Mobile Integrations を参照してください。
Will all integration partners in the EUID infrastructure (SSPs, third-party data providers, measurement providers) be automatically integrated with UID2?
EUID インフラのすべてのインテグレーションパートナー(SSP、サードパーティデータプロバイダー、測定プロバイダー)は、自動的に UID2 にインテグレーションされますか?
いいえ。UID2 は EUID とは別の独自のフレームワークとして機能します。そのため、EUID フレームワークへのアクセスや使用に関する事務手続きは、UID2 フレームワークへの使用やアクセスを自動的に許可するものではありません。新規契約を UID2 用に締結する必要があります。
Can users opt out of targeted advertising tied to their UID2?
ユーザーは、自分の UID2 ID に基づいたターゲティング広告をオプトアウトできますか?
はい。Transparency and Control Portal を通して、ユーザーは自分の UID2 ID に関連するターゲティング広告の配信をオプトアウトできます。各リクエストは、UID2 Opt-Opt Service と UID2 Operator を通じて配信され、UID2 Operator はオプトアウト情報を関連するすべての参加者に公開します。
When I send DII to UID2, does UID2 store the information?
UID2 に DII を送信すると、UID2 はその情報を保存しますか?
いいえ。UID2 service のコンポーネントは、DII を保存しません。
さらに、ほとんどの場合、UID2 は、POST /token/generate、POST /token/refresh、または POST /identity/map の呼び出しが完了すると、値を全く保存しません。必要な例外は、ユーザーがオプトアウトした場合です。この場合、UID2 は、オプトアウトしたユーザーを示すハッシュ化された不透明な値を保存します。保存された値は、DII から生成された同じ UID2 に関する将来のリクエストを識別するために使用され、そのため拒否されます。
Does UID2 allow the processing of HIPAA-regulated data?
UID2 は HIPAA で規制されているデータの処理を許可しますか?
いいえ。UID2 の参加者は、HIPAA (Health Insurance Portability and Accountability Act of 1996;医療保険の携行性と責任に関する法律) で定義されている、保護対象 保険情報 (PHI: Protected Health Information) から UID2 を生成してはなりません。
FAQs for Publishers
UID2 フレームワークを使用するパブリッシャーからのよくある質問です。
- 送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか?
- トークンを復号化する必要がありますか?
- ユーザーのオプトアウトはどのように通知されますか?
- トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか?
- Client-Side からトークンのリフレッシュを呼び出すことはできますか?
- トークンを手動でリフレッシュする場合、リフレッシュのタイミングをどう判断すればよいですか?
- Refresh Token のワークフローをテストするにはどうすればよいですか?
- UID2 Token の一意性とローテーションポリシーは何ですか?
- UID2 Token は、ビッドストリームではどのように見えますか?
How can I test that the DII sent and the returned token match up?
送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか?
POST /token/validate エンドポイントを使用して、POST /token/generate で送信している DII が有効かどうかをチェックできます。POST /token/validate
は主にテスト目的で使用されます。
詳細は Using POST /token/validate to Test を参照してください。
Do I need to decrypt tokens?
トークンを復号化する必要がありますか?
いいえ、パブリッシャーは UID2 token を復号化する必要はありません。しかし、社内でのみ使用するために raw UID2 にアクセスしたい場合は、UID2 support と協力してアクセスしてください。
How will I be notified of user opt-out?
ユーザーのオプトアウトはどのように通知されますか?
ユーザーがオプトアウトした場合、API レスポンスは以下のいずれかのケースで通知します:
- 直接または UID2 SDK のいずれかで POST /token/generate エンドポイントを呼び出し、UID2 Token を生成する場合、必須の
optout_check
パラメータに1
を指定します。 - 直接または UID2 SDK のいずれかで POST /token/refresh エンドポイントを呼び出し、UID2 Token をリフレッシュした場合。
Where should I make token generation calls—from the server side or the client side?
トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか?
UID2 Token は、Client-Side、Server-Sideのどちらでも生成できます。詳細については、以下を参照してください:
- Prebid.js を使用して Client-Side からトークンを生成します: UID2 Client-Side Integration Guide for Prebid.js.
- Prebid.js を使用して Server-Side からトークンを生成します: UID2 Client-Server Integration Guide for Prebid.js.
- その他の Server-Side オプション: Publisher Integrations.
Can I make token refresh calls from the client side?
Client-Side からトークンのリフレッシュを呼び出すことはできますか?
はい。POST /token/refresh は、API Key を使用する必要がないため、Client-Side (例えば、ブラウザやモバイルアプリ) から呼び出すことができます。
If I choose to manually refresh the token, how will I know when to refresh the token?
トークンを手動でリフレッシュする場合、リフレッシュのタイミングをどう判断すればよいですか?
推奨されるリフレッシュ間隔は 1 時間です。
リフレッシュのタイミングを決定するには、POST /token/generate エンドポイントのレスポンスの refresh_from
フィールドのタイムスタンプを使用します(詳細は Successful Response を参照してください)。または、POST /token/refresh エンドポイントのレスポンスの refresh_from
フィールドのタイムスタンプを使用します(詳細は Successful Response With Tokens を参照してください)。
トークンのリフレッシュが必要かどうかを確認する機能を持つ SDK のいずれかを使用することもできます。
詳細は、Recommended Token Refresh Frequency および Managing Token Refresh with an SDK を参照してください。
How can I test the refresh token workflow?
Refresh Token のワークフローをテストするにはどうすればよいですか?
refresh-optout@example.com
のメールアドレスまたは +00000000002
の電話番号を使用して、トークンリフレッシュのワークフローをテストすることができます。どちらかのパラメータ値をリクエストに使用すると、常に refresh_token
を含む identity レスポンスが生成され、ログアウトレスポンスが返されます。
SDKを使うかどうかで手順は少し異なります。
With SDK:
- DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して POST /token/generate リクエストを送信します:
email
の値としてrefresh-optout@example.com
を指定します。- ``refresh-optout@example.com
のハッシュを
email_hash` 値として指定します。 phone
の値として+00000000002
を指定します。phone_hash
値として+00000000002
のハッシュを指定します。
- SDK の background auto-refresh が Advertising Token のリフレッシュを試み(これには数時間かかることがあります)、リフレッシュの試みが
OPTOUT
ステータスで失敗するのを観察するまで待ちます。この時点で SDK はファーストパーティクッキーもクリアします。
Without SDK:
- DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して POST /token/generate リクエストを送信します:
email
の値としてrefresh-optout@example.com
を指定します。refresh-optout@example.com
のハッシュをemail_hash
値として指 定します。phone
の値として+00000000002
を指定します。phone_hash
値として+00000000002
のハッシュを指定します。
- 返された
refresh_token
を次のステップで使用するために保存します。 - POST /token/refresh リクエストを
refresh_token
(Step 2 で保存) をtoken
値として送信します。
ボディのレスポンスは空でなければならず、refresh-optout@example.com
のメールアドレスと+00000000002
の電話番号は常にログアウトしたユーザになるので、status
の値はoptout
でなければなりません。
What is the uniqueness and rotation policy for UID2 tokens?
UID2 Token の一意性とローテーションポリシーは何ですか?
UID2 Service は、ランダムな初期化ベクトルを使用して UID2 Token を暗号化します。UID2 Token は、ユーザーがインターネットを閲覧する際に、特定のユーザーに対して一意になります。つまり、UID2 Token が生成されるたびに、同じ UID2 であっても常に異なるトークンが生成されます。トークンが更新されるたびに新しいトークンが生成され、暗号化されます。
What does a UID2 token look like in the bidstream?
UID2 Token は、ビッドストリームではどのように見えますか?
UID2 実装のアプローチにはさまざまな方法があります。以下は、UID2 Token がビッドストリームでどのように渡されるかを示すコードスニペットの一例です:
{
"user": {
"ext": {
"eids": [
{
"source": "uidapi.com",
"uids": [
{
"id": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
"rtiPartner": "UID2"
}
]
}
]
}
}
}
FAQs for Advertisers and Data Providers
UID2 フレームワークを使用する広告主やデータプロバイダーによくある質問を紹介します。
- ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには?
- 更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか?
- インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか?
- マッピング用の DII の SHA-256 はどのように生成すればよいですか?
- 大量のメールアドレスや電話番号やそれらのハッシュマッピングを保存すべきか?
- ユーザーのオプトアウトはどのように処理すればよいですか?
- 同じ DII は常に同じ生UID2になりますか?
- 2 つの Operator が同じ DII を処理した場合、結果は同じになりますか?
How do I know when to refresh the UID2 due to salt bucket rotation?
ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには?
UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用されるソルトバケットが含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎的な DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、POST /identity/buckets エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。
ローテーションがいつ行われるかについては、いかなる約束もいたしません。可能な限り最新の状態を保つため、1 時間に 1 回のチェックを勧めます。
Do refreshed emails get assigned to the same bucket with which they were previously associated?
更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか?
必ずしもそうとは限りません。特定のバケット ID に関連付けられたメールアドレスを再マッピングした後、そのメールが異なるバケット ID に割り当てられる可能性があります。バケット ID を確認するには、マッピング関数を呼び出す そして返された UID2 とバケット ID を再び保存してください。
メールアドレスのマッピングや再マッピングを行う際には、バケットの数やローテーションする日、メールアドレスが割り当てられる特定のバケットについて、いかなる仮定も行わないようにしてください。
How often should UID2s be refreshed for incremental updates?
インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか?
オーディエンスの更新は、毎日行うことが推奨されています。
ソルトバケットは 1 年に 1 回程度更新されますが、個々のバケットの更新は 1 年に分散して行われます。これは、全バケットの約 1/365 が毎日ローテーションされることを意味します。もし忠実さが重要であれば、POST /identity/buckets エンドポイントをもっと頻繁に、例えば 1 時間ごとに呼び出すことを検討してください。