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

Chrome 92에서 전환 측정 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 버전에서 더 많은 업데이트와 기능이 출시될 때까지 기다린 후 필요한 모든 코드 변경사항을 한 번에 적용합니다.

마이그레이션

마이그레이션 예시

이 풀 요청 (초안)에서 작은 데모 앱의 이전 예를 확인할 수 있습니다.

권한 정책 코드 업데이트

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

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

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