Protected Audience API

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

すべての Protected Audience API インタレスト グループにはオーナーが存在します。オーナーの種類によって、ユースケースの異なる様々なタイプのインタレスト グループを作成できます。

オーナーはユーザーのブラウザに対し、JavaScript 関数 navigator.joinadInterestGroup() を呼び出して、インタレスト グループに関連する広告に関するデータと入札に使用される JavaScript の URL などの情報を提供することで、インタレスト グループのメンバーシップを追加するように要求します。 インタレスト グループデータ（広告など）の更新は可能で、インタレスト グループは最大 30 日間有効にできます。

以下の表では、Protected Audience API のさまざまなタイプのインタレスト グループとオーナーの例を示しています。

Chrome では、オーナーあたり最大 1,000 個のインタレスト グループ、および最大 1,000 個のインタレスト グループオーナーを許可しています。これらはガードレールとしての役割を果たしており、通常の操作では到達することはありません。

Protected Audience API の買い手は、インタレスト グループを所有し、広告オークションに入札する者を指します。

たとえば、以下が該当します。

• 広告主: 広告主自体を代表します。
• デマンドサイド プラットフォーム（DSP）: 広告主に代わって機能します。
• インタレスト グループ オーナー: 複数の広告主のために使用されます。

買い手には 3 つのジョブがあります。

• オークションに参加するかどうかを選択すること
• 広告を選択して入札単価を計算すること
• オークションの結果を報告すること

これらのジョブは、Protected Audience API 広告オークション中に実行される買い手提供のコードによるプログラムで実行されます。

買い手がユーザーのブラウザに対して、それが属しているグループにインタレスト グループを追加するように要求する際（JavaScript 関数 navigator.joinadInterestGroup() を呼び出す）、買い手はブラウザに以下を提供します。

• 売り手が広告オークションを実施する際に使用する入札コードの URL。
• 場合によっては、インタレスト グループの広告クリエイティブの URL。（広告の URL は、後で更新によって追加される可能性があります。）
• オークション中に入札コードがリアルタイム データを取得できるようにするための、クエリ対象のデータ Key のリストと買い手の Key/Value サービスの URL。

買い手のコードには、オークションの結果を報告する reportWin() 関数を含めることもできます。

広告スペースを販売するためにオークションを開催する可能性のある当事者は複数存在します。

たとえば、以下が該当します。

• コンテンツ パブリッシャー: それ自体を代表し、自社サイトで広告コンテンツをホストします。
• サプライサイド プラットフォーム（SSP）: サイト運営者と連携し、他のサービスを提供します。
• サードパーティ スクリプト: サイト運営者を代表し、広告オークションへの参加を可能にします。

Protected Audience API では、売り手には次の 3 つのジョブがあります。

• サイト運営者ルールの実施: どの買い手とどの入札が対象であるか。
• オークション ロジックの実行: JavaScript をワークレットで実行して、各入札の望ましさのスコアを計算します。
• オークションの結果を報告すること

これらのジョブは、売り手が JavaScript 関数 navigator.runAdAuction() を呼び出して広告オークションを開始するときに提供するプログラムで実行されます。

以下の図は、Protected Audience API の広告オークションの各段階の概要を示しています: 拡大版を表示。

Protected Audience API の広告オークションは、広告を選択するためにブラウザがユーザーのデバイス上で実行する小さな JavaScript プログラムの集合体を指します。プライバシーを保護する目的で、売り手と買い手からのすべての広告オークション コードは、外部と通信できない分離された JavaScript ワークレットで実行されます。

売り手（サイト運営者またはサプライサイド プラットフォーム）は、広告スペースを販売するサイト（ニュースサイトなど）で Protected Audience 広告オークションを開始します。売り手は、オークションに参加する買い手を選択し、販売するスペースを示し、広告の追加基準を提供します。各買い手は、インタレスト グループのオーナーです。

売り手は、各買い手の値、広告クリエイティブの URL、および買い手ごとに返されたその他のデータを含む、入札をスコアリングするためのコードをブラウザに提供します。オークション中、買い手からの入札コードと売り手からの入札スコアリング コードは、Key/Value サービスからデータを受け取ることができます。広告が選択されて表示されると（プライバシーを保護する Fenced Frame に表示）、売り手と落札者はオークション結果を報告できます。

1. ユーザーが広告を表示するサイトにアクセスします。

2. 売り手のコードがオークションを開始します。売り手は、どの広告スペースを販売するか、誰が入札できるか、それらの入札のスコアリング方法を指定します。

3. 招待された買い手のコードが実行され、入札、関連する広告クリエイティブの URL、およびその他のデータが生成されます。入札スクリプトは、買い手の Key/Value サービスから、残りの広告キャンペーン予算などのリアルタイム データをクエリできます。

