이 페이지는 Cloud Translation API를 통해 번역되었습니다.

기여 분석 보고 시작하기

이 가이드에서는 Attribution Reporting 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 형식을 따라야 합니다. POST 메서드의 예는 adtech.js의 예시 코드를 참고하세요. .well-known에 관한 자세한 내용은 위키백과를 참고하세요.

이벤트 수준 보고서에 대해 자세히 알아보려면 이벤트 수준 보고서 설명을 참고하세요.

소스 등록: 이벤트 수준 보고서와 동일합니다. 자세한 내용은 기여 분석 소스 등록 및 기여 분석 소스 등록을 참고하세요.
트리거 등록: 이벤트 수준 보고서와 동일합니다. 기여 분석 트리거 등록을 참고하세요.
보고 엔드포인트 설정: 집계 보고서를 수신할 엔드포인트를 만듭니다. URL은 {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution이어야 합니다. POST 메서드 예시는 adtech.js를, .well-known 정보는 위키백과를 참고하세요.
보고서 일괄 처리 및 전송: 집계 보고서를 일괄 처리하고 처리를 위해 집계 서비스로 전송합니다. 그러면 집계 서비스에서 요약 보고서를 생성합니다. 자세한 내용은 일괄 처리 전략을 참고하세요.

요약 보고서에 대해 자세히 알아보려면 집계 가능한 보고서 설명을 참고하세요.

다음 주제는 구현 단계 외에도 요약 보고 전략을 계획하는 데 도움이 됩니다.

수신하는 기여 분석 데이터를 더 세부적으로 관리하려면 필터를 설정하면 됩니다.

필터링을 사용하면 분석할 특정 데이터 하위 집합을 분리하여 노이즈를 줄이는 정제된 데이터 분석을 제공할 수 있습니다. 또한 특정 광고 캠페인 및 전환 이벤트의 실적을 추적하여 더 정확하게 측정할 수 있습니다.

필터링을 설정하려면 필터를 사용하여 맞춤 규칙 정의를 참고하고 집계 가능한 보고서와 관련된 세부정보는 기여 분석 트리거 등록의 트리거 섹션을 참고하세요.

API를 사용하기 전에 다음 코드를 사용하여 API가 사용 설정되어 있는지 확인합니다.

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

이 검사는 현재 컨텍스트에서 API가 허용되는지 여부를 나타냅니다. 하지만 사용자 브라우저 설정이나 기타 요인으로 인해 API가 사용되지 않을 수도 있습니다. 개인 정보 보호를 고려하여 API 사용성을 확실하게 확인하는 프로그래매틱 방법은 없습니다.

다음 섹션에서는 기여 분석 보고 시작에 관한 자세한 정보를 제공합니다.