このページは Cloud Translation API によって翻訳されました。

オーディエンスデータを定義する

Protected Audience API を使用してインタレストグループを作成し、オーディエンスを定義する方法をご確認ください。Protected Audience API のライフサイクル全体については、デベロッパーガイドをご覧ください。また、ブラウザがインタレストグループを記録する方法の詳細については、Protected Audience API の解説をご覧ください。

デベロッパー以外の方は、Protected Audience API の概要をご覧ください。

Protected Audience API インタレストグループ

Protected Audience API のインタレストグループは、共通の関心を持つユーザーのグループを表し、リマーケティングリストに対応します。すべての Protected Audience API インタレストグループにはオーナーがいます。

インタレストグループのオーナーは、Protected Audience API の広告オークションの購入者となります。インタレストグループのメンバーは、ブラウザとユーザーのデバイスに保存され、ブラウザベンダーや第三者と共有されることはありません。

API 関数

`joinAdInterestGroup()`

広告主のデマンドサイドプラットフォーム（DSP）または広告主自体が navigator.joinAdInterestGroup() を呼び出し、ブラウザのメンバーシップリストにインタレストグループを追加するようブラウザにリクエストします。

joinAdInterestGroup() の呼び出しコンテキストのオリジンは、インタレストグループオーナーのオリジンと一致している必要があります。そのため、インタレストグループオーナーのオリジンが現在のドキュメント（独自のインタレストグループを持つウェブサイトなど）と一致しない限り、joinAdInterestGroup() は iframe（DSP など）から呼び出す必要があります。

joinAdInterestGroup() に次の権限を許可する必要があります。

訪問先のサイト
インタレストグループのオーナー

つまり、dsp.example.com に権限を付与しない限り、malicious.example から dsp.example.com が所有するインタレストグループの joinAdInterestGroup() を呼び出すことはできません。

アクセスしたサイトからの権限

同じオリジンまたはクロスオリジンから権限を付与できます。デフォルトでは、アクセスしたサイトと同じオリジン（つまり、現在のページの最上位フレームと同じオリジン）からの joinAdInterestGroup() 呼び出しに権限が付与されます。

使用例

インタレストグループを定義し、ブラウザにグループに参加するようリクエストする方法の例を以下に示します。

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

関数に渡す interestGroup オブジェクトのサイズが 50 KiB を超えないようにする必要があります。50 KiB 以下の場合、呼び出しは失敗します。2 つ目のパラメータには、インタレストグループの期間（上限 30 日）を指定します。連続する呼び出しにより、以前に保存された値が上書きされます。

重要なポイント: Protected Audience API メソッドのパラメータとして使用される URL はすべて、安全なオリジンの URL でなければなりません。すべてのリソースは HTTPS URL で配信する必要があります。ローカルでの開発で HTTPS を使用する方法では、Protected Audience API をローカルで実行しているときに、これを行う方法について説明します。また、biddingLogicUrl、decisionLogicUrl、trustedBiddingSignals には X-Allow-FLEDGE: true HTTP レスポンスヘッダーが必要です。

必須プロパティ

インタレストグループの必須プロパティは owner と name のみです。

プロパティ	例	ロール
`owner`	`https://dsp.example`	インタレストグループオーナーのオリジン。
`name`	`custom-bikes`	インタレストグループの名前。

省略可能なプロパティ

残りのプロパティは省略可能です。

biddingLogicUrl^1、2: 例: https://dsp.example/bid/custom-bikes/bid.js; ロール: ワークレットで実行される入札 JavaScript の URL。
biddingWasmHelperUrl^1、2: 例: https://dsp.example/bid/custom-bikes/bid.wasm; ロール: biddingLogicUrl から実行される WebAssembly コードの URL。
updateUrl²: 例: https://dsp.example/bid/custom-bikes/update; ロール: インタレストグループの属性を更新するための JSON を返す URL。（オーディエンスデータの更新と広告の更新をご覧ください）。
trustedBiddingSignalsUrl²: 例: https://dsp.example/trusted/bidding-signals; ロール: ビッダーの信頼できる Key-Value サービスに対する Key-Value リクエスト用のベース URL。
trustedBiddingSignalsKeys: 例: ['key1', 'key2' ...]; ロール: Key-Value の信頼できる Key-Value サービスへのリクエスト用のキー。
userBiddingSignals: 例: {...}; ロール: オーナーが入札時に使用できる追加のメタデータ。
ads¹: 例: [bikeAd1, bikeAd2, bikeAd3]; 役割: このインタレストグループに対して表示される可能性のある広告。
adComponents: 例: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]; ロール: 複数の要素で構成される広告のコンポーネント。

