전환 기여 분석 측정에는 게시자, 광고주, 게재 광고 기술 (광고를 게재하는 항목), 측정 제공업체 등 여러 당사자가 포함될 수 있습니다. 이 문서에서는 일반적인 전환 측정 시나리오를 설명하지만 일반적으로 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 요청을 수신하고 응답할 준비가 되어 있는지 확인해야 합니다.
일반적인 캠페인 설정은 다음과 같습니다.
3PAS (광고주 광고 서버)는 DSP에 광고 소재의 마크업을 제공하며, 여기에는 타사 측정 제공업체의 노출 및 클릭 추적 픽셀도 포함됩니다. 광고 서버는
attributionsrc이(가) 광고 소재 마크업에 포함되어 있는지 확인해야 합니다.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단계: 서드 파티 출처에 대한 기여도 보고서 사용 설정 | 302 리디렉션이 포함된 기존 리디렉션 경로를 사용하는 경우 이 방법을 바로 사용할 수 있습니다. 302 리디렉션을 사용할 수 없는 경우 |
일반적으로 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 요청이 앵커 태그 (클릭 후 연결 URL)의 href 속성에 정의된 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를 사용하는 노출 이벤트는 가져오기 API 호출에 전달되는 options 인수에
attributionReporting객체를 포함해야 합니다.
클릭 및 노출 이벤트에 필요한 수정사항에 대한 요약은 다음 표를 참고하세요.
| 이벤트 | 태그 | 기존 설정 | ARA 통합 후 |
|---|---|---|---|
| 클릭 | HTML |
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
| JavaScript | 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>
|
|
| JavaScript |
const options = {...}window.fetch("[IMPRESSION_URL]", options);
|
const options = { attributionReporting: { eventSourceEligible: true, triggerEligible: false, }, // ...}
|
Protected Audience 입찰에서 기여 분석 소스 등록 사용 설정
Protected Audience 입찰에서 전환을 측정하는 경우 attributionsrc를 사용하는 대신 registerAdBeacon/registerAdMacro 및 setReportEventDataForAutomaticBeacons/reportEvent를 사용하여 기여 분석 소스 등록을 사용 설정할 수 있습니다.
Protected Audience 신호 보고의 경우 registerAdBeacon 함수는 보고 워크릿 내에서 사용할 수 있고 registerAdMacro는 구매자의 낙찰 보고 워크렛 내에서 사용할 수 있습니다. 그런 다음 Fenced Frame Ads Reporting API의 reportEvent 및 setReportEventDataForAutomaticBeacons 함수를 사용하여 광고 프레임 내의 이벤트 데이터를 등록된 비콘 및 매크로에 추가할 수 있습니다. 이를 통해 Protected Audience 보고 Worklet과 광고 소재 프레임 이벤트 페이로드의 신호를 서로 연결할 수 있습니다.
비콘과 매크로가 프레임의 reportEvent 호출로 트리거되거나 자동 비콘이 브라우저에 의해 트리거되면 Attribution-Reporting-Eligible HTTP 헤더가 요청에 추가됩니다. 비콘의 응답을 사용하여 기여 분석 소스를 등록할 수 있습니다. 제3자 측정을 허용하도록 비콘 요청이 리디렉션될 수 있습니다.
자세한 내용은 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를 사용 설정할 때 [URL]를 attributionsrc 속성 값으로 사용해야 합니다. VAST 부록에 각 시나리오의 예가 포함되어 있습니다.
최대한의 노출 범위를 보장하려면 VAST 구현 시 이벤트 핑을 실행할 때 기본적으로 나열된 모든 이벤트가 등록이 가능하도록 해야 합니다. 예를 들어 <Impression> 이벤트 URL을 실행할 때 (비어 있는) attributionsrc 속성은 요청을 전송하는 데 사용되는 <img> 요소 (또는 가져오기 호출의 동등한 요소)에서 수신 당사자가 이벤트를 잠재적으로 Attribution Reporting API에 등록할 수 있도록 해야 합니다.
2단계: 서드 파티 출처에 대한 기여도 보고서 사용 설정
서드 파티가 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일 수 있습니다. 서드 파티 측정 제공업체는 광고주가 전환 보고에 사용하는 항목일 수 있습니다.
소스 등록 시 다음 단계가 진행됩니다.
serving-adtech.example는 광고 소재에attributionsrc속성을 설정합니다. 사용자가 게시자 페이지를 방문하면 브라우저가serving-adtech.example.에 요청을 보냅니다.serving-adtech.example는Attribution-Reporting-Register-Source헤더와Location헤더로 응답합니다.serving-adtech.example는Attribution-Reporting-Register-Source헤더를 사용하여 등록할 소스에 관한 메타데이터로 응답합니다.serving-adtech.example는Location헤더를 사용하여3p-measurement.example에 대한 리디렉션을 포함합니다. 서드 파티로의302리디렉션을 지원하기 위해 기존 클릭 추적 흐름에서Location헤더가 이미 사용되고 있을 가능성이 높습니다.
- 브라우저가
serving-adtech.example에서 응답을 수신하고Attribution-Reporting-Register-Source헤더를 파싱합니다. 브라우저가serving-adtech.example를 보고 출처로 사용하여 소스 이벤트를 저장합니다. - 이 요청은 리디렉션이므로 브라우저가
3p-measurement.example에 새 요청을 합니다. 3p-measurement.example는Attribution-Reporting-Register-Source헤더가 포함된 응답으로 응답합니다.- 브라우저는
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을 나열하여 단일 픽셀 요소에서 여러 트리거를 등록할 수도 있습니다. 동일한 출처에서 생성된 소스 이벤트와 트리거 이벤트가 일치됩니다.