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

Chrome 主導のテスト

サードパーティ Cookie の廃止に備え、サイトがサイトの動作をプレビューできる Chrome 向けのテストモードサードパーティ Cookie がなくても動作します。このガイドでは、 Chrome が提供する予定のテストモードの概要とアクセス方法についてテストグループのラベルです。

ここでの Chrome ブラウザは、Chrome クライアント（Chrome）のことを指します。インストールする必要があります。個々のユーザーのデータディレクトリ別個のクライアントとなります。

テストグループ: 特定の機能が利用できる Chrome ブラウザのセット有効、無効、または構成されていることを示します。Chrome を利用した場合テスト（ラベルが設定されているブラウザのセット）。

ラベル: このコンテキストでは、リクエストヘッダー。テストグループに属するブラウザに設定された値。テストグループ内の各ブラウザは、その後もグループ内で維持されます Chrome を利用したテスト期間であり、特定の商品のラベルがテスター間でのブラウザの一貫性が保たれます。

で確認できます。

次の 2 つのモードが用意されています。

モード A: 2023 年 11 月より、組織が PS R&M API をテストするは、Chrome の一部で一貫したラベルを受け取るようオプトインできましたブラウザを使用して、異なるテスター間で連携してテストを行うことができます。
モード B: 2024 年 1 月 4 日より、Chrome は全世界で無効となります Chrome ブラウザの一部でサードパーティ Cookie が使用されています。

サードパーティ Cookie が存在する場所モード B で無効にされたモジュールは、サービスモードから制限します。

Google は CMA これらのテストモードをテストフレームワークと一致させる（および定めています。業界のテストに関するガイダンスをご覧ください。そのため CMA は、これらのモードでのテスト結果は、プライバシーサンドボックスの評価に使用できます。CMA はテスト設計 2 の結果に重点が置かれる可能性があります。モード B のラベルとモード A コントロール 1 のラベルです。詳しくは、 CMA の 10 月 26 日のガイダンスをご覧ください。

ラベルには、使用可能な一時的な Cookie-Deprecation 値を使用してアクセスできます。読み取る操作を記録します後述のセクションをご覧ください。 Cookie-Deprecation 値を使用してラベルにアクセスするをご覧ください。

また、この提案は通常、 Blink の開発プロセス技術設計と Chrome リリースのマイルストーンが確定する。これが Google がリリースする実装ですが、承認されることを意味しますので、詳細は変更される可能性がございます。私たちは更新して、このページを最新の状態に保ちます。また、フィードバックや質問の提供。

モード A: ラベル付きブラウザグループ

テストにご参加いただいた組織では、永続的なラベルのセットを Chrome ブラウザのサブセットに維持し、同じブラウザセット上のさまざまな広告テクノロジー間で調整されたテスト。たとえば、ブラウザがテストグループ「label_only_3」に分類された場合（含まれている場合、参加しているすべての広告テクノロジーが同じ label_only_3 ラベルが表示され、それに応じて調整が行われます。PS を使用してください。使用することもできますが、サードパーティ Cookie の使用は控えてください。次のコースの参加者は他の参加者にラベルを転送して広告選択プロセス全体で一貫したテストを測定します

たとえば、複数の参加者が Protected Audience 一貫したブラウザで、サードパーティ Cookie を使用しないオークション「オークションの販売者の参加者は、確認されたラベルを購入者に転送して組織的なテストを促進します

このラベルは Chrome のインスタンスの動作には影響しません。これにはサードパーティ Cookie の可用性も含まれますラベルは、テストをグループ化することもできますがテストに関連するパラメータを適用するよう指示します。条件サードパーティ Cookie を削除した場合の効果をテストした結果、サードパーティ Cookie を使用するブラウザで、サードパーティ Cookie のデータを除外する責任を負います。指定します。

通常の Chrome トラフィックを表すグループを作成することが目的です。つまりサードパーティ Cookie と PS R&M API をどちらも使用できることになりますが一部のユーザーは、設定や拡張機能を使用して変更または無効化した可能性がある説明します。

