이 페이지는 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 사용을 금지하는 다른 설정이 있을 수 있습니다. 사용자 개인 정보 보호를 위해 프로그래매틱 방식으로 이를 확인할 수 있는 방법은 없습니다.