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

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

변경되는 사항

2021년 초 API 제안서의 변경사항에 따라 Chrome의 API 구현이 발전하고 있습니다. 변경되는 사항은 다음과 같습니다.

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

Chrome 92에서는 클릭에 대해서만 이벤트 수준 보고서를 지원하는 기능 집합이 변경되지 않았습니다. 이 문제에 대한 업데이트가 있을 예정입니다. 이 변경사항이 적용된 후에는 향후 Chrome 버전에서 다른 업데이트와 기능이 출시될 예정입니다.

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

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

어떻게 해야 할까요?

오리진 체험판을 실행 중이거나 이 API용 데모를 구현한 경우 다음 두 가지 옵션이 있습니다.

  • 옵션 1(권장): 지금 또는 앞으로 몇 주 이내에 코드를 이전합니다(가급적 2021년 7월 중순 이전). 이렇게 하면 코드베이스가 향후 변경사항에 대비할 수 있으며 최신 Chrome 클라이언트에서 계속 작동합니다.
  • 옵션 2: 향후 Chrome 버전에서 더 많은 업데이트와 기능이 출시될 때까지 기다렸다가 필요한 모든 코드를 한 번에 변경합니다.

마이그레이션

마이그레이션 예시

이 풀 리퀘스트 (초안)에서 소규모 데모 앱의 이전 예시를 확인할 수 있습니다.

권한 정책 코드 업데이트

기존 코드 새로운 코드 받기
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가 삭제되었습니다.

기여 분석 보고: 모든 리소스

기여 분석 보고서를 참고하세요.