전환 측정 사용 설정

전환 기여 분석 측정에는 게시자, 광고주, 게재 광고 기술 (광고를 게재하는 항목), 측정 서비스 제공업체 등 다양한 당사자가 참여할 수 있습니다. 이 문서에서는 일반적인 전환 측정 시나리오를 설명하지만, 일반적으로 Attribution Reporting API (ARA)에서 기여 분석 보고서를 수신하려는 모든 당사자는 이 문서에 설명된 통합 단계를 따라야 합니다.

예를 들어 게시자는 광고를 게재하는 광고 기술을 하나 이상 보유하는 것이 일반적입니다. 여기에는 광고 소재의 마크업을 제공하는 당사자, 광고 소재의 노출 또는 추적 픽셀을 제공하는 당사자, 게시자 페이지의 광고 슬롯에 SDK 또는 태그를 제공하는 당사자가 포함될 수 있습니다. 이러한 광고 기술은 ARA의 기여 분석 보고서를 수신할 수도 있고 수신하지 않을 수도 있지만, 다운스트림 광고 기술이 기여 분석 보고서를 수신할 수 있도록 합니다.

또한 광고주는 교차 네트워크 기여 분석 및 기타 보고 기능을 위해 서드 파티 전환 측정 서비스 제공업체를 사용할 수도 있습니다. 광고주는 이러한 데이터를 사용하여 여러 고유한 게시자와 채널에서 광고 투자의 수익률을 파악하므로 DSP 또는 광고 서버는 이러한 사용 사례를 지원하도록 Attribution Reporting API를 사용 설정하는 방법을 이해하는 것이 중요합니다. 서드 파티를 사용하려는 광고주는 서드 파티 측정 서비스 제공업체를 사용하거나 API에서 보고서를 등록하고 수신하도록 사내 서버를 설정하여 계속 사용할 수 있습니다.

Attribution Reporting API를 사용하면 여러 광고 기술에서 동일한 노출 또는 전환에 대한 기여 분석 소스와 트리거를 등록하고 API에서 별도의 보고서를 수신할 수 있습니다. 예를 들어 DSP는 Attribution Reporting API에서 자체 기여 분석 보고서를 수신할 뿐만 아니라 광고주의 서드 파티 측정 서비스 제공업체에 대한 별도의 보고를 허용할 수 있습니다. 광고 기술은 API에서 보고서를 수신하려면 기여 분석 소스와 트리거를 모두 등록해야 하며, 기여 분석은 광고 기술이 API에 개별적으로 등록한 기여 분석 소스와 트리거 간에 실행됩니다.

일반적인 전환 측정 시나리오

이 섹션에서는 전환 측정에 관한 두 가지 일반적인 시나리오를 살펴봅니다.

시나리오 1: 게재 광고 기술과 서드 파티 측정 서비스 제공업체 모두 Attribution Reporting API에서 보고서를 수신해야 함

광고주가 서드 파티 측정 서비스 제공업체를 사용하여 광고 인벤토리의 전환 기여도를 부여하려고 하고 광고 소재를 호스팅하는 광고 기술이 광고 인벤토리의 전환 기여도를 부여하려고 합니다. 이는 광고 소재의 마크업을 제공하고, 자체 기여 분석 보고를 실행하며, 서드 파티 측정 또는 분석 제공업체와 통합된 광고주와 협력하는 DSP 또는 광고주 광고 서버 (서드 파티 광고 서버 - 3PAS)에 일반적입니다.

이 경우 게재 광고 기술은 현재 설정에서 클릭 및 노출 이벤트를 실행하는 당사자이기도 합니다. 게재 애드테크는 적절한 위치에 새 attributionsrc를 설정하고 리디렉션이 올바르게 구성되었는지 확인해야 합니다. 또한 게재 광고 기술과 서드 파티 측정 서비스 제공업체 모두 등록되어 있고 서버가 Attribution Reporting API 요청을 수신하고 응답할 준비가 되었는지 확인해야 합니다.

