기여 분석 트리거를 등록하여 전환을 집계하는 방법을 알아보세요.
기여 분석 트리거는 브라우저에 전환을 캡처하도록 지시하는 이벤트입니다.
이 문서의 단계에 따라 트리거를 등록하여 브라우저가 관련 소스 이벤트(광고 노출 또는 광고 클릭)에 기여도를 부여하는 전환을 등록할 수 있습니다.
등록 방법
트리거를 등록하려면 HTML 요소 또는 JavaScript 호출을 사용합니다.
<img>
태그<script>
태그- 전화번호 애셋
fetch
개 XMLHttpRequest
이렇게 하면 네트워크 요청이 생성되며 이 요청은 트리거 등록 HTTP 응답 헤더로 응답합니다.
전환 기여 분석을 위한 트리거 등록
트리거를 등록하는 것은 기여 분석 소스 이벤트를 등록하는 것과 비슷합니다. 전체 단계는 뒷부분에서 설명합니다. 요약하면 다음과 같습니다.
- 트리거 등록을 시작합니다. 픽셀 또는
fetch()
호출을 사용하여 요청합니다. 트리거 등록 헤더로 응답하여 트리거 등록을 완료합니다.
픽셀 요청을 수신하면(일반적인
src
속성에 정의된 엔드포인트 또는attributionsrc
를 사용하도록 선택하고 값을 지정한 경우attributionsrc
에 정의된 엔드포인트로 전송됨)Attribution-Reporting-Register-Trigger
헤더로 응답합니다.이 헤더에서는 보고서에 최종적으로 표시할 트리거 데이터를 지정합니다. 모든 응답에서 이 헤더를 설정할 수 있습니다.
destination
와 일치하는 사이트의 요청에 대한 응답인 경우 소스가 일치됩니다. 헤더가 수신되면 브라우저가 일치하는 소스를 찾고 보고서를 예약합니다.이벤트 수준 보고서의 예:
{ "event_trigger_data": [{ "trigger_data": "[unsigned 64-bit integer]", "priority": "[signed 64-bit integer]", "deduplication_key": "[unsigned 64-bit integer]" }] }
요약 보고서의 예:
{ ... // existing fields, such as "event_trigger_data" "aggregatable_trigger_data": [ { "key_piece": "0x400", "source_keys": ["campaignCounts"] }, { "key_piece": "0xA80", "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"] } ], "aggregatable_values": { "campaignCounts": 32768, "geoValue": 1664 } }
하위 도메인 처리
destination
이 https://advertiser.example
이면 https://advertiser.example
및 그 하위 도메인(예: https://shop.advertiser.example
)
모두의 전환에 기여할 수 있습니다.
destination
이 https://shop.advertiser.example
이면 https://advertiser.example
및 https://shop.advertiser.example
모두에서 전환에 기여할 수 있습니다.
필수 및 선택적 속성
HTML 요소를 사용하거나 JavaScript를 호출하여 트리거를 등록할 때 attributionsrc
또는 attributionReporting
를 사용해야 할 수도 있습니다. 이러한 사항이 필요한 경우에 대한 자세한 내용은 다음 표를 참조하세요.
attributionsrc
가 선택사항인 경우 이를 사용하면 요청이 Attribution Reporting에 적합함을 나타냅니다. attributionsrc
를 사용하면 브라우저에서 Attribution-Reporting-Eligible
헤더를 전송합니다. 또한 앱에서 웹으로의 측정에도 유용합니다. attributionsrc
가 있으면 브라우저에서 Attribution-Reporting-Support
헤더를 전송합니다.
등록 방법 | 트리거 |
---|---|
<a> 태그 |
해당 사항 없음: 앵커는 트리거를 등록할 수 없습니다. |
<img> 태그 |
attributionsrc 는 선택사항입니다. 헤더로 트리거를 등록할 수 있습니다. |
<script> 태그 |
attributionsrc 는 선택사항입니다. 헤더로 트리거를 등록할 수 있습니다. |
전화번호 애셋 fetch 개 |
attributionReporting 옵션은 필수입니다. |
XMLHttpRequest |
attributionReporting 옵션은 필수입니다. |
window.open() |
해당 사항 없음: window.open 는 트리거를 등록할 수 없습니다. |
1단계: 트리거 등록 시작
픽셀 (<img>
태그) 또는 스크립트 태그를 사용하여 트리거를 등록할 수 있습니다.
신규 또는 기존 전환 픽셀 사용
다음 예시에서는 attributionsrc
속성을 추가하여 기존 이미지에 대한 저작자 표시를 트리거합니다.
attributionsrc
의 출처는 소스 등록을 수행한 출처와 일치해야 합니다.
<img src="https://advertiser.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
다음 예에서는 새 전환 픽셀 attributionsrc
속성을 추가하여 기여 분석을 트리거합니다.
src
의 출처는 소스 등록을 수행한 출처와 일치해야 합니다.
<img src="https://adtech.example/conversionpixel"
attributionsrc>
스크립트 태그 사용
스크립트 태그로 트리거 등록을 실행할 수 있습니다. 이 태그는 <img>
와 동일하게 동작합니다. 다음 코드 샘플은 fetch()
및 XMLHttpRequest()
(XHR)의 사용을 보여줍니다.
이 코드는 attributionsrc
를 사용하는 HTML 요청이 하는 작업을 효과적으로 시뮬레이션합니다.
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
{ keepalive: true, attributionReporting });
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();
값이 있거나 없는 attributionsrc
값을 포함하거나 포함하지 않고 attributionsrc
를 추가할 수 있습니다.
<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>
<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">
attributionsrc
값을 설정하는 경우 이 값은 공백으로 구분된 하나 이상의 URL일 수 있습니다.
URL을 사용하면 브라우저에서 Attribution-Reporting-Eligible
요청 헤더를 포함하는 별도의 연결 유지 가져오기 요청(URL당 하나씩)을 시작합니다.
이 방법은 요소의 기본 요청과 분리된 요청에 응답하여 트리거를 등록하려는 경우에 유용합니다.
예를 들어 이미지 요소에 트리거를 등록해야 하는 경우 실제로 이미지 응답을 제어하지 못할 수도 있습니다. 이 경우 이미지와 분리된 요청에 대한 응답으로 트리거 등록 헤더를 전송하고 완전히 제어할 수 있는 구성이 필요할 수 있습니다. attributionsrc
에 명시적 값을 지정하면 브라우저가 추가 요청을 실행하고 대상을 구성하도록 지시하게 됩니다.
2단계: 헤더로 응답
브라우저 요청을 받으면 다음과 같이 응답하고 Attribution-Reporting-Register-Trigger
헤더를 포함합니다.
JSON.stringify({
event_trigger_data: [{
trigger_data: "412444888111012",
// Optional
priority: "1000000000000",
deduplication_key: "2345698765"
}],
debug_key: "1115698977"
});
다음 단계
기여 분석 소스를 등록하는 방법을 알아보세요.