ラベルは通常、Chrome のブラウジングセッション全体を通して保持されます。測定されます。ただし、まれに発生するため、保証はされません。ブラウザを完全にリセットすると現在のラベルもリセットされる場合があります

Chrome Stable ブラウザの 8.5% をモード A に、集団を 9 つのグループに分割します。小さなサブグループ広告テクノロジーがラベルを組み合わせて独自のラベルを作成し、独自のテストです。グループが重複することはありません。

control_1.* ラベルは「コントロール 1」として使用することを想定しています。 CMA の業界のテストに関するガイダンス、そのため、テストの参加者は Topics API を使用したり Protected Audience を実行したりしてはいけません。ブロックするかを決定しますラベルはブラウザの動作に影響しないため、確認されたトピックを回避したり、Protected Audience のオークションを実施したりしないこと control_1.* グループラベルを検出したときに表示されます。

歓迎フィードバックこの選択が参加のニーズを満たしているか組織に提供します。

ラベル	安定トラフィックの割合
`control_1.1`	0.25
`control_1.2`	0.25
`control_1.3`	0.25
`control_1.4`	0.25
`label_only_1`	1.5
`label_only_2`	1.5
`label_only_3`	1.5
`label_only_4`	1.5
`label_only_5`	1.5

モード A label_only_ のブラウザグループは 2023 年 11 月からご利用いただけます。モード A の control_1_* グループは、2024 年 1 月 4 日から利用可能になりました。

モード B: サードパーティ Cookie の 1% を無効にする

Chrome Stable の約 1% でサードパーティ Cookie を無効に 2024 年 1 月 4 日以降のブラウザ（Dev、Canary、Beta でも対応可能）（2023 年第 4 四半期中に使用）によって Google が使用しました。PS R&M API をテストする組織では、オプトインすると、このモードはブラウザ全体に均一に適用されます対象になります。もちろん、サイトの機能によっては次のような代替ソリューションがサイトでまだ採用されていない場合に CHIPS または関連ウェブサイトセット。

さらに、モード B ではトラフィックのごく一部を PS R&M API が無効になっています関連ウェブサイトセット、CHIPS、 FedCM が無効になることはありません。この組み合わせが役立つことが予想されますサードパーティ Cookie のないブラウザのパフォーマンスのベースラインを確立する使用できます

モード B では、影響を受けるブラウザ用のラベルも提供しています。「 API が無効になると同時にラベルが使用可能になります。私たちは母集団を 3 つの treatment_1.* グループに分け、無効化されているが、PS R&M API が使用可能で、サードパーティ Cookie と PS R&M API の両方が含まれる control_2 グループ無効です。

Attribution Reporting API と非公開集計のデバッグに役立つ API の統合により、テスト参加者がノイズについて理解を深められるようにします。 ARA デバッグレポートとプライベートアグリゲーションのデバッグレポートモード B のブラウザでは引き続き使用できます（ユーザーが明示的にブロックしているサードパーティ Cookie などですデバッグレポートは使用できません。 control_2。そのスライスでは PS R&M API を使用できないため。デバッグレポートサードパーティ Cookie の段階的廃止に伴い、段階的に廃止されます。

Attribution Reporting API では、サードパーティ Cookie が無効になっているため、元のレポートからは ar_debug Cookie を設定し、debug_key フィールドの設定に依存する必要がある（アトリビューション成功レポートの場合）と debug_reporting フィールド（詳細フィールドの場合）デバッグレポートの受信を有効または無効にできます。
Private Aggregation API の場合、レポート送信元は enableDebugMode(): デバッグレポートの受信のオプトインを管理します。企業は引き続き帰属表示の使用に規制上の義務がどのように適用されるかを検討する Reporting API と Private Aggregation API（デバッグレポートを含む）

モード A は引き続き実行され、これらのグループは、次のようにモード A グループとは区別されます。のユーザーはモード A かモード B かどちらでもないかのいずれかになりますテストの参加者ステータスを表すコントロールグループとして control_1.* トラフィックを使用する必要があります。サードパーティ Cookie も活用しています

ラベル	安定トラフィックの割合
`treatment_1.1`	0.25
`treatment_1.2`	0.25
`treatment_1.3`	0.25
`control_2`	0.25

