기여 분석 트리거를 등록하여 전환을 집계하는 방법을 알아보세요.
기여 분석 트리거는 브라우저에 전환을 캡처하도록 지시하는 이벤트입니다.
이 문서의 단계에 따라 트리거를 등록하여 브라우저에서 관련 소스 이벤트(예: 광고 노출 또는 광고 클릭)에 기여도를 부여하는 전환을 등록할 수 있습니다.
등록 방법
트리거를 등록하려면 HTML 요소 또는 자바스크립트 호출을 사용합니다.
<a>
태그<img>
태그<script>
태그- 전화번호 애셋
fetch
개 XMLHttpRequest
window.open
그러면 트리거 등록 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]" }] } ``` **Example for summary reports:** ```json { ... // 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 요소를 사용하거나 자바스크립트를 호출하여 트리거를 등록할 때 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>
태그) 또는 스크립트 태그를 사용하여 트리거를 등록할 수 있습니다.
신규 또는 기존 전환 픽셀 사용
<img src="https://ad-tech.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
스크립트 태그 사용
스크립트 태그를 사용하여 트리거 등록을 실행할 수 있습니다. 스크립트 태그는 <img>
와 동일하게 작동합니다. 다음 코드 샘플은 fetch()
및 XMLHttpRequest()
(XHR)의 사용을 보여줍니다.
이 코드는 attributionsrc
를 사용한 HTML 요청이 실행하는 작업을 효과적으로 시뮬레이션합니다.
// With fetch
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 });
// With XMLHttpRequest:
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'})
다음 단계
기여 분석 소스 등록 방법을 알아보세요.