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

プライバシー サンドボックスでは、 クロスサイトの必要性なしに広告ユースケースを実現 トラッキングできますオリジン トライアルでは、 評価とフィードバックの提供をお願いしています。 実環境でのテストです。これまでのオリジントライアルでは 細かく制御します。Topics、FLEDGE、Attribution Reporting API 単一オリジン トライアルを提供し、サイトで統一されたオリジンと エンドツーエンドの広告の初期バージョンを構成する API でのテスト 説明します。API は Chrome 101 ベータ版でテストできます。 以上です。Chrome 101 ベータ版リリースでは、 ユーザー コントロールのアップデートを 構成オプションのイテレーションを続けます。

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

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

このオリジン トライアルの目的は、広告全体で有意義なテストを行うことです。 ライフサイクルを管理できます。このジャーニーに対応するため、オリジン トライアルには以下が含まれています。

  • モニタリングとアクセスのための Topics ブラウザのトピック(document.browsingTopics() 経由)。
  • FLEDGE: ブラウザの 広告への入札と選択に基づき その他のシグナルです。
    • このオリジン トライアルでは、FLEDGE をパソコンで利用でき、以下の特典が含まれています。 サブセットを 1 つずつ作成します。詳しくは、 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 のオリジン トライアルのスタートガイドをご覧ください。

デベロッパーがローカルでテストするには

個別のデベロッパー向けドキュメントでは TopicsFLEDGEアトリビューション レポートでは、 各 API のローカル デベロッパー テストに関する具体的なガイダンス。API がオンになっていない デフォルトで有効になっており、 「*」フラグ 説明します。

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

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

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

Chrome のオリジン トライアルのトラブルシューティング には、送信元の構成を検証するための詳細なチェックリストが用意されています。 無償ツールキットで

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

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

オリジン トライアルは対象 ユーザーが必要な場合は、developer フラグを使用して独自の本番環境サイトをテストできます。

どのようなユーザーがオリジン トライアルの対象になりますか?

設計上、オリジン トライアルは全体のごく一部でのみ実施 Chrome トラフィックと そのため、送信元を有効にしていたとしても のサイトでユーザーが API をアクティブにしていない可能性があります。有効な オリジン トライアルのテストグループは、ごく一部のユーザーで開始されます。 トライアルの進行に伴って増加しますなお、 テスト対象の Chrome ユーザー数が、有効なユーザーの割合と一致しない場合があります おすすめします

ただし、サイト間で統合されたテストを可能にするため、 おおむね一貫性が保たれますたとえば、ユーザーが オリジン トライアルは 広告を掲載している広告主様でコンバージョンを達成した場合も、引き続き適格な見込み顧客となる サイトをご覧ください。

対象となるには、お客様は次の条件を満たしている必要があります。

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

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

他のウェブ プラットフォーム機能と同様に、機能のサポートを検出する必要があります。 確認してください。

トピック

documentbrowsingTopics() 関数を確認します。 権限に関するポリシー](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) 「browsing-topics」を検索します。

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

FLEDGE

広告のインタレスト グループに参加する場合は、joinAdInterestGroup 関数を navigator および「join-ad-interest-group」の権限ポリシーも参照してください。

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

オークションを実施する場合は、navigatorrunAdAuction 関数と「run-ad-auction」の権限ポリシーを確認します。

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

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

windowattributionReporting オブジェクトを確認します。 「attribution-reporting」に関する権限ポリシーをご覧ください。

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

デベロッパーがフィードバックを送信したりサポートを受けたりできる場所

フィードバックの概要ページでは、 さまざまなルートでプライバシー サンドボックスのさまざまな側面に関するフィードバックを提供できます。 専用のセクションがあります TopicsFLEDGEアトリビューション レポートでは、 各 API の個別のリンクをご覧ください。

また、プライバシーに関する取り組みの進展状況についても 重要なニュースの概要を提供するサンドボックス シリーズ。