4. 売り手のコードが各入札をスコアリングし、落札者を選択します。このロジックは、入札値と他のデータを使用して入札の望ましさを返し、コンテキスト広告の落札者に勝てない広告を拒否します。売り手は、リアルタイム データに独自の Key/Value サービスを使用できます。オークションが始まる前に、売り手は利用可能な広告スロットに最適なコンテキスト広告を見つけます。

5. オークションの構成で resolveToConfig フラグが設定されている場合、落札した広告は Fenced Frame 構成オブジェクトとして返されます。この構成は、Fenced Frame が広告クリエイティブにアクセスするために使用されるため、売り手とサイト運営者のいずれもクリエイティブの URL を確認することはできません。resolveToConfig フラグが false に設定されている場合、または渡されていない場合、落札した広告は、iframe で広告をレンダリングするために使用できる不透明な URN として返されます。Fenced Frame 構成オブジェクトは、M114 以降で利用可能です。

6. オークションは、売り手と落札した買い手に報告されます。

Protected Audience API の Key/Value サービスを使用すると、アドテックは買い手が入札を行ったときにリアルタイム データをクエリし、売り手はプライバシーを保護しながら広告をスコアリングできます。Protected Audience API Key/Value サービスなどについて、Protected Audience API サービスをご覧ください。

Key/Value サービスはアドテック独自のクラウド インフラストラクチャに展開され、サービスは信頼できる実行環境で実行されます。Key/Value サービスへのリクエストは、イベントレベルのログを記録したり、その他の副作用を引き起こしたりすることはありません。Key/Value サービスは、アドテックが Key/Value サービス内で独自のカスタム ロジックを実行できるようにするユーザー定義関数（UDF）もサポートします。

買い手または売り手は、「キー」のリストを提供して、Protected Audience API Key/Value サービスから必要なデータを指定します。Key/Value サービスは、各キーの値で応答します。

Protected Audience API Key/Value サービス コードが Privacy Sandbox GitHub リポジトリで利用できるようになりました。このサービスは、Chrome および Android の開発者が使用できます。

Protected Audience API Key/Value サービスの詳細については、API の Explainer および信頼できるモデルの Explainer をご覧ください。

広告オークションの買い手または売り手はリアルタイム データにアクセスする必要がある場合があります。たとえば、買い手が広告キャンペーンの残りの予算を計算したい場合や、売り手が広告クリエイティブをサイト運営者のポリシーに照らしてチェックする必要がある場合があります。

Protected Audience API のプライバシー要件を満たすために、広告オークション中に必要なリアルタイム データは Key/Value サービスによって提供されます。各買い手が navigator.joinAdInterestGroup() を呼び出すと、買い手は Key/Value サービスの URL を指定し、オークション中にサービスに対してクエリされるキーを指定します。同様に、売り手が navigator.runAdAuction() を呼び出して広告オークションを実行すると、売り手は Key/Value サービスの URL を提供します。売り手の Key/Value サービスは、クリエイティブのレンダリング URL でクエリされます。

初期テストでは、 「Bring Your Own Server」モデルが使用されます。長期的には、アドテックはリアルタイム データを取得するために、信頼できる実行環境で実行されるオープンソースの Protected Audience API Key/Value サービスを使用する必要があります。

エコシステムがテストするのに十分な時間を確保するために、サードパーティの Cookie が廃止されるまでは、オープンソースの Key/Value サービスまたは信頼できる実行環境の使用が必要になるとは考えていません。この移行が行われる前に、開発者がテストと採用を開始できるのに十分な通知を行う予定です。

ファーストパーティ データは、サイトが所有するユーザーのデータです。たとえば、ユーザーが広告主またはサイト運営者のサイトで好みの色を指定した場合、その色はファーストパーティ データとみなされます。

Protected Audience オークションでは、広告主は自社のファーストパーティ データを使用して広告のインタレスト グループのメンバーシップを決定したり、データを userBiddingSignals としてインタレスト グループに渡したりできます。広告主のファーストパーティ データは、入札生成ステップ中に買い手のみが利用でき、売り手は利用できません。

たとえば、広告主がユーザーの好きな色を知っている場合、ユーザーがインタレスト グループに追加されるときに、その値をインタレスト グループの設定に userBiddingSignals として設定できます。

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

サイト運営者は、オークションの開始時にオークション構成にシグナルを設定することでファーストパーティ データを渡すこともでき、ファーストパーティ データを誰が受け取るかを制御できます。サイト運営者がファーストパーティ データを auctionSignals として渡すと、買い手と売り手の両方がそのデータを利用できるようになります。データが sellerSignals として渡された場合は売り手のみが利用でき、perBuyerSignals として渡された場合は指定された買い手のみが利用できます。サイト運営者は、ファーストパーティ データをコンポーネント オークションに渡すこともできます。サイト運営者とオークション参加者は、どのようなファーストパーティ データを共有する必要があるか、またデータをどのようにフォーマットする必要があるかについて、事前に合意する必要があります。

次の例は、サイト運営者からさまざまなオークション参加者にファーストパーティ データを渡す方法を示しています。

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);