에어브릿지는 앰플리튜드 솔루션으로 Airbridge에서 수집된 어트리뷰션 데이터 혹은 이벤트 데이터를 보낼 수 있도록 지원하고 있습니다. 에어브릿지에서 수집된 정보는 앰플리튜드 내의 데이터와 함께 더 정교한 분석을 할 수 있도록 활용할 수 있습니다. 아래에서 각 버전에 따른 안내사항을 참고 하시기 바랍니다.
앰플리튜드 연동 관련 사항
앰플리튜드의 Attribution Solution 연동을 위해서는 공통적으로 ADID 수집을 위한 선작업이 필요합니다. V1과 V2 둘 다 연동시, 데이터가 중복으로 집계되는 경우가 발생할 수 있으므로, 하나의 버전으로만 연동을 진행하시길 바랍니다.
앰플리튜드 API의 endpoint는 Standard(미국)와 EU 서버 두 곳이 존재합니다. 기본적으로 에어브릿지에서 전송되는 데이터는 Standard 서버로 전송되며, EU 서버로 전송을 희망하시는 경우 support@airbridge.io로 연락주시기 바랍니다.
V1 연동
V1 연동은 앰플리튜드에서 제공하는 어트리뷰션 API를 통해 이루어집니다. 연동이 정상적으로 완료되면 에어브릿지는 연동 이후에 발생하는 타겟 이벤트(앱 설치 또는 딥링크 오픈)를 앰플리튜드로 전송합니다. 그외 다른 이벤트는 V1 연동으로 전송할 수 없습니다. 만약 타겟 이벤트 이후에 발생하는 인앱이벤트도 앰플리튜드에 전송하고 싶다면 유저는 V2 방식으로 연동해야 합니다.
V1 방식으로 연동하면 에어브릿지로 트래킹된 어트리뷰션 데이터도 타겟 이벤트와 함께 앰플리튜드로 전송됩니다. 앰플리튜드는 채널, 캠페인과 같은 정보를 포함한 이 어트리뷰션 데이터를 User Properties(유저 프로퍼티스)에 추가합니다.
사용자 매칭
V1 방식으로 에어브릿지와 연동된 앰플리튜드는 대소문자를 구분한 ADID, 즉 안드로이드의 GAID와 iOS의 IDFA, IDFV를 기준으로 사용자를 매칭합니다. 만약 에어브릿지에서 ADID 값이 수집되지 않았다면 앰플리튜드는 null 등 사용자 매칭을 할 수 없는 값을 받습니다.
따라서 에어브릿지가 ADID 값을 정상적으로 전송하더라도 해당 값이 사용자 매칭을 할 수 없는 값이라면 앰플리튜드는 사용자 매칭에 실패할 수 있습니다. 앰플리튜드는 데이터가 전송된 시점에 사용자 매칭을 실패하면 이후 72시간 동안 데이터를 보관한 채로 사용자 매칭을 시도합니다. 정해진 시간 안에도 사용자가 매칭되지 않으면 데이터는 폐기됩니다.
만약 ADID를 통한 사용자 매칭이 원활히 되지 않고, 매칭 확률을 높이고 싶다면 V2 연동이 더 효과적일 수 있습니다. 특히, 구글과 애플의 개인정보보호정책으로 인해 ADID를 수집하지 못 하는 Amplitude JS SDK 혹은 React Native SDK를 사용하는 앱은 V2 방식으로 연동하기를 권장합니다.
설정 방법
1. 앰플리튜드 대시보드 [Setting]>[Projects]에서 에어브릿지로 데이터를 보낼 프로젝트를 선택합니다. 선택 된 프로젝트 화면에서 API Key를 복사합니다.
2. 에어브릿지 대시보드에서 [Integration]>[Third-Party Integration]로 이동하여 'Amplitude V1'를 선택합니다. 
3. 앰플리튜드 대시보드에서 복사한 API Key를 붙여넣고, [User Properties 전송] 토글을 켭니다. 
4. 토글이 활성화 된 이후로 발생한 어트리뷰션 데이터는 앰플리튜드로 전송하게 됩니다.
5. 에어브릿지에서 앰플리튜드로 전송된 어트리뷰션 데이터는 [Airbridge] 접두사가 붙은 이벤트 내 유저 프로퍼티로 대시보드에 표시됩니다.
V2 연동
앰플리튜드 HTTP API V2는 에어브릿지의 이벤트 데이터를 앰플리튜드로 전달할 수 있습니다.
유저 매칭 방법
- 유저 매칭은 유저 ID와 앰플리튜드 디바이스 ID(device_id)를 기준으로 이루어집니다.
- 데이터가 전송된 시점에 유저 매칭에 실패하면 앰플리튜드에는 이벤트가 신규 유저로 기록됩니다.
유저 매칭 아이디 우선 순위
에어브릿지는 앰플리튜드 디바이스 ID를 아래 우선순위에 따라 전송합니다. 매칭하지 않으면 다음 우선순위 값을 전송합니다.
- device.alias.amplitude_device_id
- user.alias.amplitude_device_id
- device.deviceUUID
- browser.clientID
앰플리튜드 디바이스 ID
앰플리튜드 디바이스 ID(device_id)를 에어브릿지로 가져와야 유저 매칭 확률을 높일 수 있습니다. 만약 앱에서 Amplitude JS SDK 혹은 React Native SDK를 사용한다면 유저는 앰플리튜드 디바이스 ID를 활용한 이 작업을 반드시 해야 앰플리튜드에서 이벤트 데이터를 확인할 수 있습니다. 두 SDK를 사용하는 앱은 구글과 애플의 개인정보보호정책으로 인해 ADID를 수집하지 못 하기 때문입니다.
자세한 내용은 앰플리튜드 V2 연동 개발자 가이드를 참고 바랍니다.
연동 데이터
- 설치(Install) 및 딥링크 오픈(Deeplink Open) 이벤트 외 다른 이벤트도 전송이 가능합니다.
- User Property 및 Event Property로 채널, 캠페인 등 정보가 전달됩니다.
- V1과 다르게 더 많은 정보를 Event Property로 전달할 수 있습니다.
- 서버에서 이벤트를 전송하는 것과 동일한 방식이기 때문에, 이미 앰플리튜드 SDK로 수집하고 있는 이벤트를 에어브릿지의 V2 연동을 통해서도 전송할 경우, 별개의 이벤트로 로깅됩니다. (중복 집계 될 수 있음)
설정 방법
1. 앰플리튜드 대시보드 [Setting]>[Projects]에서 에어브릿지로 데이터를 보낼 프로젝트를 선택합니다. 프로젝트 화면에서 API Key를 복사합니다.
2. 에어브릿지 대시보드에서 [ Integration > Third-Party Integration] 로 이동하여 'Amplitude V2'를 선택합니다. 
3. '커넥션 추가' 버튼을 누르면 나오는 화면에서 커넥션 이름과 앰플리튜드에서 복사한 API Key를 붙여넣습니다. 
4. 앰플리튜드 측으로 전송하고자 하는 이벤트를 모두 선택한 뒤 '다음' 버튼을 누릅니다.
5. 앰플리튜드 측으로 전송하고자 하는 프로퍼티를 모두 선택한 뒤 '다음' 버튼을 누릅니다.
6. 특정 조건을 걸어 데이터를 전송하고자 한다면 [전송 규칙 추가]를 눌러 규칙을 생성할 수 있습니다. [+ 조건 추가] 를 누르면 'And' 조건으로 여러 규칙을 추가하는 것도 가능합니다.
7. 화면 하단에 '커넥션 추가' 버튼을 눌러 연동을 완료합니다.
8. '전송 시작' 버튼을 눌러 연동을 활성화하면 이벤트가 앰플리튜드로 전송됩니다.
주의하세요
메타가 제공하는 어트리뷰션 데이터는 메타 비즈니스 파트너만 확인할 수 있습니다. 따라서 메타의 페이스북이 제공하는 어트리뷰션 데이터는 앰플리튜드에서 확인할 수 없습니다. 페이스북의 어트리뷰션 데이터는 앰플리튜드에서 표기되지 않으며 미기여(Unattributed)로 처리됩니다.
웹 캠페인 전용 트래킹 링크 또는 커스텀 채널용 트래킹 링크로 수집한 어트리뷰션 데이터는 앰플리튜드에서 확인할 수 있습니다. 이 어트리뷰션 데이터는 에어브릿지의 트래킹 링크로 수집되기 때문에 미기여 처리되지 않습니다.
