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

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

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

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

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

サードパーティ オリジンのトライアルで、1 つの登録トークンを複数のオリジンで使用できるようにする方法を示した図。

サードパーティのオリジン トライアルは、すべての機能に適しているわけではありません。Chrome では、サードパーティのオリジン トライアル オプションは、サードパーティのサイトにコードを埋め込むことが一般的なユースケースである機能でのみ使用できるようになります。Chrome のオリジン トライアルに参加する方法については、Chrome のオリジン トライアルのスタートガイドをご覧ください。

サードパーティ プロバイダとしてオリジン トライアルに参加する場合は、オリジン トライアルに含めるサイトのパートナーやお客様に通知し、期待値を設定することがお客様の責任となります。試験運用版の機能によって予期しない問題が発生する可能性があり、ブラウザ ベンダーがトラブルシューティング サポートを提供できない場合があります。

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

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

  1. 有効なトライアルのリストからトライアルを選択します。
  2. トライアルの登録ページで、サードパーティ トークンをリクエストするオプションを有効にします(利用可能な場合)。
  3. 一部のトライアルでは、トークンを登録する際にさまざまな使用制限を選択できます。利用可能な場合は、サードパーティ トークンの使用を制限する次のいずれかのオプションを選択します。

    1. 標準の上限: 通常の上限は Chrome ページ読み込みの 0.5% です。
    2. ユーザーのサブセット: 有効なサードパーティ トークンが提供されている場合でも、ごく一部の Chrome ユーザーは常にトライアルから除外されます。除外率はトライアルごとに異なりますが(適用されないこともあります)、通常は 5% 未満です。

      非推奨トライアルには使用制限がありません。非推奨トライアルでは新しい機能が導入されないため、ウェブの大部分がトライアル機能に依存するリスクはありません。

  4. [登録] ボタンをクリックしてリクエストを送信します。

  5. リクエストの詳細な審査が必要な場合を除き、サードパーティ トークンはすぐに発行されます。(トライアルによっては、トークン リクエストの審査が必要になる場合があります)。

  6. 審査が必要な場合は、審査が完了し、サードパーティ トークンが準備できた時点でメールでお知らせします。

    サードパーティ マッチングのチェックボックスがオンになっている、Conversion Measurement API の Chrome オリジン トライアル登録ページ。
    コンバージョンの測定のトライアルの登録ページ。

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

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

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

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

フィードバックを共有

サードパーティ送信元のトライアルに登録する際に、プロセスに関するフィードバックや改善案をお持ちの場合は、送信元トライアルの GitHub リポジトリでIssue を作成してください。

補足説明

写真撮影: Louis ReedUnsplash