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

広告をレンダリングする

Protected Audience オークションで広告候補が返された場合、次のいずれかが行われる可能性があります。不透明な URN として返されます。これは、iframe で広告をレンダリングするために使用されます。 FencedFrameConfig は、フェンス付きフレームで広告をレンダリングするために使用されます。

このガイドでは、フェンス付きフレームの概要と必要な理由について説明します。どちらを使用してもかまいません「Fenced」タグと詳しくは、こちらのガイドまたは提案をご覧ください。

フェンス付きフレームとは

フェンス付きフレーム（<fencedframe>）は埋め込みコンテンツ用の HTML 要素です。 iframe に似ています。iframe とは異なり、フェンス付きフレームは通信を制限します。使用してフレームがクロスサイトデータにアクセスできるようにするため、エンベディングコンテキストと共有します。同様にエンベディングコンテキストは、フェンス付きのフレームと共有できません。

たとえば、news.example（エンベディングコンテキスト）がフェンス付きフレーム内の shoes.example。news.example は次の場所からデータを引き出できません shoes.example の広告。shoes.example はファーストパーティデータを学習できません。 news.example。

フェンス付きフレームの仕組み

フェンス付きフレームはナビゲーションに FencedFrameConfig オブジェクトを使用します。このオブジェクトは Protected Audience オークションから返された結果が出力されます。次に、構成オブジェクトにはフェンス付きフレーム要素の config 属性。これは iframe とは異なります URL または不透明な URN が src 属性に割り当てられている場合。「 FencedFrameConfig オブジェクトには読み取り専用の url プロパティがあります。ただし、現在のユースケースでは、内部リソースの実際の URL を隠す必要があります。このプロパティは読み取り時に文字列不透明を返します。

フェンス付きフレームは、postMessage を使用してエンべディングと通信できません。ただし、フェンス付きフレームでは、postMessage を内部に iframe とともに使用できます。保護します。

フェンス付きフレームは、他の方法でパブリッシャーから分離されます。パブリッシャーフェンス付きフレーム内の DOM にはアクセスできず、フェンス付きフレームパブリッシャーの DOM にアクセスできませんさらに、name などの属性は、任意の値に設定され、パブリッシャーによって監視されますが、フェンス使用できます。

フェンス付きフレームは、トップレベルのブラウジングコンテキスト（ブラウザタブ）。特定のユースケースでフェンス付きのフレームを使用する（opaque-ads など）クロスサイトデータ（Protected Audience API のインタレストグループなど）を含めることができる分割されていないストレージや Cookie にはアクセスできません。opaque-ads フェンス一意のノンスベースの Cookie とストレージパーティションにアクセスできます。

フェンス付きフレームの特性については、説明で詳しく説明しています。

フェンス付きフレームで広告をレンダリングする

次の条件が満たされた場合、Protected Audience オークションから FencedFrameConfig が返されます。 AuctionConfig の resolveToConfig パラメータが true に設定されていることを確認します。

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true
});

構成を取得したら、フェンス付きフレームの config に割り当てることができます。属性を使用して、構成で表されるリソースにフレームを移動します。それより前のバージョンの Chrome は resolveToConfig プロパティがサポートされていないため、その前に Promise が FencedFrameConfig に解決されたことも確認する必要があります。移動:

if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
  const frame = document.createElement('fencedframe');
  frame.config = frameConfig;
}

iframe で広告をレンダリングする

AuctionConfig で resolveToConfig が明示的に設定されていない場合、または設定されている場合 false に設定すると、runAdAuction() は不透明な URN を返します。この URN は iframe の src を使用して広告をレンダリングする。