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

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

변경되는 사항

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

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

Chrome 92에서 변경되지 않은 기능은 지원되는 기능 세트입니다. 클릭 전용 이벤트 수준 보고서가 지원됩니다. 관련 업데이트를 기대해 주세요. 이번 변경사항이 적용된 후 향후 Chrome 버전에 다른 업데이트와 기능이 출시될 예정입니다.

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

이 변경사항은 Chrome 92, 2021년 7월 20일 안정화 버전 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이(가) 삭제되었습니다.

Attribution Reporting: 모든 리소스

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