어댑티

Yeji JeonWritten by Yeji Jeon,

어댑티(Adapty)는 앱에서 발생하는 구독 관련 이벤트를 트래킹합니다. 에어브릿지와 어댑티를 연동하면 어댑티의 구독 관련 이벤트를 광고 성과와 함께 에어브릿지 대시보드에서 확인할 수 있습니다. 또한 에어브릿지에서 어댑티로 어트리뷰션 데이터를 전송할 수 있습니다.

주의하세요

서드파티 플랫폼에서 서버 투 서버(S2S) 연동으로 전송받은 구독 관련 이벤트를 에어브릿지에서 SKAdNetwork(SKAN) 전환값 설정에 활용할 수 없습니다. 구독 관련 이벤트를 SKAN 전환값 설정에 활용하고 싶다면 해당 이벤트를 에어브릿지 SDK에서 수집할 수 있는 커스텀 이벤트로 정의해 주세요. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

 

 

연동하기

에어브릿지와 어댑티(Adapty)를 연동하기 위해서는 어댑티 구독 데이터를 에어브릿지로 받기부터 시작해야 합니다. 이 과정을 완료해야 에어브릿지에서 어댑티로 어트리뷰션 데이터를 전송하기 위해 필요한 어댑티 API 토큰(Adapty API token)을 어댑티 대시보드에서 확인할 수 있습니다.

주의하세요

어댑티 SDK에 에어브릿지 디바이스 UUID(Airbridge Device UUID)를 수집할 수 있는 코드를 삽입해야 합니다. 에어브릿지 SDK와 어댑티 SDK에서 동일한 유저 ID로 유저를 트래킹해야 정상적인 연동 결과를 조회할 수 있습니다. 자세한 내용은 개발자 가이드를 참고해 주세요.

 

어댑티 구독 데이터 받기

아래 과정을 통해 어댑티 구독 데이터를 받을 수 있습니다.

1. 에어브릿지 대시보드 [Integrations]>[Third-party Integrations]에서 ‘Adapty’를 선택합니다.

2. 구독 데이터 받기 탭에서 에어브릿지 앱 이름과 API 토큰을 각각 클릭해 복사합니다. 

3. 어댑티 대시보드에 로그인합니다.

 

4. [Integrations]에서 Attributions에 있는 ‘Airbridge’를 선택합니다.

 

5. ‘Off’를 클릭해 ‘On’으로 상태를 바꿉니다.

 

6. Airbridge app name과 Airbridge API token에 에어브릿지 대시보드에서 복사한 에어브릿지 앱 이름과 API 토큰을 각각 입력합니다.

Report proceeds, Report user’s currency, Exclude historical events, Send trial price를 선택하면 에어브릿지로 전송하는 어댑티 데이터의 상세 조건을 설정할 수 있습니다. 

주의하세요

어댑티 SDK가 앱에 적용되기 전에 발생한 이벤트는 기본적으로 날짜가 변경돼 에어브릿지로 전송됩니다. 해당하는 이벤트는 어댑티 SDK가 적용된 앱을 설치하거나 업데이트하기 전에 발생한 이벤트입니다. 이벤트 날짜는 이벤트 전송 시점에서 24시간 이내로 변경됩니다. 따라서 실제 이벤트가 발생한 날짜와 에어브릿지 대시보드에서 표시되는 이벤트 날짜는 다르게 표시됩니다. 이를 방지하고 싶다면 Exclude historical events를 선택해 주세요.

Events names에서 에어브릿지로 전송할 구독 관련 이벤트를 선택할 수 있습니다. 전체 이벤트는 Subscriptions, Trials, Issues, 3가지로 나뉩니다. 어댑티 대시보드에서 각 이벤트의 토글을 클릭해 이벤트별 전송 여부를 언제든 변경할 수 있습니다. 

7. 어댑티 데이터의 상세 조건과 전송할 이벤트 설정을 확인하고 ‘Save’를 클릭합니다.

 

에어브릿지 어트리뷰션 데이터 전송하기

에어브릿지와 어댑티를 처음 연동한다면 에어브릿지 대시보드의 에어브릿지 앱 이름과 API 토큰을 어댑티 대시보드의 Airbridge app name과 Airbridge API token에 먼저 입력하고 저장해야 합니다. 아직 이 과정을 완료하지 않았다면 어댑티 구독 데이터 받기를 참고해 진행해 주세요.

1. 어댑티 대시보드에 로그인합니다.

 

2. [Integrations]에서 Attributions에 있는 ‘Airbridge’를 선택합니다.

3. Adapty API token을 복사합니다. 토글이 ‘Off’로 되어 있다면 클릭해 ‘On’으로 바꿔 주세요. 

4. 에어브릿지 대시보드 [Integrations]>[Third-party Integrations]에서 ‘Adapty’를 선택합니다.

 

5. 어댑티에서 복사한 어댑티 API 토큰을 에어브릿지 대시보드에 붙여 넣고 ‘등록’을 클릭하면 전송이 시작됩니다. 에어브릿지는 어댑티로 설치 이벤트만 전송합니다. 인증 토큰에는 영문, 숫자, 언더바(’_’), 마침표(’.’)만 입력할 수 있습니다.

기본 지원 기능

에어브릿지는 아래와 같은 기본적인 기능을 제공합니다.

에어브릿지에서 연동 데이터 조회하기

에어브릿지에서 어댑티(Adapty)가 수집한 구독 관련 이벤트를 광고 성과와 함께 확인할 수 있습니다. 어댑티에서 제공하는 체험판 시작, 구독 전환, 구독, 갱신, 구독 취소와 같은 주요 이벤트는 에어브릿지가 제공하는 스탠다드 이벤트와 매핑됩니다. 에어브릿지 스탠다드 이벤트와 매핑되는 어댑티 이벤트의 이름을 임의로 바꿀 수 없습니다.

어댑티 이벤트는 매핑된 에어브릿지 이벤트에 따라 에어브릿지 리포트에서 메트릭과 그룹바이를 활용해 조회할 수 있습니다.

어댑티 이벤트 매핑

어댑티가 수집한 체험판 시작, 구독 전환, 구독, 갱신, 구독 취소 이외 이벤트는 모두 에어브릿지의 커스텀 이벤트로 매핑됩니다. 커스텀 이벤트의 이름은 매핑하는 어댑티 이벤트의 이름과 동일합니다. 커스텀 이벤트와 매핑된 어댑티 이벤트의 추가 속성은 매핑된 커스텀 이벤트의 커스텀 어트리뷰트에서 모두 확인할 수 있습니다.

 

 

주의사항

아래 사항을 주의해 주세요.

도움이 되었나요?

더 필요한 내용이 있나요?