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

Google Ad Manager Secure Signals Integration Guide

このガイドでは、UID2 を Google Ad Manager のセキュアシグナル機能 (旧称: Encrypted Signals for Publishers、ESP) で使用するパブリッシャー向けのインテグレーション手順について説明します。

注記

UID2 Google Ad Manager セキュアシグナルインテグレーションを使用するには、SDK を使用している場合、UID2 インテグレーションがすでに設定されている必要があります。サーバーのみのインテグレーションを使用している場合は、この限りではありません。使用可能なすべてのインテグレーションオプションの概要は、UID2 Integration Guides: Summary を参照してください。

Overview​

Google secure signals は、パブリッシャーが Google Ad Manager と Google Ad Manager Ad Exchange (AdX) を通じて、Google が承認したビッダーに対して「暗号化」したユーザー ID を渡すための方法です。このフレームワークは、パブリッシャーが一般的に使用する Google Publisher Tag (GPT)ライブラリのオプションパーツとして提供されています。

このフレームワークでは、次のようなステップを踏みます:

  1. パブリッシャーは、ユーザー ID シグナル (Advertising Token) をセキュアシグナル機能にプッシュします。
  2. セキュアシグナル機能は、Client-Side でそれらをキャッシュし、Google Ad Manager に透過的に渡します。
  3. Google Ad Manager は UID2 Token を使ってビッドリクエストを行い、パブリッシャーの設定に基づき Google AdX 内の承認済み入札者にトークンを転送します。

Allow Secure Signals Sharing​

Google Ad Manager アカウントで暗号化 UID2 Token を受け取るには、暗号化されたシグナルが Google Ad Manager アカウントで第三者の入札者と適切に共有されていることを確認する必要があります。

詳しくは、Google ドキュメントの Share encrypted signals with bidders を確認し、Use a third-party signal provider の手順に従って、シグナルプロバイダーとして UID2 をオンに設定してください。

important

手順に従う際、Select allowed secure signals の Web Signal Deploy Option で Google Deploy を選択してください。Prebid.js を使用している場合は、Optional: Enable Secure Signals in Prebid.js を参照してください。

Optional: Enable Secure Signals in Prebid.js​

Prebid.js で Secure Signals を使用する場合は、UID2 が正しく処理されるように、次の追加手順を完了する必要があります:

  1. Google Ad Manager で、暗号化されたシグナルがサードパーティの入札者と適切に共有されていることを確認する際: Prebid User ID Module を選択し、Use your Prebid configuration to automatically configure your Secure signals settings も選択します。設定を保存する前に、正しいオプションを選択したことを再確認してください。

  2. Prebid.js のセットアップ: 次のコードに示すように、Prebid 構成内の encryptedSignalSources セクションを更新します。

    "encryptedSignalSources": {
      "sources":[
        {
          "source":[
            "uidapi.com"
          ],
          "encrypt":false
        }
      ]
    }

    For details, see ESP Configurations in the Prebid documentation.

Publisher Integration​

暗号化されたシグナルがキャッシュされると、セキュアシグナル機能は、新しいシグナルを生成するためのハンドラを実行しません。このため、データキャプチャの前後にキャッシュをクリアする必要があります。

セキュアシグナル機能は特定の ID を削除したり無効にしたりする方法を提供しないので、パブリッシャーはデータキャプチャのワークフローの一部として、window.googletag.secureSignalProviders.clearAllCache() 関数を呼び出して、共有された暗号化シグナルすべてをクリアしなければなりません。

以下は window.googletag.secureSignalProviders.clearAllCache() 関数の呼び出しの例です:

window.googletag = window.googletag || { cmd: [] };
window.googletag.cmd.push(function () {
  window.googletag.secureSignalProviders =
    window.googletag.secureSignalProviders || [];
  window.googletag.secureSignalProviders.clearAllCache();
});

Server-Side Integration​

暗号化されたシグナルを共有できるように、ホストされ、自動ロードされたセキュアシグナルスクリプトは window.getUid2AdvertisingToken 関数を非同期に呼び出し、そのレスポンスとして advertising_token を文字列として受け取れるようにしなければなりません。

ID トークンがフレッシュであることを確認することが重要です。Server-Sideのインテグレーションでは、POST /token/refresh というエンドポイントを呼び出し、JSON レスポンスから新しい Advertising Token を取得することが推奨されます。

次のコードは、その例です。

window.getUid2AdvertisingToken = async () => {
  // Make a call to get a fresh identity token which could last for at least 12 hours.
  const identity = await getFreshIdentity()
  return JSON.parse(decodeURIComponent(identity)).advertising_token
}

詳しくは、Server-Only UID2 Integration Guide を参照してください。

Server Only インテグレーションのためのサンプルアプリケーションも用意されています。Sample Implementations を参照してください。

SDK for JavaScript Client-Side Integration​

SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID2 セキュアシグナルスクリプトは、SDKで提供されている getAdvertisingTokenAsync 関数を使用して新しい Advertising Token を取得し、そのトークンを Google Ad Manager にプッシュします。

このスクリプトは CDN でホストされており、GPT はセキュアシグナル機能で自動的にロードします。

詳しくは Client-Side Integration Guide for JavaScript を参照してください。

SDK for JavaScript を使用したインテグレーションのためのサンプルアプリケーションも用意されています。Sample Implementations を参照してください。

Sample Implementations​

Google Ad Manager のセキュアシグナル機能との連携方法については、以下のサンプルアプリケーションを参照してください:

各サンプルアプリケーションには独自のインストラクションがあります。

Troubleshooting​

UID2 インテグレーションで Google Secure Signals を使用する際に役立つトラブルシューティング情報です:

I enabled Secure Signals within Google Ad Manager, but UID2s are not being passed through Google​

Google Ad Manager で Secure Signals を有効にした後、Google を介して正常な UID2 が渡されない場合があります。これは、参加者が誤った Web Signal Deployment Method 構成を持っている場合があります。

UID2 が Google を介して渡されない場合は、セットアップ時に正しい Web Signal Deployment Method を選択したことを確認してください。

詳細は、Allow Secure Signals Sharing の Important ノートを参照してください。