기여 분석 트리거 등록

기여 분석 트리거를 등록하여 전환을 집계하는 방법을 알아보세요.

기여 분석 트리거는 브라우저에 전환을 캡처하도록 지시하는 이벤트입니다.

이 문서의 단계에 따라 트리거를 등록하여 브라우저가 관련 소스 이벤트(광고 노출 또는 광고 클릭)에 기여도를 부여하는 전환을 등록할 수 있습니다.

등록 방법

트리거를 등록하려면 HTML 요소 또는 JavaScript 호출을 사용합니다.

  • <img> 태그
  • <script> 태그
  • fetch 통화
  • XMLHttpRequest

이렇게 하면 네트워크 요청이 생성되며 이 요청은 트리거 등록 HTTP 응답 헤더로 응답합니다.

전환 기여 분석을 위한 트리거 등록

트리거를 등록하는 방법은 다음과 같습니다. 기여 분석 소스 이벤트 등록 전체 단계는 뒷부분에서 설명합니다. 요약하면 다음과 같습니다.

  1. 트리거 등록을 시작합니다. Pixel 또는 fetch() 호출을 사용하여 요청할 수 있습니다

  2. 트리거로 응답하여 트리거 등록을 완료합니다. 등록 헤더의 캡션을 확인할 수 있습니다.

    픽셀 요청을 받으면 일반적인 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 요소를 사용하거나 자바스크립트를 호출할 때 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>
<ph type="x-smartling-placeholder">

스크립트 태그 사용

스크립트 태그로 트리거 등록을 수행할 수 있습니다. <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();
<ph type="x-smartling-placeholder">

값이 있거나 없는 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을 사용하면 브라우저에서 별도의 연결 유지 가져오기 요청을 시작하게 됩니다. 즉, 각 URL - Attribution-Reporting-Eligible 요청 포함 헤더를 클릭하세요.

이 함수는 요청에 응답하여 트리거를 등록하려는 경우에 요청을 받습니다.

예를 들어 이미지 요소에 트리거를 등록해야 하는 경우 사용자는 실제로 이미지 응답을 제어할 수 없을 수도 있습니다. 이 경우 요청에 대한 응답으로 트리거 등록 헤더를 전송하는 구성 이미지와 분리되어 있으며 완전히 제어할 수 있습니다. 작성자: attributionsrc에 명시적 값을 지정하면 브라우저에서 추가 요청을 하고 대상을 구성할 수 있습니다.

2단계: 헤더로 응답

브라우저 요청을 받으면 다음과 같이 응답하고 Attribution-Reporting-Register-Trigger 헤더를 포함합니다.

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

다음 단계

기여 분석 소스를 등록하는 방법을 알아보세요.