Protected Audience API: デベロッパー ガイド

クロスサイトのサードパーティ トラッキングを使用せずに、リマーケティング オーディエンスとカスタム オーディエンスを配信するデバイス上の広告オークションに関するデベロッパー ガイドです。

Protected Audience API を初めて使用する場合は、Protected Audience API の概要をご覧ください。 を参照してください。

この投稿は、デベロッパー向けの技術リファレンスとして、 Protected Audience API の試験運用版です。基本的な機能のデモ Protected Audience API のデプロイは、 広告の購入者と販売者向けの API リファレンス。

実装ステータス

如需接收有关 API 状态变更的通知，请加入开发者邮寄名单。

Protected Audience API とは

Protected Audience API はプライバシー サンドボックスの API であり、 リマーケティングとカスタム オーディエンスの使用 第三者がユーザーのトラッキングや サイト間での閲覧行動この API を使用すると、 ユーザーが以前アクセスしたウェブサイトに関連性の高い広告を選択する

Protected Audience API は、Chromium に実装された TURTLEDOVE プロポーザル ファミリー。

Protected Audience API を試す

利用可能な API リファレンス

このドキュメントでは、Protected Audience API の概要を説明します。特定の API メソッドとパラメータを検索する場合:

また、Protected Audience API の広告オークションの遅延に関するベスト プラクティスもご参照ください。

Protected Audience API のデモ

広告主とパブリッシャーによる Protected Audience API の基本的な導入手順を説明します protected-audience-demo.web.app/ で確認できます。

<ph type="x-smartling-placeholder">
</ph>
Protected Audience API のデモコードの仕組みと、Chrome DevTools を使用してデバッグする方法について詳しくは、こちらのエンドツーエンドのデプロイをご覧ください。

この API をテストする

1 人のユーザーを対象に Protected Audience API をテストするには、Chrome ベータ版 101.0.4951.26 以降で パソコン:

iframe またはフェンス付きフレームで広告をレンダリングする

広告は <iframe> または <fencedframe>（ 設定されます。

<fencedframe> を使用して広告を表示するには:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames

<iframe> を使用して広告を表示するには:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames

有効にするには、BiddingAndScoringDebugReportingAPI フラグを含めます。 一時的なデバッグの損失/落札の報告方法。

サポートされている機能

Chromium の機能フラグの背後にある Protected Audience API は、 次の機能が用意されています。

  • インタレスト グループ: 関連するメタデータとともにブラウザに保存され、 広告の入札とレンダリングを設定します
  • 購入者（DSP または広告主）によるオンデバイス入札: 保存済みの商品に基づく 関心グループと販売者からのシグナルです。
  • 販売者（SSP またはパブリッシャー）によるデバイス上の広告選択: オークションの入札額とメタデータを収集します。
  • 一時的に緩和された Fenced Frames バージョンでの広告レンダリング: 広告レンダリングのためにネットワーク アクセスとロギングが許可されていること。

機能のサポートと制約の詳細については、 Protected Audience API の解説

インタレスト グループの権限

Protected Audience API の現在の実装では、デフォルトで joinAdInterestGroup() ページ内のどこからでも（クロスドメインの iframe からでも）アクセスできます。

将来的には、サイト所有者が iframe 権限ポリシー、 クロスドメインの iframe からの呼び出しを許可しないことです。

Key-Value サービス

Protected Audience API の広告オークションをサポートするため、ブラウザは Key-Value サービス Protected Audience API 広告オークションをサポートするリアルタイムの情報を取得できます。この 情報はさまざまな用途に利用できます。

  • 購入者によっては、広告キャンペーンの残りの予算を計算したい場合があります。
  • 販売者は、広告クリエイティブをパブリッシャーのポリシーと照合することが必要になる場合があります。

Protected Audience API の Key-Value サービスコード をご利用いただけるようになりました。ステータスの最新情報については、お知らせのブログ投稿をご覧ください。

最初のテストとして、Bring Your Own Server（Bring Your Own Server） モデルが導入されました。長期的には、広告テクノロジーは オープンソースの Protected Audience API の Key-Value サービスを高信頼実行で実行 必要があります。

Protected Audience API サービスのブログ投稿をご覧ください。 ご確認ください。デベロッパーの皆様には、 テストと導入を完了する必要があります。

検出機能のサポート

API を使用する前に、その API がブラウザによってサポートされていて、 説明します。

'joinAdInterestGroup' in navigator &&
  document.featurePolicy.allowsFeature('join-ad-interest-group') &&
  document.featurePolicy.allowsFeature('run-ad-auction') ?
  console.log('navigator.joinAdInterestGroup() is supported on this page') :
  console.log('navigator.joinAdInterestGroup() is not supported on this page');

Protected Audience API の仕組み

この例では、ユーザーがカスタム自転車メーカーのウェブサイトを閲覧し、その後 ニュース サイトにアクセスしたときに、自転車メーカーの新しい自転車の広告が表示される。

Protected Audience API の機能は、実装作業の進捗に応じて追加される予定です。

1. ユーザーが広告主のサイトにアクセスした