일반적인 캠페인 설정은 다음과 같습니다.

  1. 광고주 광고 서버 (3PAS)는 서드 파티 측정 서비스 제공업체의 노출 및 클릭 추적 픽셀을 포함하는 광고 소재의 마크업을 DSP에 제공합니다. 광고 서버는 attributionsrc가 광고 소재 마크업에 포함되어 있는지 확인해야 합니다.

  2. DSP는 측정 노출 및 클릭 추적 픽셀을 추가하는 기능을 제공하며, 입찰하는 최종 광고 소재 마크업에 attributionsrc가 포함되어 있는지 확인해야 합니다.

시나리오 2: 서드 파티 측정 제공업체만 Attribution Reporting API에서 보고서를 수신해야 함

광고주가 서드 파티 측정 서비스 제공업체를 사용하여 광고 인벤토리의 전환 기여도를 부여하려고 하지만 광고 소재를 호스팅하는 광고 기술에 기여도 측정 요구사항이 없습니다. 이는 광고 소재를 호스팅하고 직접 기여 분석 보고를 사용하지 않을 계획이지만 DSP 파트너 또는 측정 태그 지정 회사(예: 서드 파티 광고 서버, 측정 또는 분석 제공업체)에 Attribution Reporting API를 사용 설정하려는 게시자, SSP 또는 게시자 광고 서버에 일반적입니다.

이 경우 현재 설정에서 클릭 및 노출 이벤트를 실행하는 당사자는 광고 소재에 새 attributionsrc 속성을 추가하고 리디렉션이 의도한 대로 작동하는지 확인해야 합니다. 이는 각 게시자의 통합에 따라 크게 달라지지만 클릭 이벤트의 경우 SSP, 광고 기술 제공업체 또는 게시자 본인이 될 수 있습니다. 노출 이벤트의 경우 일반적으로 서드 파티 측정 제공업체입니다.

시나리오 1의 일반적인 캠페인 설정 예시에서 게시자 광고 서버, SSP 또는 게시자 자체는 DSP에서 제공한 attributionsrc 속성이 게시자 페이지에 표시되도록 하면 됩니다.

구현 세부정보

다음 표에서는 Attribution Reporting API 구현 단계를 대략적으로 설명합니다.

단계 업무 책임 예
1단계: 기존 광고 소재 및 측정 코드에 기여 분석 소스 사용 설정하기 노출 이벤트를 실행하거나 클릭 이벤트를 처리하는 항목은 attributionsrc 속성을 추가합니다. 클릭 이벤트의 경우 일반적으로 광고 소재를 렌더링하는 구매자 (DSP/광고주 광고 서버)가 속성을 추가합니다.

노출 이벤트의 경우 수요측 플랫폼 (DSP), 공급측 플랫폼 (SSP), 게시자, 광고 서버 또는 측정 서비스 제공업체에서 속성을 추가하며, 이는 게시자의 설정에 따라 다릅니다.

VAST 형식을 사용하는 동영상 광고의 경우 게시자와 동영상 SDK가 이 속성을 추가합니다.
2단계: 서드 파티 출처에 대한 Attribution Reporting 사용 설정 302 리디렉션과 함께 기존 리디렉션 경로를 사용하는 경우 즉시 작동합니다.

302 리디렉션을 사용할 수 없는 경우 attributionsrc 속성을 사용하여 여러 광고 기술 서버를 나열할 수 있습니다.

 일반적으로 attributionsrc 속성이 광고 소재에 추가되어 있는 한 서드 파티 리디렉션은 Attribution Reporting API 호출을 수신해야 합니다.
3단계: Attribution Reporting API 요청에 대한 응답 설정 Attribution Reporting API의 보고서를 수신하려는 모든 항목 광고주가 사용하는 DSP 및 서드 파티 측정 서비스

각 단계의 세부정보는 광고 소재가 게시자 페이지에서 렌더링되고 게재되는 방식과 Attribution Reporting API에서 전송한 보고서를 수신하는 광고 기술 항목에 따라 다릅니다.

1단계: 기존 광고 소재 및 측정 코드에 기여 분석 소스 사용 설정하기