また、Chrome Canary、Dev、Beta のクライアントの 20% で Cookie の使用が制限されています。

ラベル	安定化前のトラフィックに占める割合
`prestable_treatment_1`	10%
`prestable_control_2`	10%

これらのテスト群のいずれかにテスト群を追加すると、安定版の同等のテスト群と同じ効果が得られます。

モード A と同様に、PS R&M API の使用は保証されません。ユーザーが使用できる Chrome の [プライバシーとセキュリティ] の設定で無効にしてください。同様にサードパーティ Cookie が無効になるという保証はなく、 control_2 グループ（ユーザーはブラウザの UI にアクセスしてサードパーティを許可できるため）できます。

テストのモニタリング

各パターン群とコントロール群の相対的なトラフィック量をモニタリングする指定します。treatment_1.1 のトラフィック量は、 treatment_1.2 と treatment_1.3。

ラベルを含むトラフィックについては、慎重に検討し、バージョン 120 より前の Chrome通常これらの作業を担当するチームが「無効なトラフィック」を識別し、その特性を示すユーザーエージェントをそのようなイベントを除外した方がよいでしょう。

期間前のラベル

2024 年 1 月までは、複数のテスト群で事前期間を実施しました。 Chrome で正確なサイズ設定と統計的選択が行われる期間バイアスのない集団ですこれらの事前期間は、スケジュール設定されたすべてのテスト群で実施テスト群は 1 月から開始される予定で、モード B の群と Control_1.* 群のデータアナリストがデベロッパーやサイトのアクションに動作や API の可用性が変わりますが、指標スコープと preperiod ラベルが返される場合があります。ブラウザが「preperiod」ラベルはテストグループのいずれかに遷移する可能性がありますが、そのため、このラベルの付いたブラウザは、テスト対象になります

テスト群とは、調査対象の母集団のサブセットです。ラベルが付けられたグループの 1 つです

Cookie のサポート終了（Cookie-Deprecation）の値を使用してラベルにアクセスする

モード A とモード B の期間中は、一時的なオプトインの HTTP ヘッダーと JavaScript を使用してアクセスできる Cookie-Deprecation の値 API: ブラウザの該当するモード A またはモード B のラベルを提供します。テストグループ（上記の割合で定義）が、できます。

ラベルへのアクセスには、ユーザーのデバイスに保存されている情報へのアクセスも含まれます。イン一部の地域（EU や英国など）では、Google はこの活動が Cookie の使用に似ているため、ラベルにアクセスするには、同意します。ラベルのリクエストを開始する前に、この同意義務がお客様に適用されるかどうかに関する法的助言。

Sec-Cookie-Deprecation リクエストヘッダーを受信するには、まずサイトで receive-cookie-deprecation Cookieこのクッキーは Partitioned 属性を含めることができません。つまり、ヘッダーを受け取るためのオプトインは、できます。

たとえば、3p-example.site が Sec-Cookie-Deprecation の受信を希望している場合です。 example.com に埋め込まれたリソースに対してヘッダーを設定する場合、3p-example.site は次の Cookie を設定します。

Set-Cookie: receive-cookie-deprecation=1; Secure; HttpOnly; Path=/; SameSite=None; Partitioned;  Max-Age=15552000

Cookie 属性 Secure、HttpOnly、SameSite、Partitioned は次のとおりです。必須です。他の属性（Domain、Path、Expires、Max-Age）は、必要に応じて設定しますが、Path=/ がデフォルトです。例ここで Max-Age=15552000 を設定し、Cookie が 180 日が経過するまで期限切れにならないようにします。日

receive-cookie-deprecation=1 Cookie の設定を開始することをおすすめしますテスト期間が始まる前に、次のことを確認します。テストグループ内のブラウザには Sec-Cookie-Deprecation が含まれるリクエストヘッダーを使用します。

たとえば、ブラウザが example_label_1 グループに属しているとします。この場合、この Cookie を含むリクエストに Sec-Cookie-Deprecation も含まれるようになります。できます。

Sec-Cookie-Deprecation: example_label_1

