サードパーティのオリジン トライアル

埋め込みコンテンツのプロバイダは、ウェブ プラットフォームの新機能や試験運用版の機能をテストできます。

オリジン トライアルは、新しいまたは試験運用版のウェブ プラットフォーム機能をテストする方法です。

オリジン トライアルは、通常、ファーストパーティ ベースでのみ利用できます。つまり、登録された単一のオリジンに対してのみ機能します。デベロッパーが、コンテンツが埋め込まれている他のオリジンで試験運用版機能をテストする場合は、これらのオリジンをすべてオリジン トライアルに登録し、それぞれに一意のトライアル トークンを割り当てる必要があります。この方法は、多数のサイトに埋め込まれているスクリプトをテストするための拡張性はありません。

サードパーティのオリジン トライアルでは、埋め込みコンテンツのプロバイダが JavaScript を使用してトークンを提供することで、複数のサイトで新機能を試すことができます。

サードパーティのオリジン トライアルは、すべての機能で意味があるとは限りません。サードパーティのオリジン トライアル オプションを利用できるのは、サードパーティのサイトにコードを埋め込むことが一般的なユースケースに限られます。Chrome のオリジン トライアルを使ってみるでは、Chrome オリジン トライアルに参加する方法に関する一般的な情報を紹介しています。

サードパーティ プロバイダとしてオリジン トライアルに参加する場合は、ご自身の責任で、オリジン トライアルに追加するサイトのパートナーやお客様に今後の見通しを通知し、今後の見通しを伝える必要があります。試験運用版の機能が原因で、予期しない問題が発生する可能性があります。また、ブラウザ ベンダーがトラブルシューティングのサポートを提供できない場合があります。

注: サードパーティのオリジン トライアルをサポートすると、幅広い参加が可能になりますが、試験運用版機能の過剰な使用や悪用の可能性が高まるため、「Trusted Tester」のアプローチが適切です。サードパーティのオリジン トライアルの利用範囲を広げるには、サードパーティ プロバイダとして参加するウェブ デベロッパーに対して、さらなる調査と追加の責任が必要になります。 サードパーティのオリジン トライアルを有効にするリクエストは、問題のあるサードパーティ スクリプトが複数のサイトに影響を及ぼすことを防ぐために審査されることがあります。承認プロセスについては、オリジン トライアル デベロッパー ガイドをご覧ください。

サードパーティのオリジン トライアルの進行状況については、Chrome プラットフォームのステータスで確認してください。

サードパーティのオリジン トライアルに登録する

1. 有効なトライアルのリストからトライアルを選択します。
2. トライアルの登録ページで、サードパーティ トークンをリクエストするオプションを有効にします（利用可能な場合）。

3. トライアルによっては、トークンの登録時にさまざまな使用制限を設けるオプションが用意されています。可能であれば、サードパーティ トークンの使用を制限する選択肢を 1 つ選択します。

   1. 標準的な上限: Chrome のページ読み込みの 0.5% の上限です。

   2. ユーザー サブセット: 有効なサードパーティ トークンが提供されても、ごく一部の Chrome ユーザーは常にトライアルから除外されます。除外率はトライアルごとに異なりますが、通常は 5% 未満です。

      非推奨トライアルに使用制限はありません。新機能が導入されず、トライアル機能に依存するウェブの割合が高くなるリスクはありません。

4. [登録] ボタンをクリックしてリクエストを送信してください。

5. リクエストをさらに審査する必要がない限り、サードパーティ トークンは直ちに発行されます。（トライアルによっては、トークン リクエストの審査が必要になることがあります）。

6. 審査が必要な場合は、審査が完了してサードパーティ トークンが準備できるとメールで通知されます。

   

   コンバージョン測定トライアルの登録ページ。

注意: サードパーティ トークンは、<script> 要素を使用して外部の JavaScript ファイル内で指定する必要があります。サードパーティ トークンは、メタタグ、インライン スクリプト、HTTP ヘッダーでは機能しません。

プログラムでトライアル トークンを提供する

オリジン トライアルに参加するには、ページで有効なトライアル トークンを提示する必要があります。コードが埋め込まれている複数のサイトでトライアル機能を有効にする場合は、JavaScript を使用してトークンを挿入します。

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

使用しない場合、コードを埋め込んでいるすべてのサイトを取得して、HTTP ヘッダーまたは HTML でトークンを提供する必要があります。

注: ot-3p.glitch.me のデモでは、別のオリジンから JavaScript から提供されたトークンを使用して、有効になっているオリジン トライアル機能にアクセスします。

フィードバックを共有する

サードパーティのオリジン トライアルに登録していて、プロセスや改善すべきアイデアについてフィードバックがある場合は、オリジン トライアル GitHub リポジトリで問題を作成してください。

補足説明

• デモ
• クロスオリジンの iframe の例
• Chrome のオリジン トライアルのスタートガイド
• ウェブ デベロッパー向けオリジン トライアル ガイド
• Chrome プラットフォームのステータス

写真撮影: Louis Reed（出典: Unsplash）