첫 번째 단계에서는 기여 분석 소스가 사용 설정됩니다.

attributionsrc 속성의 작동 방식

새 attributionsrc 속성은 Attribution Reporting API 요청이 전송되는 위치를 지정합니다. 노출 및 클릭 이벤트를 실행하는 담당 항목은 attributionsrc 속성으로 광고 소재를 업데이트해야 합니다. attributionsrc는 기존 클릭 및 노출 이벤트에 추가해야 하며 비어 있거나 비어 있지 않을 수 있습니다.

리디렉션을 사용하는 클릭 이벤트의 경우 attributionsrc 속성을 탐색에 추가해야 합니다. 탐색 후의 302 리디렉션은 attributionsrc 속성을 추가할 필요가 없으며 초기 탐색에서 attributionsrc를 추가한 경우 ARA를 사용할 수 있습니다.

attributionsrc가 비어 있으면 ARA 요청이 앵커 태그의 href 속성에 정의된 URL (클릭연결 URL)로 전송됩니다. attributionsrc 속성이 정의되면 ARA 요청이 attributionsrc 속성에 정의된 URL로 전송됩니다. 클릭연결 URL도 소스를 등록할 수 있습니다.

일반적으로 클릭연결 URL을 호스팅하는 서버가 Attribution Reporting API 요청을 수신하고 응답할 수 있는 경우 빈 attributionsrc 속성을 사용합니다. Attribution Reporting API 요청이 다른 서버로 전송되도록 하려면 자체 attributionsrc URL을 정의합니다.

빈 attributionsrc 속성의 예:

기존 설정 ARA 통합
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

attributionsrc 속성이 비어 있으면 Attribution Reporting API 요청이 앵커 태그의 href 속성으로 정의된 URL로 전송됩니다.

비어 있지 않은 attributionsrc 속성의 예:

기존 설정 ARA 통합
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

attributionsrc가 비어 있지 않으면 Attribution Reporting API 요청이 attributionsrc 태그로 정의된 URL로 전송됩니다. 클릭연결 URL도 소스를 등록할 수 있습니다.

클릭 및 노출 이벤트에 attributionsrc 추가

  • 클릭 이벤트:
    • attributionsrc를 추가하는 책임은 일반적으로 광고 게재 기술에 있습니다.
    • 클릭 이벤트가 있는 앵커 태그에는 attributionsrc 속성이 추가되어야 합니다.
    • window.open를 사용하는 클릭은 window.open 호출의 windowFeatures 인수를 사용하여 기여 분석 소스를 지정해야 합니다.
  • 노출 이벤트:
    • attributionsrc를 추가하는 책임은 일반적으로 광고 게재 광고 기술 및 측정 서비스 제공업체에 있습니다.
    • <img> 태그 또는 <script> 태그에서 실행된 노출 이벤트에는 attributionsrc 속성이 포함되어야 합니다.
    • Fetch API를 사용하는 노출 이벤트는 fetch API 호출에 전달된 options 인수에 attributionReporting 객체를 포함해야 합니다.

클릭 및 노출 이벤트에 필요한 수정사항 요약은 다음 표를 참고하세요.

이벤트 태그 기존 설정 ARA 통합 후
클릭 HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
자바스크립트 window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
노출 HTML <img> 태그 <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
HTML <script> 태그 <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
자바스크립트 const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Protected Audience 입찰에서 기여 분석 소스 등록 사용 설정

Protected Audience 입찰에서 전환을 측정하려면 attributionsrc 대신 registerAdBeacon/registerAdMacro 및 setReportEventDataForAutomaticBeacons/reportEvent을 사용하여 기여 분석 소스 등록을 사용 설정할 수 있습니다.

