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

 

 

연동하기

에어브릿지 대시보드에서 어댑티 연동은 다음과 같은 2가지 방식으로 구성됩니다. 어댑티 구독 데이터를 에어브릿지로 받기와 에어브릿지 어트리뷰션 데이터를 어댑티로 전송하기입니다.

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

blockquote-caution.svg

주의하세요

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

 

어댑티 구독 데이터 받기

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

Frame_01.png

 

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

Frame_02.png

 

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

Frame_03.png

 

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

Frame_04.png

 

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

Frame_05.png

 

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

Frame_06.png

 

Report proceeds, Report user’s currency, Exclude historical events, Send trial price를 선택하면 에어브릿지로 전송하는 어댑티 데이터의 상세 조건을 설정할 수 있습니다. 앱에서 발생한 매출과 구독료처럼 구독 관련 이벤트에서 발생하는 매출은 에어브릿지 리포트에서 구독 매출액 (App) 메트릭으로 조회할 수 있습니다.

조건 의미
Report proceeds 앱 스토어 또는 구글 플레이 스토어의 수수료를 제외한 앱에서 발생한 매출을 전송합니다.
Report user’s currency 유저가 설정한 통화를 기준으로 앱에서 발생한 매출을 전송합니다. 해당 조건을 설정하지 않으면 USD 기준으로 매출을 전송합니다.
Exclude historical events 어댑티 SDK가 앱에 적용되기 전에 발생한 이벤트를 전송하지 않습니다. 예를 들어 매월 5일마다 구독을 갱신하는 앱에서 3월 1일에 어댑티 SDK를 적용했다면 3월 5일 구독 관련 이벤트부터 전송합니다.
Send trial price 체험판에서 발생한 구독료를 전송합니다. 무료 체험판은 Trial price percentage를 0%로 설정해 주세요.
blockquote-caution.svg

주의하세요

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

 

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

Frame_07.png

 

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

Frame_08.png

 

 

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

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

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

Frame_09.png

 

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

Frame_10.png

 

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

Frame_11.png

 

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

Frame_12.png

 

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

Frame_13.png

 

연동 상태

채널 이름 옆에 있는 상태 메시지에서 연동 상태를 확인할 수 있습니다. 인증 토큰을 입력한 후 데이터 전송이 정상적으로 시작되면 Adapty 오른쪽에 Active가 표시됩니다.

Frame_14.png

 

인증 토큰 수정

연동하는 어댑티 계정의 인증 토큰을 잘못 입력했거나 계정을 다시 발급받아 새로운 인증 토큰으로 바꿔야 한다면 이미 등록한 인증 토큰을 수정해야 합니다. 별표 처리된 인증 토큰 오른쪽의 연필 아이콘을 클릭해 변경할 값으로 수정합니다. 수정이 끝나면 ‘수정 완료’를 클릭합니다.

Frame_15.png

 

인증 토큰 삭제

‘등록 삭제’를 클릭하면 인증 토큰을 삭제할 수 있습니다. 인증 토큰을 삭제하면 에어브릿지와 어댑티의 연동이 중단됩니다. 인증 토큰을 삭제하더라도 인증 토큰을 삭제하기 전에 어댑티에 전송된 데이터는 어댑티에서 사라지지 않습니다. 삭제 이후에 다시 연동하고 싶다면 인증 토큰을 다시 등록해 주세요.

Frame_16.png

 

 

데이터 조회

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

이벤트 종류 어댑티 이벤트 에어브릿지 이벤트
체험판 시작 trial_started startTrial
구독 전환 trial_converted subscribe
구독 subscription_initial_purchase subscribe
갱신 subscription_renewd subscribe
구독 취소 auto_renew_off_subscription unsubscribe
blockquote-check.svg

어댑티 이벤트 매핑

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

 

 

주의사항

메타 비즈니스 데이터

메타 비즈니스(Meta Business) 광고 캠페인에 기여된 데이터는 메타 개인정보보호정책에 따라 서드파티 플랫폼에 전송되거나 공유될 수 없습니다. 메타의 정책에 따라 에어브릿지는 대시보드에서 Channel이 facebook.business인 데이터를 어댑티에 전송하지 않습니다.

 

유저 ID 매칭

어댑티 SDK에 에어브릿지 디바이스 UUID(Airbridge Device UUID)를 수집할 수 있는 코드를 삽입해야 합니다. 어댑티 SDK에서 에어브릿지 디바이스 UUID를 정상적으로 수집하지 못하면 에어브릿지 대시보드에서 구독 관련 이벤트의 유저 수가 실제 수치보다 더 집계될 수 있습니다. 자세한 내용은 개발자 가이드를 참고해 주세요.

 

이벤트 중복 집계

어댑티와 연동 중인 에어브릿지 SDK에서 구독 관련 이벤트를 새로 정의해 트래킹하면 이벤트가 중복으로 집계될 수 있습니다. 따라서 어댑티와 연동한 에어브릿지 SDK는 구독 관련 이벤트를 트래킹하면 안 됩니다.

어댑티