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