Protected Audience 신호를 보고하는 경우 registerAdBeacon 함수는 보고 워크렛 내에서 사용할 수 있고 registerAdMacro는 구매자의 낙찰 보고 워크렛 내에서 사용할 수 있습니다. 그런 다음 Fenced Frame Ads Reporting API의 reportEvent 및 setReportEventDataForAutomaticBeacons 함수를 사용하여 광고 프레임 내의 이벤트 데이터를 등록된 비콘 및 매크로에 추가할 수 있습니다. 이렇게 하면 Protected Audience 보고 워크렛의 신호와 광고 소재 프레임 이벤트 페이로드가 서로 연결될 수 있습니다.

비콘과 매크로가 프레임의 reportEvent 호출에 의해 트리거되거나 자동 비콘이 브라우저에 의해 트리거되면 Attribution-Reporting-Eligible HTTP 헤더가 요청에 추가됩니다. 비콘의 응답을 사용하여 기여 분석 소스를 등록할 수 있습니다. 서드 파티 측정을 허용하기 위해 비콘 요청이 리디렉션될 수 있습니다.

자세한 내용은 Fenced Frame Ad Reporting API 설명의 기여 분석 보고 지원 섹션을 참고하세요.

VAST 형식의 기여 분석 보고 사용 설정

VAST는 동영상 광고 인벤토리를 게재하고 측정하는 데 사용되는 일반적인 형식이며 이 표준에 정의된 많은 이벤트는 Attribution Reporting API에 등록할 수 있는 잠재적 소스 이벤트로 간주되어야 합니다. 기여 분석 보고 지원을 위한 VAST 부록에서 자세히 설명하지만 간단히 말해 모든 <Tracking>, <Impression>, <*ClickThrough>, <*ClickTracking> 이벤트는 잠재적인 기여 분석 소스 이벤트입니다. 모든 VAST 구현은 이러한 이벤트에 대한 등록 자격 요건 적용 범위를 제공해야 합니다.

VAST 부록은 이러한 요소에 대한 새 속성을 정의하여 특히 저작자 표시 등록을 위한 보조 URL을 설정할 수 있도록 합니다. 이벤트에 attributiontype="DOUBLE_PING" 및 attributionsrc="[URL]"가 포함된 경우 Attribution Reporting API를 사용 설정할 때 해당 이벤트를 실행하는 코드는 attributionsrc 속성의 값으로 [URL]를 사용해야 합니다. VAST 부록에는 각 시나리오의 예시가 포함되어 있습니다.

최대 노출 범위를 보장하려면 VAST 구현은 이벤트 핑을 실행할 때 나열된 모든 이벤트가 기본적으로 등록 가능하도록 해야 합니다. 예를 들어 <Impression> 이벤트 URL을 실행할 때는 항상 수신자가 Attribution Reporting API에 해당 이벤트를 등록할 수 있도록 요청을 전송하는 데 사용된 <img> 요소 (또는 가져오기 호출의 상응하는 요소)에 (비어 있는) attributionsrc 속성을 사용해야 합니다.

2단계: 서드 파티 출처에 대한 Attribution Reporting 사용 설정

서드 파티가 Attribution Reporting API를 사용하도록 허용하려면 기존 리디렉션을 사용하거나 attributionsrc 속성에 서드 파티 목록을 추가하면 됩니다. 대부분의 경우 각 광고 기술에는 자체 독립적인 노출 추적 광고가 있으므로 리디렉션은 클릭 추적 광고와 더 관련이 있습니다.

기존 리디렉션 체인의 서드 파티 출처 처리

일반적인 광고 클릭연결의 경우 최종 방문 페이지로의 탐색의 일부로 이루어진 302 리디렉션 체인으로 많은 클릭 추적 광고가 표시될 수 있습니다. 원래 클릭 타겟이 attributionsrc로 주석 처리되었거나 Protected Audience API에서 registerAdBeacon/registerAdMacro로 등록된 경우 리디렉션 체인의 모든 요청을 Attribution Reporting API에 등록할 수 있습니다. 리디렉션 체인의 광고 기술도 등록되어야 합니다.

리디렉션 시에는 초기 요청의 본문이 전송되지 않습니다. Protected Audience 입찰의 경우 eventData가 reportEvent에 전달되고 setReportEventDataForAutomaticBeacons가 리디렉션의 일부로 사용되어야 하는 경우 리디렉션 URL의 일부로 명시적으로 전달되어야 합니다.

