전환 측정 사용 설정

전환 기여도 측정에는 게시자, 광고주, 광고 게재 기술 (광고를 게재하는 법인), 측정 제공업체 등 다양한 당사자가 참여할 수 있습니다. 이 문서에서는 일반적인 전환 측정 시나리오를 설명하지만, 일반적으로 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 및 서드 파티 측정 제공업체

각 단계의 세부사항은 게시자 페이지에서 광고 소재가 렌더링되고 게재되는 방식과 기여 분석 보고 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 광고 보고 API 설명서의 Attribution Reporting 지원 섹션을 참고하세요.

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

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

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

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

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로의 리디렉션을 포함합니다. 기존 클릭 추적 흐름에서 302 리디렉션을 서드 파티로 지원하기 위해 Location 헤더가 이미 사용되고 있을 수 있습니다.
  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을 나열하여 단일 픽셀 요소에서 여러 트리거를 등록할 수도 있습니다. 동일한 출처에서 생성된 소스 이벤트와 트리거 이벤트가 일치합니다.