[더 이상 사용되지 않음] 이전 가이드 (Chrome 92): Conversion Measurement API에서 Attribution Reporting API로

Chrome 92에서 Conversion Measurement API가 변경됩니다.

변경되는 사항

2021년 첫 몇 달 동안 API 제안이 변경됨에 따라 Chrome의 API 구현이 진화하고 있습니다. 변경되는 사항은 다음과 같습니다.

  • API 이름 및 권한 정책 이름
  • HTML 속성 이름 및 .well-known URL
  • 보고서의 형식입니다. 이제 보고서가 요청 본문에서 JSON으로 전송됩니다.
  • 보고서의 콘텐츠(credit)와 크레딧이 0인 보고서와 함께 삭제되었습니다.

Chrome 92에서 변경되지 않은 것은 클릭 전용 이벤트 수준 보고서 등 지원되는 기능입니다. 관련 업데이트를 확인하세요. 이번 변경 후에 다른 업데이트 및 기능이 향후 Chrome 버전에서 출시됩니다.

이 변경사항은 언제부터 적용되나요?

이러한 변경사항은 2021년 7월 20일 안정화된 Chrome 92부터 적용됩니다. Chrome 92 베타는 2021년 6월 3일에 출시되었습니다.

어떻게 해야 하나요?

오리진 트라이얼을 실행 중이거나 이 API의 데모를 구현한 경우 다음 두 가지 옵션이 있습니다.

  • 옵션 1(권장): 지금 또는 몇 주 내(가급적 2021년 7월 중순 이전)에 코드를 이전하세요. 이렇게 하면 코드베이스가 향후 변경사항에도 대비되고 최신 Chrome 클라이언트에서도 계속 작동합니다.
  • 옵션 2: 향후 Chrome 버전에 추가 업데이트와 기능이 출시될 때까지 기다린 다음 필요한 코드를 모두 한 번에 변경합니다.

마이그레이션

이전 예시

이 pull 요청 (초안)에서 소규모 데모 앱의 이전 예시를 확인할 수 있습니다.

권한 정책 코드 업데이트

기존 코드 새로운 코드 받기
allow='conversion-measurement' allow='attribution-reporting'

특성 감지 코드 업데이트

기존 코드 새로운 코드 받기
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

HTML 속성 업데이트

기존 코드 새로운 코드 받기
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

window.open() 인수 업데이트

window.open()에 의해 시작된 탐색에 대해 기여 분석 소스를 등록할 수 있습니다. window.open()를 사용하여 기여 분석 소스를 등록하는 경우 이러한 호출을 업데이트합니다.

새 코드는 다음과 같습니다 (HTML 속성 이름 변경에 따른 이름 변경).

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

등록 호출 URL 및 매개변수 업데이트

기존 코드 새로운 코드 받기
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

보고 엔드포인트 코드 업데이트

기존 코드 새로운 코드 받기
브라우저에서 예상되는 요청 .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
수신 보고서 URL 매개변수로 전송됩니다. 요청 본문에서 JSON으로 전송됩니다.

보고서 데이터는 다음 키와 함께 JSON 객체로 요청 본문에 포함됩니다.
source_event_id:이전 impression-data: 기여 분석 소스에 설정된 64비트 이벤트 ID입니다.
trigger_data: 이전 명칭은 conversion-data이며 기여 분석 트리거 리디렉션의 3비트 데이터 세트입니다.

⚠️ credit이 삭제되었습니다.

Attribution Reporting: 모든 리소스

기여도 보고를 참고하세요.