次の方法で共有

ユーザー エージェント クライアント ヒント

  • [アーティクル]

概要

User-Agent クライアント ヒント API は、クライアント ヒント API の拡張であり、開発者はユーザーのブラウザーに関する情報に、より具体的でターゲットを絞った方法でアクセスしながら、ユーザーのプライバシーを維持し、閲覧アクティビティについて共有されているデータをより細かく制御できます。 この API は、HTTP 要求で従来の User-Agent ヘッダーを拡張し、開発者がヘッダー全体を公開するのではなく、必要な特定の情報のみを要求できるようにします。 これにより、最終的に User-Agent 文字列の細分性と、送信できる可能性のある機密情報の量を減らすことができます。

クライアント ヒントは、User-Agent ヘッダーに含まれる情報の代替ソースであることを目的としています。 User-Agent (UA) の削減は、User-Agent 文字列で共有される識別情報を最小限に抑えるための取り組みです。 その結果、、、、 navigator.platformなど、navigator.appVersionnavigator.userAgent特定Navigatorのインターフェイスからの戻り値が削減されます。 必要な調整を行わないと、この変更に適応できない場合、詐欺やボットのアクティビティを特定して防止する機能、レンダリング目的のブラウザーの認識、デバイスに基づく購入者のターゲット設定など、特定の機能が失われます。 さらに、購入者はデバイスのターゲット設定を利用できなくなります。

現在の UA 文字列 (タブレット デバイスとして検出):

Mozilla/5.0 (Linux; Android 9; SM-T810) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.1234.56 Safari/537.36

UA 文字列が縮小された同じユーザー - クライアント ヒント (デスクトップ デバイスとして検出) を使用していません。

Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.0.0 Safari/537.36

高エントロピ クライアント ヒント

最大のパフォーマンスを提供し、最適なデバイス ターゲットを実行するには、Xandr は 2 つの高エントロピ クライアント ヒントにアクセスする必要があります。

  • モデル
  • プラットフォームのバージョン

これらの値を渡すには、パブリッシャーは Accept-CH と Permissions-Policy という 2 つのヘッダーを設定 する必要があります。

Accept-CH は http ヘッダーであり、以降の要求にブラウザーが含める必要があるクライアント ヒント ヘッダーを指定するようにサーバーによって設定されます。 既定では、クライアント ヒント ヘッダーは同じ配信元の要求経由でのみ送信されます。 これは、Xandr の広告呼び出しにクロスオリジン要求であるアクセス権がないことを示します。 クロスオリジン要求に対してヒントを許可するには、各ヒントを Permissions-Policy ヘッダーで指定する必要があります。

パブリッシャー サーバーは、次に示すように、これらの 2 つのヘッダーを設定する必要があります。

  • Accept-CH: sec-ch-ua-model,sec-ch-ua-platform-version
  • Permissions-Policy: ch-ua-model=*,ch-ua-platform-version=*

シナリオ

でprebid.jsまたは Xandr の入札アダプターを使用ast.jsしている場合、クライアント側スクリプト (ast/prebid) が iframe の外部または内部に読み込まれるかどうかに応じて、2 つのシナリオがあります。

スクリプトが iframe の外部に読み込まれる

このシナリオでは、パブリッシャー サーバーは http ヘッダーを設定する必要があります。一方、クライアント側では変更は必要ありません。 たとえば、パブリッシャー ドメインが の場合、 https://example.comサーバーは example.com http ヘッダーを設定する必要があります。

クロスドメイン iframe 内にスクリプトが読み込まれる

このシナリオでは、クロスドメイン サーバーで http ヘッダーを設定する必要があります。 たとえば、パブリッシャー ドメインが で、iframe が https://example.com 別のドメインからコンテンツを読み込む場合、 https://adscripthost.com/ad_placement_setup.htmlサーバーは https://adscripthost.com ヘッダーを設定する必要があります。

ここでは、値が allow に設定された iframe にも属性が存在する ch-ua-platform-version;ch-ua-model必要があります。 例えば、

<iframe allow="ch-ua-platform-version;ch-ua-model" src="https://adscripthost.com/ad_placement_setup.html" style="width: 100%; height: 400px"></iframe>