¹ biddingLogicUrl プロパティと ads プロパティは省略可能ですが、オークションに参加するために必要です。これらのプロパティを指定せずにインタレストグループを作成する場合は、たとえば、まだ実施していないキャンペーンやその他の今後の用途のために、インタレストグループのオーナーがインタレストグループにブラウザを追加することや、広告予算が一時的に不足することが考えられます。

² Protected Audience API の現在の実装では、biddingLogicUrl、biddingWasmHelperUrl、updateUrl、trustedBiddingSignalsUrl のオリジンが所有者と同じである必要があります。これは長期的な制約ではないかもしれません。ads と adComponents の URL にはそのような制約はありません。

インタレストグループの広告を指定する

ads オブジェクトと adComponents オブジェクトには、広告クリエイティブの URL と、オプションで入札時に使用できる任意のメタデータが含まれます。

例:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

`leaveAdInterestGroup()`

インタレストグループのオーナーは、インタレストグループからブラウザを削除するようリクエストできます。ブラウザがメンバーシップリストからインタレストグループを削除します。

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

ブラウザに対してインタレストグループの追加を求めるサイトにユーザーが戻った場合、インタレストグループのオーナーは、navigator.leaveAdInterestGroup() 関数を呼び出して、ブラウザにインタレストグループを削除するようリクエストできます。

広告のコードでも、インタレストグループに対してこの関数を呼び出すことができます。

よくある質問

1 人のユーザーのグループオーナーごとのインタレストグループの最大数はいくつですか？

Chrome では、オーナーごとに最大 1,000 個のインタレストグループ、最大 1,000 個のインタレストグループオーナーを使用できます。これらの制限はガードレールであり、通常の運用中にはヒットするべきではありません。

k-匿名性のしきい値を満たすインタレストグループ広告を最大化するにはどうすればよいですか？

公開の解説に書かれているように、1 つのインタレストグループは複数の広告を同時に掲載できるため、グループでは別の広告の 1 つを再入札して「代替広告」として機能させることができます。最も望ましい選択肢がしきい値を下回った場合に通知を受け取ることができますつまり、k-匿名性の基準に満たない、小規模で特殊な広告でもオークションに参加でき、インタレストグループは、汎用性の高い広告にフォールバックして、十分な数のオーディエンスを確保できることを意味します。

戦術的な観点から、次のことを検討できます。

新しい広告の掲載を開始するには、掲載を希望するケースで入札を開始します。他に何もする必要はありません。
新しい広告が k-匿名性のない場合に、代替広告を使用できます。代替広告自体が匿名ではないというリスクがあるため、場合によっては、そもそも代替広告だけで入札することを検討してもよいでしょう。たとえば、一定の割合でフォールバックがしきい値を超えることが見込まれる場合は、全期間の 1% を対象に、このテストを行います。

他の機能についても最近議論されていますので、このメカニズムが問題を引き起こすユースケースがある場合は、API の改善方法についての一般公開の会話に引き続き関与してください。

すべての Protected Audience API リファレンス

API reference guides are available:

Developer guide for the Protected Audience API.
Ad buyer guide to Protected Audience interest groups and bid generation.
Ad seller guide to Protected Audience ad auctions.
Guide to reporting auction results
Best practices for Protected Audience ad auction latency
Troubleshoot Protected Audience

The Protected Audience API explainer also provides detail about feature support and constraints.

オーディエンス データを定義する

Protected Audience API インタレスト グループ