ノートパソコンのブラウザでカスタム自転車メーカーのサイトにアクセスする人。

ユーザーがカスタム自転車メーカー（広告主）のウェブサイトにアクセスしたとします。 ハンドメイドのスチールの製品ページで ありますこれにより 自転車メーカーは リマーケティングの機会を増やす。

2. ユーザーのブラウザにインタレスト グループの追加を求められる

ユーザーがノートパソコンでブラウザを開いてサイトにアクセスします。JavaScript 広告インタレスト グループに参加するためのコードがブラウザで実行されています。

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

この例では、グループの名前は custom-bikes、オーナーは dsp.example です。インタレスト グループの所有者（この場合は DSP）が購入者になります。 オークションにかけられるようになりましたインタレスト グループのメンバー情報はブラウザに保存され、 ユーザーのデバイス上のデータで、ブラウザ ベンダーや第三者と共有されることはありません。

で確認できます。

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

ads オブジェクトと adComponents オブジェクトには、広告クリエイティブの URL が含まれます。 （省略可）入札時に使用できる任意のメタデータ。例:

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

購入者はどのように入札しますか？

generateBid() は、ブラウザがメンバーとなっているインタレスト グループごとに呼び出されます。 - インタレスト グループの所有者を入札に招待した場合。

generatedBid() のデベロッパー向けドキュメントを読む。

3. ユーザーが広告スペースを販売するサイトにアクセスする

ノートパソコンのブラウザでニュース ウェブサイトにアクセスする人物。サイト 空の広告スロットがあります。

その後、このユーザーは広告スペースを販売するサイトにアクセスします。この例では、ニュース 確認できますサイトには広告枠があり、プログラマティックに販売します。 リアルタイム ビッダー

4. 広告オークションがブラウザで行われる

ノートパソコンのブラウザでニュース ウェブサイトを閲覧している人。利用可能な広告スペースに適した広告を選ぶために、Protected Audience API の広告オークションが実施されます。

広告オークションは、パブリッシャーのサプライサイド プロバイダによって行われる可能性が高い。 （SSP）、パブリッシャー自体のいずれかです。オークションの目的は 現在のページで利用可能な 1 つの広告スロットに最も適した広告。「 ブラウザが属しているインタレスト グループ、 広告スペースの購入者と販売者から得たデータを Key-Value サービス。

5. 販売者と参加している購入者が Key-Value サービスからのリアルタイム データをリクエストする

ユーザーがノートパソコンのブラウザでニュース ウェブサイトを閲覧します。広告 Protected Audience API を使用するオークションが行われており、参加者は Key-Value サービスからデータを取得しています。

広告オークションの際、販売者は特定の広告に関するリアルタイム データをリクエストできる Key-Value サービスにリクエストを送信してクリエイティブを作成します。 販売者はこの情報をリクエストできる trustedScoringSignalsUrl プロパティで runAdAuction() ads のすべてのエントリの renderUrl プロパティのキーとともに、 および adComponents フィールド。

購入者は、API 呼び出しを使用して Key-Value サービスからリアルタイム データを trustedBiddingSignalsUrl プロパティと trustedBiddingSignalsKeys プロパティ navigator.joinAdInterestGroup() に渡されるインタレスト グループ引数。

runAdAuction() が呼び出されると、ブラウザは各広告にリクエストを送信します 購入者の信頼できるサーバーに送信する必要がありますリクエストの URL は次のようになります。

https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2
  • ベース URL は trustedBiddingSignalsUrl から取得されます。
  • hostname はブラウザによって提供されます。
  • keys 値は trustedBiddingSignalsKeys から取得されます。

このリクエストのレスポンスは、 できます。

で確認できます。

6. 落札した広告が表示される

ノートパソコンのブラウザでニュース ウェブサイトを閲覧している人。広告 安全なフェンスで囲まれた 自転車が 20% オフ

オークション構成で resolveToConfig フラグが true に設定されている場合、runAdAuction() から返される Promise はフェンス付きフレーム構成オブジェクト（FencedFrameConfig）に解決されます。落札広告にフレームを移動するために、フェンス付きフレームでフレーム構成が使用されますが、広告の URL はフレーム埋め込みツールには表示されません。

フェンス付きフレーム構成オブジェクトは M114 以降で使用できます。FencedFrameConfig オブジェクトについて詳しくは、Chrome のブログ記事をご覧ください。

7. オークション結果がレポートされる

長期的な計画では、ブラウザから Private Aggregation API を使用する販売者と購入者。

一時的なイベントレベルのレポート メカニズムとして、 販売者の reportResult()、落札者の reportWin() が、 sendReportTo() 関数を呼び出します。この引数は 1 つの引数を取ります。 はオークションの完了後に取得される URL で、 イベントレベルの情報を指定します。

8. 広告のクリックが報告される

ニュースサイトで、フェンス付きフレームが埋め込まれた自転車の広告をクリックした人物。レポートデータが販売者と購入者に送信されます。

