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