- 유저 가이드
- 에어브릿지와 연동하기
- 서드파티 연동하기
어댑티
어댑티(Adapty)는 앱에서 발생하는 구독 관련 이벤트를 트래킹합니다. 에어브릿지와 어댑티를 연동하면 어댑티의 구독 관련 이벤트를 광고 성과와 함께 에어브릿지 대시보드에서 확인할 수 있습니다. 또한 에어브릿지에서 어댑티로 어트리뷰션 데이터를 전송할 수 있습니다.
주의하세요
서드파티 플랫폼에서 서버 투 서버(S2S) 연동으로 전송받은 구독 관련 이벤트를 에어브릿지에서 SKAdNetwork(SKAN) 전환값 설정에 활용할 수 없습니다. 구독 관련 이벤트를 SKAN 전환값 설정에 활용하고 싶다면 해당 이벤트를 에어브릿지 SDK에서 수집할 수 있는 커스텀 이벤트로 정의해 주세요. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
에어브릿지와 어댑티(Adapty)를 연동하기 위해서는 어댑티 구독 데이터를 에어브릿지로 받기부터 시작해야 합니다. 이 과정을 완료해야 에어브릿지에서 어댑티로 어트리뷰션 데이터를 전송하기 위해 필요한 어댑티 API 토큰(Adapty API token)을 어댑티 대시보드에서 확인할 수 있습니다.
주의하세요
어댑티 SDK에 에어브릿지 디바이스 UUID(Airbridge Device UUID)를 수집할 수 있는 코드를 삽입해야 합니다. 에어브릿지 SDK와 어댑티 SDK에서 동일한 유저 ID로 유저를 트래킹해야 정상적인 연동 결과를 조회할 수 있습니다. 자세한 내용은 개발자 가이드를 참고해 주세요.
아래 과정을 통해 어댑티 구독 데이터를 받을 수 있습니다.
1. 에어브릿지 대시보드 [연동]>[서드파티 연동]에서 ‘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를 선택하면 에어브릿지로 전송하는 어댑티 데이터의 상세 조건을 설정할 수 있습니다.
어댑티 데이터 중에서 앱에서 발생한 매출과 구독 관련 이벤트에서 발생하는 매출은 에어브릿지 리포트에서 구독 매출액 (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%로 설정해 주세요. |
주의하세요
어댑티 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. 에어브릿지 대시보드 [연동]>[서드파티 연동]에서 ‘Adapty’를 선택합니다.
5. 어댑티에서 복사한 어댑티 API 토큰을 에어브릿지 대시보드에 붙여 넣고 ‘등록’을 클릭하면 전송이 시작됩니다. 에어브릿지는 어댑티로 설치 이벤트만 전송합니다. 인증 토큰에는 영문, 숫자, 언더바(’_’), 마침표(’.’)만 입력할 수 있습니다.
에어브릿지는 아래와 같은 기본적인 기능을 제공합니다.
서드파티의 연동 상태는 아래의 상태 메시지를 통해 확인할 수 있습니다. 연동 정보에는 인증 토큰, Report Key, 제공업체 ID 등이 포함됩니다.
상태 메시지 | 설명 |
|---|---|
(메시지 없음) | 연동 정보가 등록되지 않았습니다. |
Configured | 연동 정보가 정상적으로 등록됐습니다. |
Error | 서드파티 서버, 연동 정보 관련 인증 문제가 발생해 데이터가 수집되고 있지 않습니다. |
상태 메시지는 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 서드파티의 표시 이름 아래에 나타납니다.
또한 서드파티 메뉴 오른쪽에서도 상태 메시지를 확인할 수 있습니다.
연동하는 서드파티의 연동 정보를 바꿔야 한다면 이미 등록한 연동 정보를 수정해야 합니다. 입력된 연동 정보 오른쪽의 연필 아이콘을 클릭해 변경할 값으로 연동 정보를 수정합니다. 수정이 끝나면 ‘수정 완료’를 클릭합니다.
‘등록 삭제’를 클릭하면 연동 정보를 삭제할 수 있습니다. 연동 정보를 삭제하면 에어브릿지와 서드파티의 연동이 중단됩니다. 연동 정보를 삭제하더라도 연동 정보를 삭제하기 전에 수집된 데이터는 서드파티 또는 에어브릿지에서 사라지지 않습니다. 삭제 이후에 다시 연동하고 싶다면 연동 정보를 다시 등록해 주세요.
에어브릿지에서 어댑티(Adapty)가 수집한 구독 관련 이벤트를 광고 성과와 함께 확인할 수 있습니다. 어댑티에서 제공하는 체험판 시작, 구독 전환, 구독, 갱신, 구독 취소와 같은 주요 이벤트는 에어브릿지가 제공하는 스탠다드 이벤트와 매핑됩니다. 에어브릿지 스탠다드 이벤트와 매핑되는 어댑티 이벤트의 이름을 임의로 바꿀 수 없습니다.
어댑티 이벤트는 매핑된 에어브릿지 이벤트에 따라 에어브릿지 리포트에서 메트릭과 그룹바이를 활용해 조회할 수 있습니다.
어댑티 이벤트 | 에어브릿지 이벤트 |
|---|---|
trial_started | 체험판 시작 |
trial_converted | 구독 |
subscription_initial_purchase | 구독 |
subscription_renewed | 구독 |
auto_renew_off_subscription | 구독 취소 |
에어브릿지 이벤트를 활용해 에어브릿지 리포트에서 메트릭과 그룹바이를 조회할 수 있습니다. 에어브릿지 이벤트에 대한 자세한 설명은 에어브릿지 가이드를 참고해 주세요.
어댑티 이벤트 매핑
어댑티가 수집한 체험판 시작, 구독 전환, 구독, 갱신, 구독 취소 이외 이벤트는 모두 에어브릿지의 커스텀 이벤트로 매핑됩니다. 커스텀 이벤트의 이름은 매핑하는 어댑티 이벤트의 이름과 동일합니다. 커스텀 이벤트와 매핑된 어댑티 이벤트의 추가 속성은 매핑된 커스텀 이벤트의 커스텀 어트리뷰트에서 모두 확인할 수 있습니다.
아래 사항을 주의해 주세요.
서드파티 플랫폼에서 서버 투 서버(S2S) 연동으로 전송받은 구독 관련 이벤트를 에어브릿지에서 SKAdNetwork(SKAN) 전환값 설정에 활용할 수 없습니다. 에어브릿지에서 SKAN 전환값을 설정하면서 선택할 수 있는 이벤트는 에어브릿지 SDK에서 수집하는 스탠다드 이벤트와 1번 이상 수집된 커스텀 이벤트입니다. 그외 이벤트는 SKAN 전환값을 설정하는 과정에서 선택할 수 없습니다.
서드파티 플랫폼에서 전송받은 이벤트를 SKAN 전환값 설정에 활용하고 싶다면 해당 이벤트를 에어브릿지 SDK에서 수집할 수 있는 커스텀 이벤트로 정의해 주세요.
메타 애즈에 기여된 데이터는 메타 개인정보보호정책에 따라 서드파티에 전송되거나 공유될 수 없습니다. 해당 데이터는 광고를 집행한 주체만 메타 애즈의 광고 성과를 분석하기 위한 목적으로 내부에서 사용할 수 있습니다.
따라서 에어브릿지는 메타 애즈에 기여된 데이터의 Channel을 facebook.business에서 Restricted로 변경한 후에 서드파티에 전송합니다. 에어브릿지와 서드파티를 정상적으로 연동하더라도 메타 애즈에 기여된 데이터를 서드파티에서 활용할 수 없습니다.
웹 캠페인 전용 트래킹 링크 또는 커스텀 채널용 트래킹 링크로 수집한 광고 성과 데이터는 미기여로 처리되지 않기 때문에 서드파티에서 확인할 수 있습니다.
유저 ID가 에어브릿지 SDK와 서드파티 SDK에서 동일하게 기록돼야 정상적인 연동 결과를 조회할 수 있습니다. 서드파티 SDK에 에어브릿지 디바이스 UUID(Airbridge Device UUID)를 수집할 수 있는 코드를 삽입해야 합니다. 서드파티 SDK에서 에어브릿지 디바이스 UUID를 정상적으로 수집하지 못하면 에어브릿지에서 구독 관련 이벤트의 유저 수가 실제 수치보다 더 집계될 수 있습니다.
자세한 내용은 개발자 가이드를 참고해 주세요.
구독 관련 서드파티와 연동하고 있는 에어브릿지 SDK에서 구독 관련 이벤트를 새롭게 정의한 후에 트래킹하면 해당 이벤트가 중복으로 집계될 수 있습니다. 구독 관련 서드파티와 연동하고 있다면 구독 관련 이벤트를 추가로 트래킹하지 않도록 주의해 주세요.
도움이 되었나요?