기여도 보고 디버깅에 관한 3부 중 3부입니다. 디버그 보고서 사용 방법에 대한 안내를 찾아보세요.
이 설명서에서는 1부: 디버그 보고서 소개에 설명된 다양한 사용 사례의 디버그 보고서를 사용하는 방법을 확인할 수 있습니다.
용어 설명
- 보고 출처는 Attribution Reporting 소스 및 트리거 헤더를 설정하는 출처입니다.
브라우저에서 생성된 모든 보고서가 이 출처로 전송됩니다. 이 안내에서는
https://adtech.example
를 보고 출처의 예로 사용합니다. - 기여도 보고서 (줄여서 보고서)는 요청한 측정 데이터가 포함된 최종 보고서 (이벤트 수준 또는 집계 가능)입니다.
- 디버그 보고서에는 기여도 보고서나 소스 또는 트리거 이벤트에 관한 추가 데이터가 포함됩니다. 디버그 보고서를 수신한다고 해서 반드시 잘못 작동하는 것은 아닙니다. 두 가지 유형의 디버그 보고서
- 전환 디버그 보고서는 쿠키를 생성하여 전송해야 하는 디버그 보고서입니다. 쿠키가 설정되지 않았고 서드 파티 쿠키가 지원 중단된 후에는 전환 디버그 보고서를 사용할 수 없습니다. 이 가이드에 설명된 모든 디버그 보고서는 전환 디버그 보고서입니다.
- 성공 디버그 보고서는 기여도 보고서의 성공적인 생성을 추적합니다. 기여도 보고서와 직접 연결됩니다. 성공 디버그 보고서는 Chrome 101 (2022년 4월)부터 사용할 수 있습니다.
- 상세 디버그 보고서는 누락된 보고서를 추적하고 누락된 이유를 확인하는 데 도움이 됩니다. 브라우저가 소스 또는 트리거 이벤트를 기록하지 않은 경우(즉, 기여도 보고서가 생성되지 않음) 및 어떤 이유로든 기여도 보고서를 생성하거나 전송할 수 없는 경우를 나타냅니다.
상세 디버그 보고서에는 소스 이벤트, 트리거 이벤트 또는 기여 분석 보고서가 생성되지 않은 이유를 설명하는
type
필드가 포함됩니다. 상세 디버그 보고서는 Chrome 109(2023년 1월 안정화 버전)부터 사용할 수 있습니다. - 디버그 키는 소스 측과 트리거 측 모두에서 설정할 수 있는 고유 식별자입니다. 디버그 키를 사용하면 쿠키 기반 전환과 기여 분석 기반 전환을 매핑할 수 있습니다. 디버그 보고서를 생성하고 디버그 키를 설정하도록 시스템을 설정하면 브라우저는 모든 기여 분석 보고서와 디버그 보고서에 이러한 디버그 키를 포함합니다.
문서 전반에 사용되는 추가 개념과 핵심 용어는 개인 정보 보호 샌드박스 용어집을 참고하세요.
방법: 실시간으로 통합 확인하기
- 성공 디버그 보고서를 생성하도록 시스템을 설정합니다. 자세한 방법은 2부: 디버그 보고서 설정하기를 참고하세요.
- Attribution Reporting 코드를 배포할 때마다 엔드포인트에서 성공 디버그 보고서가 수신되는지 실시간으로 확인하세요. 표시되었다면 기여도 보고 설정이 작동하고 있는 것입니다.
- 성공 디버그 보고서는 전환이 발생할 때만 전송됩니다. 대신 전환과 관계없이 통합이 올바르게 설정되었는지, 즉 소스가 성공적으로 등록되었는지 확인하는 것이 좋습니다. 이렇게 하려면 소스 등록 성공 상세 디버그 보고서를 사용하면 됩니다. 2부: 디버그 보고서 설정에서 설정 방법을 참고하세요.
방법: 손실 분석 및 통합 문제 해결
쿠키 기반 전환 측정 결과를 기여도 보고 보고서와 비교하려면 디버그 키를 사용하고 쿠키 전환을 디버그 보고서와 매핑하세요. 디버그 보고서는 엔드포인트로 즉시 전송됩니다.
개요
![손실 분석 단계](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=2&hl=ko)
디버그 키 (<source_debug_key, trigger_debug_key>
쌍)를 사용하여 쿠키 전환을 성공적인 디버그 보고서에 매핑합니다.
전환 시 각 쿠키 전환에 해당하는 성공 디버그 보고서를 받으셨나요?
'예'인 경우: 모든 성공 디버그 보고서에 대해 나중에 기여도 보고서를 받을 수 있지만 몇 가지 예외가 있습니다. 자세한 내용은 성공 디버그 보고서 시나리오를 참고하세요.
등록되지 않은 경우: 전환이 Attribution Reporting에 등록되지 않았다는 의미입니다. <source_debug_key, trigger_debug_key>
쌍 (또는 트리거 디버그 키가 없는 경우 소스 디버그 키)을 사용하여 쿠키 전환을 상세 디버그 보고서에 매핑합니다. 이러한 각 전환에 대해 특정 시점 (소스 또는 트리거 시간)에 해당하는 상세 디버그 보고서를 받았나요?
상세 디버그 보고서를 받지 못한 경우: 사용자 동작 또는 통합 문제 때문일 수 있습니다. 자세한 내용은 디버그 보고서 없음 시나리오를 참고하세요.
상세 디버그 보고서를 수신했다면
type
필드를 확인하세요.type
가source-success
인 경우: 소스가 성공적으로 등록되었지만 트리거가 등록되지 않았음을 의미합니다. 성공 디버그 보고서가 누락된 이유를 좁히려면 트리거 측 문제를 나타내는 다른 유형의 상세 디버그 보고서를 찾아보세요.type
가 다른 경우: 소스 또는 트리거가 등록되지 않은 것입니다.type
에서 그 이유를 알 수 있습니다. 해당하는 기여도 보고서 및 성공 디버그 보고서가 표시되지 않습니다. 상세 디버그 보고서의type
에 따라 이 정보를 손실 분석 데이터 포인트로 간주하거나 (즉, 조치를 취하지 않음) 버그를 신고하거나 구현 문제를 해결할 수 있습니다. 자세한 내용은 상세 디버그 보고서 시나리오를 참고하세요.
가능한 시나리오
성공 디버그 보고서
특정 쿠키 전환에 대해 성공 디버그 보고서를 받았다면 이 전환이 Attribution Reporting에 성공적으로 등록되었음을 의미합니다.
나중에 이 전환에 대한 기여도 보고서를 받을 수 있습니다.⏤ 다음과 같은 몇 가지 예외가 있습니다.
- 사용자 행동: 전환 후, 기여도 보고서가 전송되기 전에 데이터 삭제, 브라우저 종료 등. 사용자가 전환 후 브라우저를 닫고 일주일 동안 브라우저를 열지 않으면 보고서가 1주일 이상 전송되지 않습니다. 이러한 지연은 손실로 간주될 수 있습니다.
- 이벤트 수준에만 적용: 이벤트 수준 보고서가 우선순위가 더 높은 다른 보고서로 대체됩니다.
- 네트워크 문제일 수 있습니다.
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회의 전환은 Attribution Reporting에 기록되지 않았습니다. 이에 대한 기여도 보고서가 전송되지 않습니다.
쿠키 기반 전환이 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
은 브라우저 버그나 네트워크 오류의 징후일 수 있습니다. 이 문제가 반복해서 발생하면 브라우저 개발자를 위해 버그를 신고하세요.