プライバシー サンドボックスの広告の関連性と測定に関する API をテストする

プライバシー サンドボックスには、クロスサイト トラッキングを必要とせずに広告のユースケースを可能にする一連の提案が含まれています。オリジン トライアルでは、デベロッパーが実際のテストを通じて新しいウェブ テクノロジーを評価し、フィードバックを提供できます。以前のオリジン トライアルでは、サイトが個々の API に対してテストできました。Topics、FLEDGE、Attribution Reporting API については、サイトで API 全体で統合テストを実行し、エンドツーエンドの広告ライフサイクルの初期バージョンを形成できる単一オリジン トライアルを提供しています。API は Chrome 101 ベータ版以降でテストできます。Chrome 101 ベータ版リリースでは、ユーザー コントロールの更新も行われています。これは、設定オプションのイテレーションによるものです。

デベロッパーは、この単一オリジン トライアルに登録して、Topics、FLEDGE、Attribution Reporting API でテストを行うことができます。このガイドでは、API にアクセスするための構成手順、構成の検証方法、API をテストするためのその他のリソースについて説明します。

オリジン トライアルの内容

このオリジン トライアルの目的は、複数のサイトで広告のライフサイクル全体を通して有意義なテストを実施できるようにすることです。このジャーニーをカバーするために、オリジン トライアルには次のものが含まれます。

  • Topics: document.browsingTopics() を介してブラウザのトピックを監視し、アクセスします。
  • FLEDGE では、ブラウザのインタレスト グループと、そのグループやその他のシグナルに基づく広告の入札と選択を管理できます。
    • このオリジン トライアルでは、FLEDGE をパソコンで利用でき、提案されたすべての機能のサブセットが含まれています。詳しくは、FLEDGE オリジン トライアルの詳細をご覧ください。
  • フェンス付きフレーム。FLEDGE 広告オークションの落札者の不透明 URL をレンダリングします。
  • Attribution Reporting: 広告のライフサイクル全体にわたってパフォーマンスを測定し、レポートします。
    • アトリビューション レポートの一部として、サマリー レポートを生成するには、集計可能レポートを集計サービスによって処理および集計する必要があります。ローカル テストとオリジン トライアル テスト用の追加のツールとガイドがまもなく公開される予定です。
    • Attribution Reporting の以前のオリジン トライアルに参加したことがある場合は、最新の API の変更に合わせて更新する必要があることにご注意ください。詳しくは、移行ガイドをご覧ください。

この設定では、これらすべての API にわたる統合テストが可能になりますが、実装するアスペクトをニーズに合わせて選択できます。

デベロッパーがオリジン トライアルに登録するにはどうすればよいですか？

プライバシー サンドボックスの関連性と測定の試用版に登録する。次の HTML タグを使用して、API コードを実行するすべてのページにトライアル トークンを指定します。

  • トップレベル ページの <head> セクションの <meta> タグ: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • トップレベルのページ レスポンスの HTTP ヘッダー: Origin-Trial: TOKEN_GOES_HERE

オリジン トライアルで利用できる一部の機能は、トップレベル サイトでサードパーティとしてサービスを提供する場合など、クロスサイト コンテキストで使用することを目的としています。これらの追加のコンテキストでオリジン トライアルを有効にする必要がある場合は、「サードパーティ マッチング」のオプションを選択してください。サードパーティの JavaScript からオリジン トライアルを有効にするには、スクリプトからトップレベルのページ（つまり、独自のコンテンツではなくファースト パーティのページ）に <meta> タグを挿入します。次に例を示します。

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

詳しくは、Chrome のオリジン トライアルのスタートガイドをご覧ください。

デベロッパーがローカルでテストする方法

Topics、FLEDGE、Attribution Reporting の個別のデベロッパー向けドキュメントには、各 API のローカル デベロッパー テストに関する具体的なガイダンスが記載されています。これらの API はデフォルトでは有効になっていないため、テスト用にフラグを指定して有効にする必要があります。

