Amplitude

에어브릿지는 앰플리튜드 솔루션으로 Airbridge에서 수집 된 어트리뷰션 데이터 혹은 이벤트 데이터를 보낼 수 있도록 지원하고 있습니다. 에어브릿지에서 수집된 정보는 앰플리튜드 내의 데이터와 함께 더 정교한 분석을 할 수 있도록 활용할 수 있습니다. 아래에서 각 버전에 따른 안내사항을 참고 하시기 바랍니다. 

💡 앰플리튜드의 Attribution Solution 연동을 위해서는 공통적으로 ADID 수집을 위한 선작업이 필요합니다.

⚠️ V1과 V2 둘 다 연동시, 데이터가 중복으로 집계되는 경우가 발생할 수 있으므로, 하나의 버전으로만 연동을 진행하시길 바랍니다.

💡 엠플리튜드 API의 endpoint는 Standard(미국)와 EU 서버 두 곳이 존재합니다. 기본적으로 에어브릿지에서 전송되는 데이터는 Standard 서버로 전송되며, EU 서버로 전송을 희망하시는 경우 로 연락주시기 바랍니다. 

 

앰플리튜드 V1 연동: Attribution API

앰플리튜드에서 제공하는 Attribution API를 통해 Airbridge에서 트래킹한 어트리뷰션 데이터를 앰플리튜드로 전달할 수 있습니다. Amplitude ↔ 에어브릿지 연동이 완료되면, 완료 시점 이후의 설치(Install) 및 딥링크 오픈(Deeplink Open) 이벤트를 앰플리튜드로 전달하게 되며, 앰플리튜드 내 User Properties에 어트리뷰션 데이터가 추가됩니다.


[유저 매칭 방법]

  • IDFA/IDFV/ADID 를 기준으로 유저 매칭이 이루어집니다.
  • 데이터가 전송된 시점에 유저 매칭에 실패할 경우 72시간 동안 Attribution 데이터를 앰플리튜드에서 보관하며 매칭을 시도합니다. (72시간 이후에는 데이터가 만료되어 폐기됩니다.)
  • 대/소문자를 구분합니다.

[연동 데이터]

  • 설치(Install) 및 딥링크 오픈(Deeplink Open) 이벤트만 전송이 가능합니다.
  • User Property로 채널, 캠페인 등의 정보가 전달됩니다.

💡 ADID & Device ID

유저 매칭 확률을 높이기 위해서는 앰플리튜드의 Device ID를 User Alias로 담아 에어브릿지로 전송할 수 있습니다. 특히 Amplitude JS SDKReact Native SDK를 사용하는 경우, Google과 Apple 정책상의 이유로 ADID를 수집하지 못하기 때문에 반드시 본 설정을 완료해주셔야 합니다. 자세한 내용은 가이드를 참고해주시기 바랍니다.

 

설정 방법

  1. 앰플리튜드 대시보드에서 [ Setting > Projects ] 에어브릿지로 데이터를 보낼 프로젝트를 선택합니다. 선택 된 프로젝트 화면에서 API Key를 복사합니다.
    amplitude_1.png
  2. 에어브릿지 대시보드에서 [ Integration > Third-Party Integration] 로 이동하여 'Amplitude V1'를 선택합니다. 
    blobid0.png
  3. 앰플리튜드 대시보드에서 복사한 API Key를 붙여넣고, [User Properties 전송] 토글을 켭니다. 
    blobid0.png
  4. 토글이 활성화 된 이후로 발생한 어트리뷰션 데이터는 앰플리튜드로 전송하게 됩니다.
  5. 에어브릿지에서 앰플리튜드로 전송된 어트리뷰션 데이터는 [Airbridge] 접두사가 붙은 이벤트 내 유저 프로퍼티로 대시보드에 표시됩니다.

 

앰플리튜드 V2 연동: HTTP API

앰플리튜드 HTTP API V2는 에어브릿지이벤트 데이터를 앰플리튜드로 전달할 수 있습니다. 

[유저 매칭 방법]

  • User IDDevice ID를 기준으로 유저 매칭이 이루어집니다.
  • 데이터가 전송된 시점에 유저 매칭에 실패할 경우 신규 유저로 앰플리튜드에 이벤트 기록됩니다.

* 유저 매칭 아이디 우선 순위
device_id 전송시 아래와 같은 우선순위로 전송 (값이 없으면 다음 우선순위 값을 전송합니다.)

  1. device.alias.amplitude_device_id
  2. user.alias.amplitude_device_id
  3. device.deviceUUID
  4. browser.clientID

[연동 데이터]

  • 설치(Install) 및 딥링크 오픈(Deeplink Open) 이벤트 외 다른 이벤트도 전송이 가능합니다.
  • User Property 및 Event Property로 채널, 캠페인 등 정보가 전달됩니다.
    • V1과 다르게 더 많은 정보를 Event Property로 전달할 수 있습니다.
  • 서버에서 이벤트를 전송하는 것과 동일한 방식이기 때문에, 이미 엠플리튜드 SDK로 수집하고 있는 이벤트를 에어브릿지의 V2 연동을 통해서도 전송할 경우, 별개의 이벤트로 로깅됩니다. (중복 집계 될 수 있음)

 

설정 방법

  1. 앰플리튜드 대시보드에서 [ Setting > Projects ] 에어브릿지로 데이터를 보낼 프로젝트를 선택합니다. 선택 된 프로젝트 화면에서 API Key를 복사합니다.
    amplitude_1.png
  2. 에어브릿지 대시보드에서 [ Integration > Third-Party Integration] 로 이동하여 'Amplitude V2'를 선택합니다. 
    blobid1.png
  3. [ 커넥션 추가 ]버튼을 누르면 나오는 화면에서 커넥션 이름과 앰플리튜드에서 복사한 API Key를 붙여넣습니다. 
    mceclip0.png
  4. 앰플리튜드 측으로 전송하고자 하는 이벤트를 모두 선택한 뒤 '다음' 버튼을 누릅니다.
    mceclip1.png
  5. 앰플리튜드 측으로 전송하고자 하는 프로퍼티를 모두 선택한 뒤 '다음' 버튼을 누릅니다.
    mceclip2.png
  6. 특정 조건을 걸어 데이터를 전송하고자 한다면 [전송 규칙 추가]를 눌러 규칙을 생성할 수 있습니다. [+ 조건 추가] 를 누르면 'And' 조건으로 여러 규칙을 추가하는 것도 가능합니다.
    mceclip3.png
  7. 화면 하단에 [ 커넥션 추가 ] 버튼을 눌러 연동을 완료합니다.
  8. [ 전송 시작 ] 버튼을 눌러 연동을 활성화하면 이벤트가 앰플리튜드로 전송됩니다.
    blobid1.png
도움이 되었습니까?
0명 중 0명이 도움이 되었다고 했습니다.