ブラウザがグループに属していない場合、ヘッダーは送信されません。ラベルは Cookie の存在と関連付けられるため、Cookie が削除されると、完全にブロックされるか、特定のサイトでブロックされている場合、ラベルは送信しました。Partitioned 属性は、それ以降も引き続き使用することを想定しているためサードパーティ Cookie のサポートが完全に終了したため、Partitioned 個の Cookie が設定することもできます。

cookieDeprecationLabel JavaScript API にアクセスする

Cookie-Deprecation 値には、次のコマンドを使用してアクセスすることもできます。 navigator.cookieDeprecationLabel.getValue() JavaScript APIこのコマンドは Promise は、該当するグループラベルを含む文字列に解決されます。対象たとえば、ブラウザが example_label_1 グループに属している場合、次のようになります。

// Feature detect temporary API first
if ('cookieDeprecationLabel' in navigator) {
 // Request value and resolve promise
 navigator.cookieDeprecationLabel.getValue().then((label) => {
   console.log(label);
   // Expected output: "example_label_1"
 });
}

ブラウザがグループに属していない場合、API を使用できないか、値は空の文字列になるため、特徴検出を必ず行ってください。

JavaScript API は、変数が存在しても receive-cookie-deprecation Cookieただし、Cookie が完全にブロックされると、サイト自体について API が再度使用できなくなるか、空の文字列が返されます。

クライアントが提供する他の値と同様に、値を事前にヘッダーまたは JavaScript API から取得しておく必要があります。

デモとテスト

Chrome 120 以降では、ローカルデベロッパーを有効にするためのフラグが用意されています。ラベルのリクエストと読み取りのテストを行います。

chrome://flags/#tpc-phase-out-facilitated-testing フラグを使用すると、テストラベルの選択を有効にします。これらのラベルには接頭辞 fake_ が付加されています。本物のラベルと区別できますこのフラグを有効にしても、いずれかのテストグループに分類されます

ラベルの動作は goo.gle/cft-demo で確認できます。

プライバシーサンドボックスの関連性と測定に登録が適用されるためローカルテストの適用をオーバーライドするために、 chrome://flags/#privacy-sandbox-enrollment-overrides とデモの提供含まれます。または、kubectl のコマンドラインバーにターミナルから Chrome を実行する方法を紹介します。 --args --disable-features=EnforcePrivacySandboxAttestations

chrome://flags/#tpc-phase-out-facilitated-testing — Chrome を利用したテストフラグの設定

フラグのプルダウンには複数のオプションがあります。テスターは、主に「Force」とマークされたエントリにこれらをラベルにすると動作は、他のデバイス設定に関係なく有効になります。

テストグループのラベルのみをテストするには、[強制制御 1 を有効化] を選択しますまたは「Force LabelOnly を有効にしました」。これによりブラウザから「fake_control_1.1」または "fake_label_only_1.1"できます。

Chrome M120 以降では、次のエントリも使用できます。

サードパーティ Cookie のブロックをテストするには、[有効な強制処理] を選択します。この「fake_handle_1.1」ラベルを変更するだけでなく Cookie 設定ページと現在の Cookie 設定を使用して、サードパーティ Cookie をブロックします。

Private Ads API を使用せずにサードパーティ Cookie のブロックをテストするには、[強制的にコントロール 2」。これにより、"fake_control_2"テストグループのラベル, 更新 Cookie の設定ページで、サードパーティの Cookie をブロックしたり、新しい Cookie をプライベート広告 API

ブラウザが新しいままになるという問題が発生しています。 Cookie 設定ページと、設定にかかわらずサードパーティの Cookie をブロックする設定フラグを無効にします。Google はこの問題の解決に取り組んでいますが、当面は別の Chrome データディレクトリでこれらのフラグの値をテストするには、 --user-data-dir=<new dir> コマンドラインフラグを指定した Chrome。

フィードバック

"chrome-testing" を使用します。質問を管理するために、GitHub のデベロッパーサポートリポジトリにあるラベルを使用します。歓迎フィードバックとディスカッション:

また、新しい質問やディスカッションを提起する「Chrome を利用したテスト」を使用してリポジトリに使用します。