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

기여도 보고 시작하기

여기에서 설정, 간단한 개요 등 자세한 내용을 확인할 수 있습니다.

보고서 유형 선택

Attribution Reporting API를 사용하여 이벤트 수준 보고서와 요약 보고서라는 두 가지 유형의 보고서를 생성할 수 있습니다. 이벤트 수준 보고서는 집계 가능한 보고서 또는 요약 보고서보다 설정이 덜 필요하므로 처음 시작하는 것이 좋습니다. 요약 보고서는 집계 서비스와의 통합이 필요하지만 이벤트 수준 보고서는 통합하지 않습니다.

이벤트 수준 보고서와 요약 보고서 모두에 대해 보고를 설정할 수 있습니다. 두 항목은 상호 보완적입니다.

이벤트 수준 보고서

이벤트 수준 보고서는 광고 측의 특정 광고 클릭 또는 조회를 전환 측 데이터와 연결합니다. 사이트 간에 사용자 ID의 조인을 제한하여 사용자 개인 정보를 보호하기 위해 전환 측 데이터는 매우 제한되고 데이터에 노이즈가 있습니다.

요약 보고서

요약 보고서는 Attribution Reporting API 및 Private Aggregation API 보고서 유형입니다. 요약 보고서는 집계된 사용자 데이터를 포함하며 노이즈가 추가된 자세한 전환 데이터를 포함할 수 있습니다. 요약 보고서는 종합 보고서로 구성됩니다.

구현

다음 단계를 시도하여 시작할 수 있습니다.

특정 이벤트 소스의 경우 이벤트 수준 보고서와 집계 가능한 보고서를 모두 생성할 수 있습니다. 데모에서 이 과정을 안내합니다.

이벤트 수준 보고서 생성

이벤트 수준 보고서를 생성하기 위해 따라야 하는 최소 단계는 다음과 같습니다.

소스 등록 자세한 내용은 기여 분석 소스 등록을 참고하세요. 클릭수와 조회수는 단계가 다릅니다.
트리거 등록 자세한 내용은 기여 분석 트리거 등록을 참고하세요.
다음 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에 대한 자세한 내용은 여기를 참고하세요.
요약 보고서를 생성하는 집계 서비스에서 추가 처리를 위해 보고서를 일괄 처리하고 전송합니다. 일괄 집계 가능한 보고서를 참조하세요.

요약 보고서에 대한 자세한 내용은 여기를 참조하세요.

기여도 보고 디버깅 시리즈에서 디버그 보고서를 설정하는 방법을 알아보세요.

요약 보고서 추가 개념

여기에서 구현 단계를 이해하는 것 외에도 다음 개념을 참조하면 요약 보고서 전략을 계획하는 데 도움이 됩니다.

선택 단계

필터 설정 (선택사항):
1. 필터를 사용하여 커스텀 규칙 정의의 안내를 따릅니다.
2. 설명서의 트리거 섹션에서 집계 가능한 보고서의 필터와 관련된 세부정보를 검토하세요.

특성 감지를 잊지 마세요.

API를 사용하기 전에 권한 정책을 사용하여 페이지에서 차단되지 않았는지 확인합니다. 이렇게 하려면 다음 코드를 실행합니다.

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

이 기능 감지 검사가 true를 반환하면 검사가 실행되는 컨텍스트 (페이지)에서 API가 허용됩니다.

이 검사만으로도 페이지에서 API를 사용할 수 있다는 보장은 없습니다. 사용자가 브라우저 설정을 사용하여 API를 사용 중지했거나 API 사용을 막는 다른 설정이 있을 수 있습니다. 사용자 개인 정보 보호를 위해 프로그래매틱 방식으로 확인할 방법은 없습니다.