마케터를 위한 에어브릿지 SDK 테스트

에어브릿지 SDK가 정상 작동하는지 확인하기 위해 아래 4가지 테스트를 진행할 수 있습니다. 목적에 따라 필요한 테스트를 선택하세요.

시작하기 전에

테스트를 진행하기 전에 아래 사전 준비사항을 모두 확인하세요.

  • 에어브릿지 SDK 설치를 완료하세요.

  • iOS 앱에 ATT(앱 추적 투명성) 동의 프롬프트가 구현됐는지 확인하세요.

  • iOS 앱에 Tracking Authorize Timeout을 ATT 응답 대기에 충분하게 설정했는지 확인하세요.

  • 앱이 설치되지 않은 테스트용 디바이스를 확보하세요.

  • 에어브릿지 대시보드 [설정]>[테스트 콘솔] 접근 권한이 필요합니다.

기여된 앱 설치 이벤트 테스트

광고 캠페인 트래킹 링크로 유입된 앱 설치 이벤트가 에어브릿지에 정상 기여되는지 확인합니다.

주의하세요

iOS 앱을 테스트할 때는 ATT 프롬프트에서 반드시 동의하세요. ATT 응답 전에 에어브릿지가 앱 설치 이벤트를 먼저 전송하면 IDFA가 누락되어 기여 여부를 확인할 수 없습니다. IDFA가 계속 수집되지 않으면 Tracking Authorize Timeout이 ATT 응답을 기다리기에 충분한지 개발자와 확인하세요.

  1. 앱이 설치되지 않은 테스트 디바이스를 준비하거나 기존에 설치되어 있던 앱을 삭제하세요.

  2. 에어브릿지 대시보드 [설정]>[테스트 콘솔]의 [앱 설치 이벤트] 탭에서 테스트 디바이스의 디바이스 ID(GAID 또는 IDFA)를 하이픈(-)이 포함된 원본 형식 그대로 입력하고, '등록'을 선택해 QR 코드를 생성하세요.

  3. 테스트 디바이스로 QR 코드를 스캔하거나 'URL 복사하기'로 복사한 주소를 선택하세요.

  4. 임시 웹 페이지로 이동한 후 앱을 설치하세요. 출시된 앱은 앱마켓에서 설치하고, 미출시 앱은 파일을 직접 다운로드하거나 Google Play Console, TestFlight 등 테스트 프로그램을 활용해 설치하세요.

  5. 앱을 설치한 후 반드시 실행하세요. iOS 앱은 ATT 프롬프트에서 반드시 동의하세요.

  6. 대시보드에서 테스트 결과를 확인하세요. 충분한 시간이 지난 후에도 결과가 없거나 실패하면 앱을 삭제한 후 다시 시도하세요.

  7. 상세 데이터를 확인하려면 '실시간 로그 확인'을 선택하세요. [원본 데이터]>[앱 이벤트 실시간 로그]에서 테스트 디바이스의 정보를 확인할 수 있습니다.

목적에 따라 아래 3가지 방법 중 하나로 테스트 결과를 확인할 수 있습니다.

오가닉 앱 설치 이벤트 테스트

트래킹 링크가 적용된 광고 클릭 없이 앱마켓에서 직접 설치한 앱의 설치 이벤트가 정상 수집되는지 확인합니다.

  1. 앱이 설치되지 않은 테스트 디바이스를 준비하거나 기존에 설치되어 있던 앱을 삭제하세요.

  2. 테스트 디바이스에 앱을 설치한 후 반드시 실행하세요.

  3. 에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]에서 디바이스 ID로 발생한 이벤트를 확인하세요. 이벤트 수집에는 최대 10분이 소요될 수 있습니다.

  4. 충분한 시간이 지난 후에도 Install이 확인되지 않으면 앱을 삭제한 후 다시 시도하세요.

알립니다

앱 설치 후 최초 실행은 Open 이벤트가 아닌 Install 이벤트로 기록됩니다. Install 이벤트가 한 번 수집된 이후의 실행부터 Open 이벤트로 기록됩니다.

이벤트 택소노미 준수 여부 테스트

앱 설치 외 다른 이벤트가 이벤트 택소노미에 따라 정상 수집되는지 확인합니다.

알립니다

앱 역할이 대행사 또는 미디어 파트너인 에어브릿지 사용자는 [앱 이벤트 실시간 로그]를 사용할 수 없습니다.

  1. 에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]로 이동하세요.

  2. 검색창에 테스트 디바이스의 deviceUUID를 입력하세요. 유저 ID나 이벤트 카테고리 등으로도 검색할 수 있습니다.

  3. 아래 위치에서 이벤트 정보를 확인하세요.

    • 카테고리: eventData.goal.category

    • 액션: eventData.goal.action

    • 라벨: eventData.goal.label

    • 밸류: eventData.goal.value

    • 시맨틱 어트리뷰트: eventData.goal.semanticAttributes

    • 커스텀 어트리뷰트: eventData.goal.customAttributes

앱내 상세페이지 이동 테스트

트래킹 링크가 적용된 광고를 클릭했을 때 유저가 딥링크로 설정한 앱내 상세페이지로 정상 이동하는지 확인합니다. 에어브릿지 대시보드 [설정]>[테스트 콘솔]의 [딥링킹] 탭에서 테스트할 수 있습니다. 자세한 방법은 마케터를 위한 에어브릿지 딥링킹 테스트 가이드를 참고하세요.

자주 하는 실수 체크리스트

광고 채널 기여 여부가 확인되지 않으면 아래 항목을 순서대로 점검하세요.

  • SDK가 정상적으로 설치됐는지 확인하고, 필요하면 개발자에게 도움을 요청하세요. 자세한 내용은 SDK Quickstart 가이드를 참고하세요.

  • 테스트 디바이스에 앱을 설치한 후 반드시 실행했는지 확인하세요.

  • iOS 앱이라면 ATT 프롬프트에서 앱 추적에 동의했는지 확인하세요.

  • ATT 동의 전에 Install 이벤트가 먼저 전송되어 IDFA가 누락됐을 수 있으므로, Tracking Authorize Timeout이 ATT 응답 대기에 충분한지 확인하세요.