Google アド マネージャーでは、GPT SDK を使用してセキュア シグナルを収集し、ウェブ広告リクエストで送信することができます。モバイルアプリと動画広告枠の場合、GMA SDK と IMA* SDK をそれぞれ統合するには、通常、セキュア シグナル プロバイダまたは Google アド マネージャーのアダプタを使用する必要があります。
ただし、パブリッシャー様がモバイルアプリまたは動画（特にコネクテッド テレビ）で独自の広告リクエストを管理、作成する必要がある場合は、ご自身の責任のもとでこれらのセキュア シグナルを収集してリクエストに含めることも必要になります。
要件
- シグナルを JSON オブジェクトに組み入れる
- JSON オブジェクトをエンコードする
- エンコードされたシグナルを広告リクエスト URL に追加する
- （省略可）キャッシュ メカニズムを実装する
- Google アド マネージャーでシグナルの共有を設定する
パブリッシャー様が独自の広告リクエストを作成する場合、必要なセキュア シグナルを収集して含めるには、次の手順を行う必要があります。
1. シグナルを JSON オブジェクトに組み入れる
まず、セキュア シグナルのデータを収集して JSON オブジェクトの形式にする必要があります。この JSON では、送信するすべてのシグナルを記述する必要があります。セキュア シグナルは次のいずれかになります。
- サードバーティが生成: 外部のプロバイダが定義したシグナル。JSON で、
source（プロバイダの ID）とdata（ライブラリからの出力）を指定し、isPubCreatedをfalseに設定します。 - パブリッシャーが作成（カスタム）: パブリッシャーが定義したシグナル。この場合、
sourceは Google アド マネージャーのネットワーク コード、dataはカスタム シグナル、isPubCreatedはtrueとなります。
この JSON オブジェクトの例は次のようなものになります。
JSON です。1 つは SOURCE1 というサードパーティのシグナル プロバイダから提供されるシグナルです。もう 1 つはパブリッシャーのカスタム セキュア シグナルで、パブリッシャーのネットワーク コードにちなんで 123 という名前になっています。DATA1 は SOURCE1 シグナル プロバイダが提供する関数から取得され、DATA2 はパブリッシャーが作成した関数から取得されます。{
"signals": [
{
"source": "SOURCE1",
"data": "DATA1",
"isPubCreated": false
},
{
"source": "123",
"data": "DATA2",
"isPubCreated": true
} ]
}シグナル "source": "SOURCE1" はサードバーティが生成したシグナル
source: サードパーティ IdP のsource_idで、登録時にプロバイダにより共有（例: "liveramp.com"、"uidapi.com"、"pubcid.org"）data: シグナル プロバイダのライブラリ出力と、シグナルのコア ペイロード。isPubCreated:falseに設定
シグナル "source": "123" は、パブリッシャーが作成したカスタム セキュア シグナル
source: パブリッシャーのネットワーク コードdata: ビッダーがデコード可能なパブリッシャー作成のシグナル。シグナルは、Google に送信する前に難読化する必要があります。isPubCreated:trueに設定
オブジェクトを文字列に変換するためのメソッドには、ニーズと機能に応じて、さまざまなものがあります。主なメソッドの 1 つは、JSON.stringify() です。これは JavaScript オブジェクトを JSON 文字列にシリアル化するための関数です。この文字列は、送信可能なデータをテキストベースで正確に記述したものになります。
JSON.stringify() の実行後
{"signals":[{"source":"SOURCE1","data":"DATA1","isPubCreated":false},{"source":"123","data":"DATA2","isPubCreated":true}]}
2. JSON オブジェクトをエンコードする
json 文字列を作成したら、URL とファイル名で安全なアルファベットを使用した Base 64 エンコードに変換して、広告リクエスト URL に安全に追加されて送信されるようにする必要があります。
eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0
3. エンコードされたシグナルを広告リクエスト URL に追加する
最後に、広告リクエスト URL を作成し、エンコードされた文字列を ssj パラメータの値として追加します。ssj パラメータは、パブリッシャーが作成した、このセキュア シグナル JSON オブジェクトの送信専用です。
最終的な URL は次のようになります。
https://pubads.g.doubleclick.net/gampad/ads?iu=/12345678/video&description_url=...&ssj=your_Base64_encoded_string
4. （省略可）キャッシュ メカニズムを実装する
サーバーサイドのセキュア シグナルの実装では、キャッシュ メカニズムを実装することで送信時間を短縮できます。必須ではありませんが、このキャッシュの実装と管理はパブリッシャー様の責任で行っていただく必要があります。実装は、次の手順に沿って行う必要があります。
- シグナルを生成する: セキュア シグナル JSON オブジェクトを作成します。
- シグナルを保存する: エンコードされたシグナル文字列を保存するメカニズムを実装します（サーバーサイド キャッシュ、データベース、クライアント デバイスのローカル キャッシュなど）。保存方法はパブリッシャー様が選択できます。
- 有効期限を設定する: シグナルの有効期限として妥当な期間を決定します。これは、複数の広告リクエストを送信できる十分な期間、かつシグナルが古くならない期間にする必要があります。
- 取得して使用する: 新しい広告リクエストが必要な場合、システムではまずキャッシュが確認されます。期限切れになっていない有効なシグナルが存在する場合は、そのシグナルが取得され、広告リクエスト URL に追加されます。シグナルが期限切れになっているか、存在しない場合は、新しいシグナルが生成されて使用され、今後使用できるようキャッシュに保存されます。
5. Google アド マネージャーでシグナルの共有を設定する
最後に、Google アド マネージャーで、セキュア シグナルをビッダーやキュレーション パートナーと共有できるようにする必要があります。これを行うには、次のような手順に沿って操作します。
- Google アド マネージャーにログインします。
- [管理者]、[全般設定]、[Ad Exchange アカウントの設定] の順に移動します。
- 切り替えボタンをクリックして、[セキュア シグナルの共有] の利用規約に同意します。
-
[シグナル]、[セキュア シグナル] に移動します。
メニューが異なる場合このナビゲーションは更新中です。詳しい変更内容をご確認ください。関連するシグナルで、[ウェブ統合のデプロイ] 列の現在のデプロイ方法が [パブリッシャーによるデプロイ] に設定されていることを確認します。
注: GPT ベースのウェブ リクエストで、Prebid UserID モジュールも使用して同じシグナルを送信している場合、このメソッドは引き続き想定どおりに動作します。 -
[シグナル]、[デマンド チャネルの設定] に移動します。
メニューが異なる場合このナビゲーションは更新中です。詳しい変更内容をご確認ください。すべてまたは選択した認定バイヤーと Open Bidding パートナーにセキュア シグナルが送信されるようになっていることを確認します。
詳しくは、ビッダーやキュレーション パートナーとセキュア シグナルを共有するをご覧ください。