기여 분석 보고 디버깅에 관한 3부 중 3부입니다. 디버그 보고서 사용 방법에 관한 안내를 확인하세요.
이 쿡북에서는 1단계: 디버그 보고서 소개에 설명된 다양한 사용 사례에 디버그 보고서를 사용하는 방법을 안내합니다.
용어 설명
- 보고 출처는 Attribution Reporting 소스 및 트리거 헤더를 설정하는 출처입니다.
브라우저에서 생성된 모든 보고서가 이 출처로 전송됩니다. 이 안내에서는
https://adtech.example를 보고 출처의 예로 사용합니다. - 기여도 보고서 (줄여서 보고서)는 요청한 측정 데이터가 포함된 최종 보고서 (이벤트 수준 또는 집계 가능)입니다.
- 디버그 보고서에는 기여도 보고서나 소스 또는 트리거 이벤트에 관한 추가 데이터가 포함됩니다. 디버그 보고서를 수신한다고 해서 반드시 잘못 작동하는 것은 아닙니다. 두 가지 유형의 디버그 보고서
- 전환 디버그 보고서는 쿠키를 생성하여 전송해야 하는 디버그 보고서입니다. 쿠키가 설정되지 않았고 서드 파티 쿠키가 지원 중단된 후에는 전환 디버그 보고서를 사용할 수 없습니다. 이 가이드에 설명된 모든 디버그 보고서는 전환 디버그 보고서입니다.
- 성공 디버그 보고서는 기여도 보고서의 성공적인 생성을 추적합니다. 기여도 보고서와 직접 연결됩니다. 성공 디버그 보고서는 Chrome 101 (2022년 4월)부터 사용할 수 있습니다.
- 상세 디버그 보고서는 누락된 보고서를 추적하고 누락된 이유를 확인하는 데 도움이 됩니다. 브라우저가 소스 또는 트리거 이벤트를 기록하지 않은 경우(즉, 기여도 보고서가 생성되지 않음) 및 어떤 이유로든 기여도 보고서를 생성하거나 전송할 수 없는 경우를 나타냅니다.
상세 디버그 보고서에는 소스 이벤트, 트리거 이벤트 또는 기여 분석 보고서가 생성되지 않은 이유를 설명하는
type필드가 포함됩니다. 상세 디버그 보고서는 Chrome 109(2023년 1월 안정화 버전)부터 사용할 수 있습니다. - 디버그 키는 소스 측과 트리거 측 모두에서 설정할 수 있는 고유 식별자입니다. 디버그 키를 사용하면 쿠키 기반 전환과 기여 분석 기반 전환을 매핑할 수 있습니다. 디버그 보고서를 생성하고 디버그 키를 설정하도록 시스템을 설정하면 브라우저는 모든 기여 분석 보고서와 디버그 보고서에 이러한 디버그 키를 포함합니다.
문서 전반에 사용되는 추가 개념과 핵심 용어는 개인 정보 보호 샌드박스 용어집을 참고하세요.
방법: 실시간으로 통합 확인하기
- 성공 디버그 보고서를 생성하도록 시스템을 설정합니다. 2단계: 디버그 보고서 설정하기에서 방법을 알아보세요.
- 기여 분석 보고 코드를 배포할 때마다 엔드포인트에서 성공 디버그 보고서가 수신되는지 실시간으로 확인합니다. 표시되면 Attribution Reporting 설정이 작동하는 것입니다.
- 성공 디버그 보고서는 전환이 발생할 때만 전송됩니다. 대신 전환과 관계없이 통합이 제대로 설정되어 있는지 확인해야 합니다. 즉, 소스가 등록되었는지 확인해야 합니다. 이렇게 하려면 소스 등록 성공 상세 디버그 보고서를 사용하면 됩니다. 2단계: 디버그 보고서 설정에서 설정 방법을 알아보세요.
방법: 손실 분석 및 통합 문제 해결
쿠키 기반 전환 측정 결과를 기여 분석 보고 보고서와 비교하려면 디버그 키를 사용하고 쿠키 전환을 디버그 보고서에 매핑하세요. 디버그 보고서는 엔드포인트로 즉시 전송됩니다.
개요
디버그 키 (<source_debug_key, trigger_debug_key> 쌍)를 사용하여 쿠키 전환을 성공 디버그 보고서에 매핑합니다.
각 쿠키 전환의 경우 전환 시 해당하는 성공 디버그 보고서가 수신되었나요?
예: 이러한 모든 성공 디버그 보고서의 경우 몇 가지 예외를 제외하고 나중에 기여 분석 보고서를 받을 수 있습니다. 자세한 내용은 성공 디버그 보고서 시나리오를 참고하세요.
아니요: 전환이 Attribution Reporting에 등록되지 않은 것입니다. <source_debug_key, trigger_debug_key> 쌍 (또는 트리거 디버그 키가 없는 경우 소스 디버그 키)을 사용하여 쿠키 전환을 상세 디버그 보고서에 매핑합니다. 이러한 전환마다 특정 시점 (소스 또는 트리거 시간)에 상응하는 상세 디버그 보고서가 수신되었나요?
상세 디버그 보고서를 받지 못한 경우: 사용자 동작 또는 통합 문제로 인한 것일 수 있습니다. 자세한 내용은 디버그 보고서 없음 시나리오를 참고하세요.
상세 디버그 보고서를 수신한 경우
type필드를 확인합니다.type이source-success인 경우: 소스는 등록되었지만 트리거는 등록되지 않았음을 의미합니다. 성공 디버그 보고서가 누락된 이유를 파악하려면 다른 유형의 상세 디버그 보고서를 찾아보세요. 이 보고서는 트리거 측의 문제를 나타냅니다.type가 다른 값인 경우: 소스 또는 트리거가 등록되지 않았습니다.type에 이유가 표시됩니다. 해당 기여 분석 보고서 (및 성공 디버그 보고서)가 누락됩니다. 상세 디버그 보고서의type에 따라 이 정보를 손실 분석 데이터 포인트로만 사용하거나 (즉, 별도의 조치를 취하지 않음) 버그를 신고하거나 구현 문제를 해결할 수 있습니다. 자세한 내용은 상세 디버그 보고서 시나리오를 참고하세요.
가능한 시나리오
성공 디버그 보고서
특정 쿠키 전환에 대해 성공 디버그 보고서가 수신되었다면 이 전환이 Attribution Reporting에 등록되었음을 의미합니다.
이 전환에 대한 기여 분석 보고서는 나중에 받을 수 있습니다. 단, 몇 가지 예외가 있습니다.
- 사용자 행동: 전환 후 기여 분석 보고서가 전송되기 전에 데이터를 삭제하거나 브라우저를 닫는 등의 작업을 수행합니다. 사용자가 전환 후 브라우저를 닫고 일주일 동안 브라우저를 열지 않으면 일주일 이상 보고서가 전송되지 않습니다. 이 지연을 손실로 간주할 수 있습니다.
- 이벤트 수준 보고서에만 해당: 이벤트 수준 보고서가 더 높은 우선순위의 다른 보고서로 대체됩니다.
- 네트워크 문제일 수 있습니다.
source-success 유형의 상세 디버그 보고서
특정 쿠키 전환의 소스에 대해 source-success 유형의 상세 디버그 보고서가 수신되었다면 소스 등록이 성공적으로 이루어진 것입니다. 나중에 트리거 등록에 성공했는지에 따라 해당 전환에 대한 보고서가 수신되기도 하고 수신되지 않을 수도 있습니다.
단, 한 가지 주의할 점이 있습니다.
다른 유형의 상세 디버그 보고서
특정 쿠키 전환에 대해 다른 유형의 상세 디버그 보고서가 수신된 경우 성공 디버그 보고서가 수신되지 않으므로 나중에 기여 분석 보고서도 수신되지 않습니다. 상세 보고서는 보고 가능한 실패가 발생했음을 의미하기 때문입니다. 소스 등록, 트리거 등록, 보고서 생성 또는 보고서 전송을 방해하는 요소가 있습니다. 가능한 원인:
- 개인 정보 보호 한도
- 저장용량 한도
- 커스텀 규칙
- 코드의 구현 문제
- 브라우저 버그
이러한 문제는 예상되는 부분입니다. 취할 조치는 각 상세 보고서의 type에 따라 다릅니다. 상세 보고서 참조를 검토합니다.
디버그 보고서 없음
특정 쿠키 전환에 대해 기여 분석 보고서만 수신되고 (성공 디버그 보고서 또는 상세 디버그 보고서 없음) 디버그 보고서가 생성되지 않았다면 어떤 이유로 인해 디버그 보고서가 생성되지 않았음을 의미합니다. 가능한 원인:
- 사용자 환경설정 (사용자가 서드 파티 쿠키를 사용 중지함)
- 쿠키가 없거나 디버그 키가 없음 (쿠키 누락으로 인해 디버그 키가 삭제됨).
chrome://attribution-internals에서 로그 탭을 열고 문제가 표시되는지 확인합니다. - 기여 분석 보고서가 전송되지 않은 소스 또는 트리거 시점에 발생한 네트워크 문제입니다.
기여도 보고서를 받고 있나요?
이는 디버그 보고서를 수신하지 못한 경우의 하위 사례입니다. 특정 쿠키 전환에 대해 어떠한 종류의 보고서도 수신하지 못한 경우 (어떠한 종류의 디버그 보고서도 수신하지 못함, 기여 분석 보고서 없음) 보고할 수 없는 오류가 발생했다는 의미입니다. 가능한 원인:
- 기본적인 통합 문제 기본 통합 문제 해결에서 이러한 문제를 해결하는 방법을 검토하세요.
- 네트워크 문제일 수 있습니다.
- 개인 정보 보호 샌드박스와 같은 브라우저 설정의 사용자 환경설정이 사용 중지되었습니다.
상세 디버그 보고서 참조
각 상세 디버그 보고서에는 상응하는 기여 분석 보고서가 삭제된 이유를 포착하는 type 필드가 있습니다. 참조를 사용하여 상세 보고서의 각 type에 대해 취할 조치를 파악합니다.
소스 등록 완료
소스가 등록되었습니다.
source-success- 세부정보 및 보고서 본문
개인 정보 보호 제한 보고서
이러한 신고는 예상되는 사항입니다. 교차 사이트 사용자 ID 유출을 줄이기 위한 개인 정보 보호 제한을 나타냅니다.
source-destination-limit- 세부정보 및 보고서 본문
source-noised- 세부정보 및 보고서 본문
trigger-attributions-per-source-destination-limit- 세부정보 및 보고서 본문
trigger-reporting-origin-limit- 세부정보 및 보고서 본문
trigger-event-noise- 세부정보 및 보고서 본문
trigger-event-excessive-reports- 보고서 수가 한도를 초과하면 생성됩니다. 조회당 최대 1회의 전환과 클릭당 최대 3회의 전환을 등록할 수 있습니다. 우선순위를 설정하여 수신할 보고서를 구성할 수 있습니다. 세부정보 및 보고서 본문
저장용량 제한 보고서
이러한 신고는 예상되는 사항입니다. 과도한 리소스 사용을 방지하기 위해 저장용량 제한을 나타냅니다.
source-storage-limit- 세부정보 및 보고서 본문
trigger-event-storage-limit- 세부정보 및 보고서 본문
trigger-aggregate-storage-limit- 세부정보 및 보고서 본문
맞춤 규칙 보고서
필터링, 중복 삭제, 우선순위 또는 기간 기반 필터링을 사용하는 경우 이러한 보고서가 표시될 수 있습니다. 해당하는 맞춤 규칙을 다시 한번 확인하여 상세 보고서에 해당하는 보고서가 실제로 삭제하려는 보고서인지 확인합니다. 이 내용이 사실이라면 취해야 할 조치는 없습니다.
trigger-no-matching-filter-data- 세부정보 및 보고서 본문
trigger-event-no-matching-configuration- 세부정보 및 보고서 본문
trigger-event-deduplicated- 세부정보 및 보고서 본문
trigger-aggregate-deduplicated- 세부정보 및 보고서 본문
trigger-event-low-priority- 세부정보 및 보고서 본문
trigger-event-report-window-passed- 세부정보 및 보고서 본문
trigger-aggregate-report-window-passed- 세부정보 및 보고서 본문
기타 상세 보고서
이러한 보고서는 코드에 잠재적인 구현 문제가 있음을 나타낼 수 있습니다.
trigger-no-matching-source- 구현 문제일 수 있습니다.
<reporting origin, destination>설정에 구성 오류가 없는지 확인합니다. 이는 정상적인 API 동작일 수도 있습니다. 예를 들어 사용자가 광고와 상호작용한 후 전환하기 전에 데이터를 삭제했거나 관련 광고를 보지 않고 전환한 경우입니다. 세부정보 및 보고서 본문 trigger-aggregate-no-contributions- 이는 의도한 코드 동작이 아닐 수 있습니다. 트리거 등록 코드 문제를 해결합니다. 참여 구성이 올바른지 확인합니다. 세부정보 및 보고서 본문
trigger-aggregate-insufficient-budget- 이는 의도한 코드 동작이 아닐 수 있습니다. 트리거 등록 코드를 다시 한번 확인하여 모든 기여금의 합계가 기여금 예산을 초과하지 않는지 확인합니다. 세부정보 및 보고서 본문
예기치 않은 오류 (브라우저 버그일 수 있음)
예상치 못한 신고입니다. 브라우저 버그로 인해 발생할 수 있습니다. 버그를 신고하고 설명에 문제를 재현하는 단계를 지정합니다.
source-unknown-error- 세부정보 및 보고서 본문
trigger-unknown-error- 세부정보 및 보고서 본문
손실 분석 예
1단계: 쿠키로 설정 및 매핑
2단계: 디버그 보고서 설정의 안내에 따라 시스템이 성공 디버그 보고서 및 상세 디버그 보고서를 생성하도록 설정합니다.
이를 통해 쿠키 기반 전환 정보를 사용하여 상응하는 디버그 보고서 또는 기여 분석 보고서를 조회할 수 있습니다.
2단계: 성공적인 등록 및 누락된 보고서 식별
이 예에서는 쿠키 기반 시스템으로 전환 100개를 추적했다고 가정해 보겠습니다.
쿠키 기반 전환을 기록할 때마다 이 쿠키 기반 전환과 동일한 <source_debug_key, trigger_debug_key> 쌍이 있는 성공 디버그 보고서 (즉시 전송됨)를 찾습니다.
이러한 쿠키 전환 중 70개에 대해 성공 디버그 보고서가 수신되었다고 가정해 보겠습니다.
- 성공 보고서는 기여 분석이 성공적으로 기록되었음을 의미하므로 몇 가지 예외를 제외하고 각 성공 보고서에 해당하는 기여 분석 보고서가 제공된다고 가정할 수 있습니다.
- 이러한 예외를 모니터링할 수 있습니다. 이렇게 하려면 만료 기간에 따라 향후 며칠/몇 주에 걸쳐 기여 분석 보고서가 엔드포인트로 전송될 때 각 성공 디버그 보고서와 동일한 디버그 키 쌍이 있는 기여 분석 보고서를 찾습니다. 잠시 기다려 주세요. 각 기간이 끝날 때 보고서가 즉시 전송되지 않을 수 있습니다. 기여도 보고서가 60개만 있다고 가정해 보겠습니다. 누락된 기여 분석 보고서 10건은 사용자 행동으로 인한 것일 수 있습니다.
3단계: 간단한 손실 평가
100-70 = 30개의 성공 디버그 보고서가 누락되었습니다. 즉, 쿠키 기반 구현에서 추적된 30회의 전환이 기여도 보고에서 기록되지 않았습니다. 이러한 캠페인에 대한 기여도 보고서는 수신되지 않습니다.
쿠키 기반 전환이 100개이고 기여 분석 기반 전환이 70개이므로 손실은 30%입니다. 이제 간단한 손실 평가가 표시됩니다.
4단계: 원인 분석
이러한 보고서가 누락된 이유를 조사하려면 전환 (트리거 등록) 시 또는 그 이전에 소스 등록 시 수신한 상세 디버그 보고서를 찾아보세요. 쿠키 기반 전환의 키를 사용하여 상세 디버그 보고서에 매핑합니다.
- 상세 디버그 보고서가 없는 키가 10개 있다고 가정해 보겠습니다. 통합 문제가 있는지 확인합니다. 그렇지 않은 경우 사용자의 동작 때문일 수 있습니다.
- 상세 디버그 보고서가 20개 있습니다. 이제 손실 분석을 미세 조정할 수 있습니다. 각 상세 보고서의
type필드를 분석합니다. 예를 들어 다음과 같은 문제가 발생할 수 있습니다.pending destination limit로 인해 10건 (예: 10%)의 신고가 누락되었습니다.trigger-aggregate-no-contributions로 인해 5건 (= 5%)의 신고가 누락되었습니다.unknown-error로 인해 5건 (= 5%)의 신고가 누락되었습니다.
5단계: 조치 및 문제 해결
이제 보고서가 누락된 이유를 파악했으므로 이 통계를 바탕으로 조치를 취할 수 있습니다.
취할 조치는 각 상세 보고서의 type에 따라 다릅니다. 자세한 내용은 상세 보고서 참조를 검토하세요. 예를 들면 다음과 같습니다.
pending-destination-limit는 개인 정보 보호입니다. 취해야 할 조치는 없습니다. 이 숫자를 데이터 포인트로 사용하여 직접 확인하고 모니터링하세요.trigger-aggregate-no-contributions는 개발자 측의 구현 문제일 수 있습니다. 이 문제를 자세히 분석합니다. 상세 보고서 본문의 세부정보를 사용하여 문제를 해결합니다(필요한 경우).unknown-error는 브라우저 버그 또는 네트워크 오류의 신호일 수 있습니다. 이 문제가 반복적으로 발생하면 브라우저 개발자에게 버그를 신고하세요.