다음 예에서는 게재 광고 기술 (serving-adtech.example)과 서드 파티 측정 제공업체 (3p-measurement.example)를 기여 분석 보고서를 생성하고 수신하려는 두 개의 서로 다른 항목으로 사용합니다. 이 예시에서 게재 광고 기술은 게시자 사이트에서 광고 소재를 렌더링하고 자체 보고 제품을 보유한 DSP일 수 있습니다. 서드 파티 측정 서비스 제공업체는 광고주가 전환 보고에 사용하는 법인일 수 있습니다.

퍼스트 파티에서 소스를 등록한 후 서드 파티에서 소스를 등록하는 방식을 보여주는 다이어그램

소스 등록 시 다음 단계가 실행됩니다.

  1. serving-adtech.example가 광고 소재에서 attributionsrc 속성을 설정합니다. 사용자가 게시자 페이지를 방문하면 브라우저가 serving-adtech.example.에 요청을 보냅니다.
  2. serving-adtech.example는 Attribution-Reporting-Register-Source 헤더와 Location 헤더로 응답합니다.
    1. serving-adtech.example는 Attribution-Reporting-Register-Source 헤더를 사용하여 등록할 소스에 관한 메타데이터로 응답합니다.
    2. serving-adtech.example는 Location 헤더를 사용하여 3p-measurement.example로의 리디렉션을 포함합니다. Location 헤더는 서드 파티로의 302 리디렉션을 지원하기 위해 기존 클릭 추적 흐름에서 이미 사용 중일 수 있습니다.
  3. 브라우저가 serving-adtech.example에서 응답을 수신하고 Attribution-Reporting-Register-Source 헤더를 파싱합니다. 브라우저는 serving-adtech.example를 보고 출처로 사용하여 소스 이벤트를 저장합니다.
  4. 이 요청은 리디렉션이므로 브라우저는 3p-measurement.example에 새 요청도 보냅니다.
  5. 3p-measurement.example는 Attribution-Reporting-Register-Source 헤더가 포함된 응답으로 응답합니다.
  6. 브라우저는 3p-measurement.example에서 이 응답을 수신하고 Attribution-Reporting-Register-Source를 읽습니다. 브라우저는 3p-measurement.example를 보고 출처로 사용하여 소스 이벤트를 저장합니다.

리디렉션 체인에 없는 서드 파티 출처에 attributionsrc 사용

여러 개의 보고자 출처가 탐색 이벤트에 소스를 등록하려고 하지만 어떠한 이유로든 리디렉션 체인에 표시할 수 없는 경우, 대안으로 attributionsrc에서 여러 사이트를 기여 분석 소스로 나열할 수 있습니다.

기존 설정 ARA 수정 포함
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

이 예시에서는 Attribution Reporting API를 사용할 수 있는 요청이 REPORTING_URL_1와 REPORTING_URL_2 모두로 전송됩니다. 클릭연결 URL로 전송된 탐색 요청도 기여 분석 소스를 등록할 수 있습니다.

3단계: Attribution Reporting API 요청에 대한 응답 설정

Attribution Reporting API 요청을 수신하는 모든 출처의 경우 서버가 적절한 Attribution-Reporting-Register-Source 헤더로 응답하는지 확인합니다. 응답을 구성하는 방법은 소스 등록 가이드와 설명을 참고하세요.

여러 트리거 등록

전환 측면에 여러 개의 픽셀 요소를 추가하여 여러 기여 분석 트리거를 등록할 수 있습니다 (트리거당 하나씩). attributionsrc 요소는 트리거 등록에 선택사항입니다.

소스 등록과 동일한 방식으로 리디렉션 요청을 사용하거나 attributionsrc 요소에 여러 URL을 나열하여 단일 픽셀 요소에서 여러 트리거를 등록할 수도 있습니다. 동일한 출처에서 생성된 소스 이벤트와 트리거 이벤트가 일치합니다.