광고 렌더링

Protected Audience 입찰에서 광고 후보를 반환하면 광고 후보는 다음 중 하나에 해당할 수 있습니다. iframe 또는 FencedFrameConfig: 분리 프레임에서 광고를 렌더링하는 데 사용됩니다.

이 가이드에서는 분리 프레임의 정의와 필요한 이유, 그리고 광고를 렌더링하는 방법에 대해 알아보겠습니다. 자세한 내용은 자세한 내용은 이 가이드 또는 제안서를 참조하시기 바랍니다.

분리 프레임이란 무엇인가요?

분리 프레임 (<fencedframe>)은 삽입된 콘텐츠의 HTML 요소입니다. iframe와 유사합니다. iframe와 달리 분리 프레임은 통신을 제한함 임베딩 컨텍스트가 있어야 프레임이 교차 사이트 데이터에 액세스할 수 있습니다. 임베딩 컨텍스트와 공유합니다 마찬가지로 실적 최대화 캠페인의 모든 퍼스트 파티 데이터는 차단 프레임과 공유할 수 없습니다.

예를 들어 news.example (삽입 컨텍스트)이 shoes.example를 포함해야 합니다. news.example에서 데이터를 shoes.example 광고이며 shoes.example가 퍼스트 파티 데이터를 학습할 수 없음 news.example

분리 프레임은 어떻게 작동하나요?

분리 프레임은 탐색에 FencedFrameConfig 객체를 사용합니다. 이 객체는 반환됩니다. 그런 다음 config 객체를 분리 프레임 요소의 config 속성입니다. iframe과(와) 다릅니다. 여기서 URL 또는 불투명 URN은 src 속성에 할당됩니다. 이 FencedFrameConfig 객체에 읽기 전용 url 속성이 있습니다. 하지만 현재 사용 사례에서는 내부 리소스의 실제 URL을 숨겨야 합니다. 이 속성은 읽을 때 문자열 불투명을 반환합니다.

분리 프레임은 postMessage를 사용하여 삽입기와 통신할 수 없습니다. 하지만 분리 프레임은 내부의 iframe와 함께 postMessage를 사용할 수 있습니다. 있습니다.

분리 프레임은 다른 방식으로 게시자와 격리됩니다. 게시자 분리 프레임 내부의 DOM에 액세스할 수 없고 게시자의 DOM에 액세스할 수 없습니다. 또한 name와 같은 속성도 어느 값으로든 설정되고 게시자가 관찰할 수 있으며, 분리 모드에서 사용할 수 없음 있습니다.

분리 프레임은 최상위 탐색 컨텍스트 (예: 브라우저 탭). 특정 사용 사례 (예: opaque-ads)에서 분리 프레임임 크로스 사이트 데이터 (예: Protected Audience API 관심분야 그룹)를 포함할 수 있음 프레임은 파티셔닝되지 않은 저장소나 쿠키에 액세스할 수 없습니다. opaque-ads 펜스 고유한 nonce 기반 쿠키 및 스토리지 파티션에 액세스할 수 있습니다.

분리 프레임의 특징은 설명서에 자세히 설명되어 있습니다.

분리 프레임에 광고 렌더링

다음과 같은 경우 Protected Audience 입찰에서 FencedFrameConfig가 반환됩니다. AuctionConfig의 resolveToConfig 매개변수가 true로 설정된 것을 확인할 수 있습니다.

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

구성을 가져온 후에는 분리 프레임의 config에 할당할 수 있습니다. 속성을 사용하여 프레임을 구성으로 표시된 리소스로 이동할 수 있습니다. 이전 버전의 Chrome은 resolveToConfig 속성을 지원하지 않으므로 전에 프로미스가 FencedFrameConfig로 결정되었는지 계속 확인해야 함 탐색:

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

iframe에서 광고 렌더링

AuctionConfig가 resolveToConfig를 명시적으로 설정하지 않거나 설정된 경우 false로 설정하면 runAdAuction()는 불투명 URN을 반환합니다. 이 URN은 iframe의 src를 사용하여 광고를 렌더링합니다.