Attribution Reporting 디버깅에 관한 3부작 중 1부입니다. 디버깅이 중요한 이유와 테스트에서 디버그 보고서를 사용해야 하는 경우를 알아보세요.
디버그 보고서가 필요한 이유
Attribution Reporting API를 테스트하는 경우 통합이 제대로 작동하는지 확인하고, 쿠키 기반 구현과 Attribution Reporting 구현 간의 측정 결과 격차를 파악하고, 통합과 관련된 문제를 해결해야 합니다.
이러한 작업을 완료하려면 디버그 보고서가 필요합니다. 따라서 설정하는 것이 좋습니다.
용어 설명
이 있습니다.디버그 보고서의 주요 측면
디버그 보고서의 두 가지 유형
두 가지 유형의 디버그 보고서를 사용할 수 있습니다. 서로 다른 사용 사례를 충족하므로 둘 다 사용하세요.
성공 디버그 보고서
성공 디버그 보고서는 기여 분석 보고서 생성 성공 여부를 추적합니다. 기여 분석 보고서와 직접 관련이 있습니다.
성공 디버그 보고서는 Chrome 101 (2022년 4월)부터 사용할 수 있습니다.
상세 디버그 보고서
상세 디버그 보고서를 사용하면 소스 및 트리거 이벤트를 더 잘 파악할 수 있으므로 소스가 등록되었는지 확인하거나 누락된 보고서를 추적하고 누락된 이유 (소스 또는 트리거 이벤트 실패, 보고서 전송 또는 생성 시 실패)를 파악할 수 있습니다. 상세 디버그 보고서는 다음을 나타냅니다.
- 브라우저가 소스를 등록한 케이스입니다.
- 브라우저가 소스 또는 트리거 이벤트를 등록하지 못한 경우입니다. 즉, 기여 분석 보고서가 생성되지 않습니다.
- 어떠한 이유로든 기여 분석 보고서를 생성하거나 전송할 수 없는 케이스입니다.
상세 디버그 보고서에는 소스 등록 성공 여부 또는 소스, 트리거 또는 기여 분석 보고서가 생성되지 않은 이유를 설명하는 type 필드가 포함됩니다.
상세 디버그 보고서는 Chrome 109(2023년 1월)부터 사용할 수 있습니다(Chrome 112에서 나중에 추가된 소스 등록 성공 상세 디버그 보고서 제외).
2단계: 디버그 보고서 설정에서 보고서 예시를 검토합니다.
디버그 보고서는 쿠키 기반입니다.
디버그 보고서를 사용하려면 보고 출처에서 쿠키를 설정해야 합니다.
보고서를 수신하도록 구성된 출처가 서드 파티인 경우 이 쿠키는 서드 파티 쿠키가 됩니다. 즉, 디버그 보고서는 사용자의 브라우저에서 서드 파티 쿠키가 허용되는 경우에만 생성됩니다.
디버그 보고서가 즉시 전송됨
디버그 보고서는 브라우저에서 보고 출처로 즉시 전송됩니다. 이는 지연되어 전송되는 기여도 보고서와는 다릅니다.
성공 디버그 보고서는 상응하는 기여 분석 보고서가 생성되는 즉시 생성되고 전송됩니다. 즉, 트리거 등록 시입니다.
상세 디버그 보고서는 소스 또는 트리거 등록 시 즉시 전송됩니다.
디버그 보고서의 엔드포인트 경로가 다름
기여 분석 보고서와 마찬가지로 모든 디버그 보고서는 보고 출처로 전송됩니다. 디버그 보고서는 보고 출처의 세 가지 엔드포인트로 전송됩니다.
- 성공 디버그 보고서의 엔드포인트(이벤트 수준)
- 집계 가능한 성공 디버그 보고서의 엔드포인트
- 상세 디버그 보고서, 이벤트 수준, 집계 가능한 엔드포인트입니다.
2단계: 디버그 보고서 설정에서 자세히 알아보세요.
사용 사례
기본 실시간 통합 확인
디버그 보고서는 사용자 개인 정보를 보호하기 위해 지연되는 기여 분석 보고서와 달리 엔드포인트로 즉시 전송됩니다. 디버그 보고서를 Attribution Reporting API와의 통합이 작동하고 있다는 실시간 신호로 사용합니다.
3단계: 디버깅 레시피에서 이 작업을 수행하는 방법을 알아보세요.
손실 분석
서드 파티 쿠키와 달리 Attribution Reporting API에는 유용성과 개인 정보 보호 간의 균형을 맞추기 위해 설계된 내장 개인 정보 보호 기능이 포함되어 있습니다. 즉, Attribution Reporting API를 사용하면 쿠키로 수집할 수 있는 측정 데이터를 모두 수집하지 못할 수도 있습니다. 서드 파티 쿠키로 추적할 수 있는 모든 전환이 기여 분석 보고서를 생성하는 것은 아닙니다.
예를 들어 이벤트 수준 보고서의 경우 노출당 최대 1개의 전환을 등록할 수 있습니다. 즉, 사용자가 전환한 횟수와 관계없이 특정 광고 노출에 대해 기여 분석 보고서가 하나만 제공됩니다.
디버그 보고서를 사용하여 쿠키 기반 측정 결과와 Attribution Reporting API로 얻은 결과 간의 차이를 파악할 수 있습니다. 보고되는 전환, 보고되지 않는 전환수, 특히 어떤 전환이 보고되지 않는지, 그 이유를 파악합니다.
3단계: 디버깅 설명서에서 손실 분석을 실행하는 방법을 알아보세요.
문제 해결
개인 정보 보호 또는 리소스 보호로 인한 손실은 예상되지만 다른 손실은 의도치 않게 발생할 수 있습니다. 구현의 구성 오류나 브라우저 자체의 버그로 인해 보고서가 누락될 수 있습니다.
디버그 보고서를 사용하여 내 측의 구현 문제를 감지하고 수정하거나 브라우저팀에 잠재적인 버그를 신고할 수 있습니다. 3단계: 디버깅 레시피에서 이 작업을 수행하는 방법을 알아보세요.
고급 구성 확인
Attribution Reporting API의 일부 기능을 사용하면 API의 동작을 맞춤설정할 수 있습니다. 필터링 규칙, 중복 삭제 규칙, 우선순위 규칙 등이 여기에 해당합니다.
이러한 기능을 사용할 때는 디버그 보고서를 사용하여 기여 분석 보고서를 기다리지 않고 로직이 프로덕션에서 의도한 동작을 유도하는지 확인합니다. 3단계: 디버깅 레시피에서 이 작업을 수행하는 방법을 알아보세요.
집계 가능한 보고서를 사용한 로컬 테스트
암호화된 집계 가능 기여 분석 보고서와 달리 집계 가능 디버그 보고서에는 암호화되지 않은 페이로드가 포함됩니다.
집계 가능한 디버그 보고서를 사용하여 집계 가능한 보고서의 콘텐츠를 검증하고 테스트를 위해 로컬 집계 도구로 요약 보고서를 생성합니다.
집계 서비스 보고서 재처리
디버그 모드를 사용하면 보고서를 다시 처리할 수도 있습니다. 따라서 보고서를 두 번 이상 처리하려면 디버그 보고서를 사용 설정해야 합니다. 다음과 같은 경우 보고서를 다시 처리하는 것이 좋습니다.
- 집계 서비스를 디버그하려고 시도합니다.
- 다양한 일괄 처리 전략을 실험하고 있습니다.
- 다양한 에피론 값을 실험합니다.
데이터 복구
광고 기술은 보고 데이터를 복구할 수 있도록 디버그 모드를 사용 설정하여 디버그 보고서를 수신하는 것이 좋습니다. 이는 요약 보고서 생성에 실패할 수 있는 서비스가 제공되지 않거나 응답하지 않는 등 집계 서비스 문제가 발생한 경우에 유용합니다.