テスト用の API を有効にするには、次のことを行う必要があります。

  • Chrome 101 ベータ版以降を使用している。
    • FLEDGE を使用するには、デスクトップ Chrome が必要です。
    • API は iOS 版 Chrome ではご利用いただけません。
  • chrome://flags/#privacy-sandbox-ads-apis フラグを使用して API を有効にします。
    • このフラグを使用すると、テストを容易にするために API が有効になります。追加の設定で API を無効にできるオリジン トライアル ユーザーを複製したい場合は、CLI フラグ --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs を使用して Chrome を起動する必要があります。
    • API によっては、さらに詳細な構成が可能な追加のフラグがある場合があります。詳細については、個々のガイドをご覧ください。
    • 追加のフラグがこのフラグと競合する可能性があるため、問題が発生した場合は、このフラグを 1 つだけ設定することを検討してください。
  • Chrome の設定でプライバシー サンドボックスの試用版を有効にします: [設定] > [セキュリティとプライバシー] > [プライバシー サンドボックス]。これは chrome://settings/adPrivacy でもアクセスできます。
  • Chrome の設定でサードパーティ Cookie を有効にする（[設定] > [セキュリティとプライバシー]）。[Cookie と他のサイトデータ] を [すべての Cookie を許可する] または [シークレット モードでサードパーティの Cookie をブロックする] に設定します。これは chrome://settings/cookies でもアクセスできます。
  • 通常のブラウジング セッションを行っている。シークレット モードは使用しないでください。

オリジン トライアルが正しく構成されているかどうかをデベロッパーが確認するにはどうすればよいですか？

Chrome のオリジン トライアルのトラブルシューティングでは、オリジン トライアルの設定を検証するための詳細なチェックリストを提供しています。

[Applications] にオリジン トライアルのステータスが表示されている DevTools

DevTools の [Applications] タブにある [Frames] に、オリジン トライアルのステータスが表示されます。

以下で説明するように、オリジン トライアルは対象となるユーザーに対してのみアクティブと表示されますが、デベロッパー フラグを使用して、独自の本番環境サイトに対してテストすることもできます。

どのようなユーザーがオリジン トライアルの対象ですか？

オリジン トライアルは、Chrome トラフィック全体のごく一部でのみ実施されるように設計されているため、サイトでオリジン トライアルを有効にした場合でも、ユーザーが API を有効にしていない可能性があることを常に想定する必要があります。オリジン トライアルのアクティブなテストグループは、最初はユーザーの割合が低い状態で開始され、トライアルの進行とともに増加する可能性があります。テスト対象の Chrome ユーザーの割合と、サイトで有効にしたユーザーの割合が一致しない場合があります。

ただし、サイト間で統合テストを行うには、対象ユーザーのセットがほぼ同じである必要があります。たとえば、参加しているパブリッシャー サイトで広告を見たユーザーはオリジン トライアルの利用資格を持っていても、参加している広告主のサイトでコンバージョンを達成したときにも、同じユーザーがオリジン トライアルの利用資格を持つ必要があります。

対象となるには、ユーザーは次の要件を満たしている必要があります。

  • Chrome 101 ベータ版以降を使用している。
    • FLEDGE を使用するには、デスクトップ Chrome が必要です。
    • iOS 版 Chrome ではオリジン トライアルを利用できません。
  • 有効なオリジン トライアル期間中にブラウジングしている。
  • [設定] > [セキュリティとプライバシー] > [プライバシー サンドボックス] でプライバシー サンドボックスの試用版を有効にしている（chrome://settings/adPrivacy からもアクセス可能）。
  • [設定] > [セキュリティとプライバシー] > [Cookie と他のサイトデータ] でサードパーティ Cookie を有効にし、[すべての Cookie を許可する] または [シークレット モードでサードパーティ Cookie をブロックする] に設定されている（chrome://settings/cookies からもアクセス可能）
  • シークレット モードではなく、通常のブラウジング セッションを使用している。
  • Chrome の有効なテストグループに含まれている。

デベロッパーはどのようにして API サポートを検出する必要がありますか？

他のウェブ プラットフォーム機能と同様に、機能を使用する前にサポートの有無を確認する必要があります。

トピック

document の browsingTopics() 関数と「browsing-topics」の権限ポリシー（https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature）を確認してください。

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

広告グループに参加する場合は、navigator の joinAdInterestGroup 関数と「join-ad-interest-group」の権限ポリシーをご確認ください。

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

オークションを実施する場合は、navigator の runAdAuction 関数と「run-ad-auction」の権限ポリシーをご確認ください。

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

アトリビューション レポート

window の attributionReporting オブジェクトと、「アトリビューション レポート」の権限ポリシーを確認します。

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

デベロッパーはどこでフィードバックやサポートを利用できますか？

フィードバックの概要ページでは、プライバシー サンドボックスのさまざまな側面についてフィードバックを送信するためのさまざまなルートについて詳しく説明しています。Topics、FLEDGE、Attribution Reporting のセクションがあり、各 API の個別のリンクを紹介しています。

また、重要なニュースの概要を紹介する「プライバシー サンドボックスの進捗状況」シリーズも定期的に更新しています。