들어가며
이번 문서에서는 에어브릿지 SDK의 설치와 활용 방법에 대해 다룹니다. SDK 설치는 앱의 성과 추적, 이벤트 전송, 유저 식별자 설정을 포함하여, 에어브릿지의 핵심 기능을 원활하게 활용하기 위해 필수적인 단계입니다. 각 단계별로 필요한 설정과 주의사항을 짚어드리니, 개발 담당자는 아래 SDK 설치와 연동 작업을 순서대로 진행해 주세요.
2.1 에어브릿지 기본 SDK 설치하기
먼저, 아래 개발자 가이드를 참고하여 개발 언어에 맞는 에어브릿지 SDK를 설치해 주세요. SDK 설치에 필요한 앱 이름과 SDK 토큰은 에어브릿지 대시보드의 Settings > Tokens 탭에서 확인할 수 있습니다.
▶ 에어브릿지 SDK 시작하기: 에어브릿지 SDK가 지원하는 개발 언어를 확인하고, 적절한 SDK를 설치합니다.
▶ 토큰 확인하기: 에어브릿지 대시보드에서 앱 이름과 토큰 이름을 확인하는 방법을 안내합니다.
에어브릿지 SDK는 디바이스 정보(디바이스 모델, OS Version) 및 앱 버전 등의 데이터를 자동으로 수집합니다. 자세한 항목은 가이드를 참고해주세요.
2.2 iOS IDFA 수집 작업하기
iOS에서 설치(Install) 이벤트를 전송할 때, 앱 추적 팝업(ATT Prompt)을 허용한 유저의 IDFA를 획득하려면 다음 설정이 필요합니다. 수집된 IDFA는 디바이스 ID 매칭을 통한 기여에 사용되므로 꼭 설정을 완료해주세요.
▶ Tracking Authorize Prompt 설정: AppTrackingTransparency.framework를 사용해 앱 추적 허용 선택창(ATT Prompt)을 띄워 유저의 동의를 받습니다.
개발자 가이드 바로가기
2.3 이벤트 전송하기
앱 내에서 발생하는 전환 성과를 측정하기 위해 필요한 이벤트를 전송해 주세요. 전송할 이벤트와 하위 프로퍼티는 마케터가 정의한 이벤트 택소노미를 참고하시기 바랍니다.
자주 묻는 질문
사용자 식별자 설정은 필수는 아닙니다. 그러나 다음과 같은 경우에는 설정을 고려해보실 수 있습니다.
내부 BI와 연계 분석: 에어브릿지 데이터와 내부 데이터를 내부 사용자 ID 기준으로 매핑하여 추가 분석하려는 경우
서드파티 연동: 일부 서드파티 솔루션은 사용자 ID를 기준으로 이벤트를 수집하므로, 회원 유저와의 연결이 필요하다면 설정할 수 있습니다.
실제 유저가 발생시킨 통화와 결제액을 기준으로 이벤트를 전송하면, 리포트에서는 에어브릿지 앱을 처음 등록할 때 설정된 기준 통화로 환율 변환되어 매출을 하나의 통화 기준으로 확인할 수 있습니다. airbridge.ecommerce.order.completed이벤트를 전송할 때, eventData.goal.semanticAttributes.currency에 유저의 결제 통화를 전송하고 eventData.value에 해당 통화를 기준으로 한 결제액을 전송해 주세요.
리포트에서는 기준 통화로 매출이 표시되지만, 로우 데이터를 확인할 때는 이벤트가 전송될 때의 원래 통화와 결제액도 함께 확인할 수 있습니다. 각각 Currency (Original)와 Event Value (Original)로 제공됩니다.
마케터가 사전에 고려하여 설정한 이벤트 택소노미에 따라 작성된 프로퍼티들을 수집하는 것을 권장합니다.다만 이벤트 별로 반드시 누락되어서는 안 되는 프로퍼티를 아래에 안내드리니, 해당 프로퍼티들을 반드시 포함시켜 주시기 바랍니다. 아래 이벤트들을 수집하지 않을 경우 고려하지 않아도 됩니다.
이벤트명:
airbridge.ecommerce.order.completed구매액:
eventData.value리포트에서 구매액을 확인하기 위해 사용됩니다.
통화 정보 (KRW, USD 등):
eventData.goal.semanticAttributes.currency광고 미디에이션 솔루션을 사용하면 인앱 광고로 벌어들인 수익이 미국 달러(USD)로 수집됩니다. 이를 대시보드의 앱 기준 통화로 변환하기 위해서는 이벤트에 통화 정보가 수집되어야 합니다.
Applovin Max, Google Admob, Unity Levelplay Mediation를 사용한다면 미디에이션 플랫폼 연동하기에서 예시 코드를 참고할 수 있습니다.
기준 통화는 영문 대문자 3자리입니다 (예: KRW, USD 등).
eventData.goal.semanticAttributes.currency로 전송해 주세요. (eventData.goal.semanticAttributes.products.$0.currency가 아닙니다.)
주문번호:
eventData.goal.semanticAttributes.transactionID추후 동일한 주문번호로 들어온 이벤트를 중복 제거할 수 있습니다.
이벤트명:
airbridge.ecommerce.order.canceled주문번호:
eventData.goal.semanticAttributes.transactionID취소가 아닌 구매 완료 시점의 주문번호를 전송해 주세요.
이벤트명:
airbridge.adImpression통화 정보 (KRW, USD 등):
eventData.goal.semanticAttributes.currency광고 미디에이션 솔루션을 사용하면 인앱 광고로 벌어들인 수익이 미국 달러(USD)로 수집됩니다. 이를 대시보드의 앱 기준 통화로 변환하기 위해서는 이벤트에 통화 정보가 수집되어야 합니다.
Applovin Max, Google Admob, Unity Levelplay Mediation를 사용한다면 미디에이션 플랫폼 연동하기에서 예시 코드를 참고할 수 있습니다.
기준 통화는 영문 대문자 3자리입니다 (예: KRW, USD 등).
eventData.goal.semanticAttributes.currency로 전송해 주세요. (eventData.goal.semanticAttributes.products.$0.currency가 아닙니다.)
네, 사용해도 됩니다.
에어브릿지는 게임 외에도 여러 버티컬에서 공통으로 활용하는 이벤트를 스탠다드 이벤트로 정의하고 있습니다. 이커머스 버티컬에 가까운 일부 이벤트는 카테고리에 'ecommerce'가 포함되어 있지만, 이 이벤트를 수집하더라도 실제로 이용하시는 리포트 및 로우 데이터에서는 'Order Complete', '구매 완료'와 같은 표시 이름으로 제공됩니다.
개발자 가이드 바로가기
2.4 추가 SDK 설정 작업하기
에어브릿지는 기본 광고 성과 추적 기능 외에도 앱 삭제 이벤트 트래킹 등 다양한 추가 기능을 제공합니다. 본 안내서의 ‘1. 에어브릿지 도입 준비하기 > 추가 기능 개발 작업 필요 여부 결정하기'에서 마케팅 팀과 협의한 사항이 있다면 구현해 주세요.
2.5 SDK 테스트 진행하기
모든 SDK 설치 작업이 완료되었다면, 이벤트 수집 설정, 사용자 식별자 전송 설정 등이 정상적으로 진행되는지 점검해 주세요. 추가 SDK 설정 작업을 진행한 경우, 해당 작업도 함께 점검해 주시기 바랍니다. 자세한 점검 사항은 아래 가이드를 참고해 주세요.
2.6 빌드 배포하기
SDK 테스트까지 완료되었다면, SDK가 설치된 빌드를 앱 마켓에 배포해 주세요.
다음 단계 안내
이상으로 에어브릿지 SDK 설치와 설정 작업이 완료되었습니다. 에어브릿지 SDK가 설치된 앱이 앱 마켓에 배포되었다면 다음 단계인 광고 성과 측정을 위한 에어브릿지 대시보드 사용 시작하기로 넘어가 주세요.