어트리뷰션 API

어트리뷰션 API를 사용하여 모바일 측정 파트너 또는 마케팅 플랫폼에서 어트리뷰션 캠페인 이벤트를 Amplitude로 전송하십시오. 각 이벤트는 idfa, idfv, adid 또는 android_app_set_id을(를) 사용하여 사용자를 식별하므로 Amplitude는 어트리뷰션 데이터를 올바른 사용자와 매칭시켜 분석 전반에 걸쳐 이를 표시할 수 있습니다.

지역

기본 URL은 프로젝트의 데이터 상주 위치에 따라 달라집니다. 이 페이지의 모든 예제에서 프로젝트가 Amplitude의 EU 데이터 센터를 사용하지 않는 한 기본 URL을 사용하십시오. 이 경우 이 표의 EU 기본 URL을 사용하십시오.

이 API는 api.amplitude.com(기본값) 또는 api.eu.amplitude.com(EU)를 사용합니다. 이벤트 수집은 종종 api2.amplitude.com을(를) 사용합니다. 다른 Amplitude API는 각 제품에 대해 문서화된 대로 core.amplitude.com, data-api.amplitude.com 또는 experiment.amplitude.com을(를) 사용합니다. https://analytics.amplitude.com 호스트 이름은 이 API 엔드포인트가 아닌 분석 웹 앱(브라우저 UI)입니다.

일치 및 식별자 요구 사항

• Amplitude가 어트리뷰션 이벤트를 기존 사용자와 일치시킬 수 없는 경우, Amplitude는 해당 이벤트를 최대 72시간 동안 보관합니다. 72시간 첫 사용 후 일치하는 사용자에 대한 이벤트가 기록되지 않으면 Amplitude는 어트리뷰션 데이터를 삭제합니다.
• 대부분의 Amplitude 파트너의 경우, Amplitude는 광고 ID(IDFA 또는 ADID) 또는 공급업체 ID(IDFV 또는 앱 세트 ID)를 사용하여 사용자와 이벤트를 어트리뷰션합니다. 이러한 식별자를 어트리뷰션 요청에 전송하고 Amplitude의 idfa, idfv, adid 및 android_app_set_id 필드를 속성 ID로 설정하십시오.
• iOS SDK 또는 Android SDK를 사용하는 경우, iOS Swift SDK 지침에 따라 광고 ID 추적을 활성화하십시오. JavaScript SDK 및 React Native SDK는 광고 ID 및 웹 추적에 대한 Google과 Apple의 개인정보 보호 규칙 때문에 광고 ID를 자동으로 수집할 수 없습니다. HTTP API 엔드포인트를 통해 광고 ID를 전송하여 Amplitude가 어트리뷰션 이벤트를 일치시킬 수 있도록 합니다. HTTP API V2 문서의 키를 참조하십시오.

어트리뷰션 이벤트 전송

api_key 및 event의 두 인수를 사용하여 {{standard_endpoint}}에 POST 요청을 전송합니다.

필수 인수

이벤트 인수 키

요청 예제

다음 코드는 iOS용 어트리뷰션을 보여줍니다.

curl --location --request POST 'https://api.amplitude.com/attribution' \
--data-urlencode 'api_key=123456789' \
--data-urlencode 'event={"event_type":"[YOUR COMPANY] Install", "idfa": "AEBE52E7-03EE-455A-B3C4-E57283966239", "user_properties": {"[YOUR COMPANY] media source": "facebook", "[YOUR COMPANY] campaign": "refer-a-friend"}, "platform": "ios"}'

다음 코드는 Android에 대한 어트리뷰션을 보여줍니다.

curl --location -g --request POST 'https://api2.amplitude.com/attribution?api_key=123456789&event={"event_type":"[YOUR COMPANY] Install","adid": "AEBE52E7-03EE-455A-B3C4-E57283966239", "user_properties": {"[YOUR COMPANY] media source": "facebook", "[YOUR COMPANY] campaign": "refer-a-friend"}, "platform": "android"}'

응답