이 가이드에서는 Attribution Reporting API를 사용하여 이벤트 수준 및 요약 기여 분석 보고서를 모두 개략적으로 설명하고 설정 방법을 안내합니다.
먼저 다음을 학습합니다.
Attribution Reporting API 보고서 유형 구분
API 구현 및 보고서 생성 단계 완료
참조 및 문제 해결 정보 찾기
보고서 유형 선택
다양한 수준의 세부정보와 개인 정보 보호를 통해 광고 캠페인 실적을 효과적으로 측정하기 위해 Attribution Reporting API는 다음과 같은 두 가지 보고서 유형을 제공합니다.
이벤트 수준 보고서: 특정 광고 클릭 또는 조회 (소스)를 해당 전환 데이터 (트리거)와 연결하는 세부 데이터를 제공합니다. 이벤트 수준 보고서는 전환 데이터의 양을 제한하고 보고서에 노이즈를 추가합니다. 캠페인 도달범위 측정과 같이 개별 이벤트 기여 분석이 중요한 사용 사례에 적합합니다.
요약 보고서: 집계된 사용자 데이터를 제공하며 노이즈가 추가된 더 자세한 전환 정보가 포함될 수 있습니다. Attribution Reporting API와 Private Aggregation API를 모두 사용하여 집계 보고서에서 구성되며 이벤트 수준 보고서보다 풍부한 데이터 모델을 제공합니다. 요약 보고서는 전환 가치를 계산하거나 사용자 세그먼트 전반의 캠페인 실적을 분석하는 등 집계된 통계가 필요한 시나리오에 특히 유용합니다.
구현 개요
다음 섹션에서는 각 보고서 유형을 생성하는 대략적인 단계를 설명합니다. Attribution Reporting API 데모를 따라 전체 프로세스를 단계별로 살펴볼 수도 있습니다.
기본 요건: 소스와 트리거를 등록하고 보고서를 수신하려면 사이트에 SSL/TLS 인증서 (HTTPS)가 있어야 합니다.
이벤트 수준 보고서 생성
다음 단계에서는 이벤트 수준 보고서를 생성하는 방법을 설명합니다.
소스 등록: 광고 클릭 또는 조회를 기여 분석 정보와 연결합니다. 자세한 안내는 기여 분석 소스 등록 및 기여 분석 소스 등록을 참고하세요. 클릭과 조회수의 등록 절차는 약간 다릅니다.
트리거 등록: 전환 이벤트를 기록하고 이전에 등록된 소스에 연결합니다. 자세한 내용은 기여 분석 트리거 등록을 참고하세요.
보고 엔드포인트 설정: 이벤트 수준 보고서를 수신할 서버에 엔드포인트를 만듭니다. 엔드포인트 URL은
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution형식을 따라야 합니다.adtech.js의 예시 코드에서POST메서드의 예를 확인하세요..well-known에 대한 자세한 내용은 Wikipedia를 참고하세요.
이벤트 수준 보고서에 대해 자세히 알아보려면 이벤트 수준 보고서 설명을 참고하세요.
요약 보고서 생성
소스 등록: 이벤트 수준 보고서와 동일합니다. 자세한 내용은 기여 분석 소스 등록 및 기여 분석 소스 등록을 참고하세요.
트리거 등록: 이벤트 수준 보고서와 동일합니다. 기여 분석 트리거 등록을 참고하세요.
보고 엔드포인트 설정: 집계 보고서를 수신할 엔드포인트를 만듭니다. URL은
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution이어야 합니다.POST메서드 예시는adtech.js를,.well-known정보는 Wikipedia를 참고하세요.보고서 일괄 처리 및 전송: 집계 보고서를 일괄 처리하고 처리를 위해 집계 서비스로 전송합니다. 그러면 집계 서비스에서 요약 보고서를 생성합니다. 자세한 내용은 일괄 처리 전략을 참고하세요.
요약 보고서에 대해 자세히 알아보려면 집계 가능한 보고서 설명을 참고하세요.
구현 단계 외에도 다음 주제를 통해 요약 보고 전략을 계획할 수 있습니다.
필터 설정 (선택사항)
수신하는 기여 분석 데이터를 더 세부적으로 관리하려면 필터를 설정하면 됩니다.
필터링은 분석을 위해 데이터의 특정 하위 집합을 분리하여 노이즈를 줄이는 세련된 데이터 분석을 제공합니다. 또한 더 정확한 측정을 위해 특정 광고 캠페인 및 전환 이벤트의 실적을 추적하는 데도 도움이 됩니다.
필터링을 설정하려면 필터를 사용하여 맞춤 규칙 정의 및 기여도 트리거 등록의 트리거 섹션을 참고하여 집계 가능한 보고서에 관한 세부정보를 확인하세요.
API가 사용 설정되었는지 확인
API를 사용하기 전에 다음 코드를 사용하여 사용 설정되어 있는지 확인합니다.
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
이 확인은 현재 컨텍스트에서 API가 허용되는지 여부를 나타냅니다. 하지만 사용자 브라우저 설정이나 기타 요인으로 인해 API를 사용하지 못할 수도 있습니다. 개인 정보 보호를 고려하여 API 사용 가능 여부를 확실하게 확인할 수 있는 프로그래매틱 방법은 없습니다.
다음 단계
다음 섹션에서는 기여 분석 보고를 시작하는 방법에 대해 자세히 설명합니다.