フェンス付きフレーム内に表示された広告のクリックが報告されます。詳細情報 この仕組みについては、フェンス付きフレーム広告のレポートをご覧ください。

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder"></ph> Protected Audience API 広告オークションの各段階の概要
この図は、Protected Audience API オークションの各ステージの概要を示しています。

Protected Audience API と TURTLEDOVE の違いは何ですか？

Protected Audience API は、Chromium に実装された TURTLEDOVE プロポーザル ファミリー。

Protected Audience API は、TURTLEDOVE の基本原則を遵守しています。オンライン広告には 過去に興味を持ちそうなユーザーに 過去に広告主や広告ネットワークと接点があったこれまでは ウェブサイトでブラウジング中の特定の人物を という、昨今のウェブにおけるプライバシーの重要な懸念の一つです。

TURTLEDOVE の取り組みは、このユースケースに対処するための新しい API を提供することです 次のような重要な進歩を遂げています。

  • トラフィックに関する情報は、広告主ではなくブラウザが保持します。 ユーザーが関心を持っていると判断した場合
  • 広告主は興味 / 関心に基づいて広告を配信できるが、これらを組み合わせることはできない 特定の人物に関する他の情報（特にその人物の人物）に どのページにアクセスしているかを把握できます

Protected Audience API は、TURTLEDOVE と、 API を使用するデベロッパーにとって有益なものになるよう修正しました。

  • [SPARROW] で次のようにします。 Criteo が追加を提案しました 高信頼実行環境（TEE）で実行される（「Gatekeeper」）サービスモデル。Protected Audience API では、リアルタイムのデータ検索と集計レポート用に、TEE がより限定的に使用されています。
  • NextRoll の TERN と Magnite の PARRROT 提案では、市場における購入者と販売者のさまざまな役割が 決定しますProtected Audience API の広告の入札とスコアリングのフローは、この仕組みに基づいています。
  • RTB House の結果ベース および商品レベル TURTLEDOVE の改変により匿名性モデルとパーソナライズが改善された オンデバイスオークションの機能
  • PARAKEET は プロキシに依存する TURTLEDOVE のような広告サービスに関する Microsoft の提案 ブラウザと広告テクノロジー プロバイダの間の TEE で実行されるサーバーを介して、 広告リクエストの匿名化とプライバシー保護の強化 プロパティです。Protected Audience API では、このプロキシモデルを採用していません。Google は PARAKEET の JavaScript API と Protected Audience API との連携が 両方の提案の長所を組み合わせます

Protected Audience API では、ユーザーに表示される広告をウェブサイトの広告ネットワークが学習することはまだ阻止されていません。今後、この API はプライバシー保護を強化するよう変更される予定です。

Topics API を Protected Audience API で使用できますか？

はい。現在のユーザーについて確認されたトピック（Topics API により提供）は、次のような用途に使用できます。 コンテキスト情報を使用します。トピックは 次のプロパティがあります。

  • auctionSignals: navigator.runAdAuction() に渡されるオークション設定オブジェクトのプロパティ
  • userBiddingSignals: インタレスト グループの設定のプロパティ navigator.joinAdInterestGroup() に渡されるオブジェクト

使用可能なブラウザ構成

ユーザーは次の方法で、Chrome のプライバシー サンドボックスのトライアルへの参加を調整できます。 最上位の設定を有効または無効にするには chrome://settings/adPrivacy。

初期テストでは、この高度なプライバシー機能を使用できます。 Protected Audience API をオプトアウトするためのサンドボックス設定。Chrome では今後、ユーザーが Google のアプリや ウェブ全体で追加されたインタレスト グループのリストを管理する 確認できます。プライバシーサンドボックス技術自体と同様に ユーザー設定は、ユーザーや規制当局などからのフィードバックに応じて進化する可能性があります。

Chrome の設定は、テストやフィードバックに基づいて継続的に更新されます。 将来的には、Protected Audience API と 関連付けられています

ユーザーがシークレット モードでブラウジングしている場合、API 呼び出し元はグループ メンバーにアクセスできません。 ユーザーがサイトのデータを消去すると、メンバーシップは削除されます。

Protected Audience ワークレットはブラウザによってキャッシュに保存されていますか？

Protected Audience ワークレット（購入者の入札生成とレポートのワークレット、販売者の広告スコアリングとレポートのワークレット）を含むリソースは、ブラウザによってキャッシュに保存されます。Cache-Control ヘッダーを使用してキャッシュ動作を制御できます。

対応してフィードバックを共有する

サポートを受ける

実装、デモ、プログラムについて質問したりサポートを受けたりするには、 ドキュメントをご覧ください。

Protected Audience API でニーズを満たすことに関する一般的な質問については、 API リポジトリで問題を報告してください。 また、W3C の ウェブ広告ビジネス グループの改善

プライバシー サンドボックスのフィードバック フォームをご利用ください を使用して、公開フォーラム以外の Chrome チームと非公開でフィードバックを共有できます。

オプトアウト

Protected Audience API をオプトアウトしますか？手順 Protected Audience API へのアクセスをブロックする サイト所有者または個人ユーザーとして 管理できます

最新情報を入手