에어브릿지 대시보드에서 에어브릿지 SDK가 정상적으로 작동하는지 테스트할 수 있습니다.
알립니다
테스트를 진행하기 전에 에어브릿지 SDK를 먼저 설치해 주세요.
앱 설치 이벤트는 에어브릿지 SDK를 설치하면 자동으로 수집되는 이벤트입니다. 아래 과정을 통해 에어브릿지 SDK가 정상적으로 앱 설치 이벤트를 수집하는지 확인할 수 있습니다.
에어브릿지 대시보드 [설정]>[테스트 콘솔]에서 아래 항목을 테스트할 수 있습니다. 기여된 앱 설치 이벤트는 에어브릿지 어트리뷰션 과정으로 기여를 인정받은 앱 설치 이벤트입니다.
이벤트 수집 여부: 정상적으로 수집되면 오가닉 앱 설치 이벤트 테스트가 필요하지 않습니다.
광고 채널 기여 여부: 기여된 앱 설치 이벤트를 수집합니다.
앱 설치 이벤트는 타겟 이벤트이기 때문에 앱 설치 이벤트가 정상적으로 광고 채널에 기여되면 후속 이벤트도 정상적으로 기여됩니다.
주의하세요
iOS 앱의 ATT(App Tracking Transparency, 앱 추적 투명성) 동의 프롬프트를 구현했다면 정보 사용에 동의해야 테스트가 정상적으로 진행됩니다. 반드시 동의해 주세요.
1. 앱을 설치하지 않은 테스트 디바이스를 준비합니다. 또는 테스트하기 전에 설치된 앱을 삭제해 주세요.
2. 에어브릿지 대시보드 [설정]>[테스트 콘솔]에서 테스트 디바이스의 디바이스 ID를 -
와 함께 입력합니다. ‘등록’을 클릭하면 QR 코드가 나타납니다.
디바이스 ID는 에버브릿지가 제공하는 앱을 사용하면 쉽게 확인할 수 있습니다.
아래 QR 코드로 My Device ID by Airbridge 앱을 다운로드하면 디바이스 ID를 쉽게 확인할 수 있습니다. 디바이스 ID를 포함해 디바이스 모델, OS 버전 등 앱을 설치한 디바이스에 관한 정보를 함께 확인할 수 있습니다.
테스트 디바이스의 OS에 따라 확인할 수 있는 디바이스 ID 종류가 다릅니다. 디바이스 ID에 대한 자세한 내용은 에어브릿지 가이드를 확인해 주세요.
3. 테스트 디바이스로 QR 코드를 스캔합니다. 또는 ‘URL 복사하기’를 클릭해 복사한 주소를 테스트 디바이스에서 클릭합니다. 복사한 주소는 QR 코드에 적용된 트래킹 링크입니다.
테스트 디바이스에서 웹 페이지로 이동하면 에어브릿지 대시보드에서 SDK 테스트를 진행하고 있다는 안내가 나타납니다.
4. 테스트 디바이스로 QR 코드를 스캔하면 임시 웹 페이지로 이동합니다. 이동한 후에 테스트 디바이스에 앱을 설치해 주세요. 임시 웹 페이지를 종료해도 테스트 결과에 영향을 주지 않습니다.
출시된 앱: 앱마켓으로 이동해 앱을 설치해 주세요.
출시 예정인 앱 또는 개발용 앱 같이 출시되지 않은 앱: 앱 파일을 직접 다운로드하거나 구글 플레이 콘솔 또는 테스트 플라이트와 같은 테스트 프로그램을 통해 앱을 설치해 주세요.
앱을 설치한 후에 반드시 앱을 실행해 주세요. 앱을 실행해야 앱 설치 이벤트가 수집됩니다. 또한 iOS 환경에서는 ATT 동의 프롬프트에서 정보 사용에 동의해야 테스트할 수 있습니다.
5. 앱을 설치한 후에 실행하면 테스트 결과를 에어브릿지 대시보드에서 확인할 수 있습니다.
6. 충분한 시간이 지나도 테스트 결과가 나오지 않거나 테스트에 실패하면 테스트 디바이스에서 앱을 삭제한 후에 다시 테스트를 시도해 주세요.
앱 설치 이벤트의 광고 채널 기여 여부를 확인할 수 없다면 자주 하는 실수를 확인해 주세요.
7. ‘실시간 로그 확인’을 클릭하면 에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]에서 테스트 디바이스의 디바이스 ID로 발생한 정보를 자세히 확인할 수 있습니다. 또는 액츄얼스 리포트(Actuals Report)에서 자세한 정보를 확인할 수 있습니다.
알립니다
앱 역할이 대행사 또는 미디어 파트너인 에어브릿지 사용자는 [앱 이벤트 실시간 로그]를 사용할 수 없습니다.
앱 설치 이벤트가 정상적으로 수집되고 있다면 [앱 이벤트 실시간 로그]에서 Install을 확인할 수 있습니다. 지연 등으로 테스트 결과가 나오지 않거나 실패해도 아래 정보와 같으면 앱 설치 이벤트는 성공입니다.
안드로이드
Event Category: Install
gaid
: 에어브릿지 대시보드에 입력한 GAID
attributionResult.channel
: airbridge_sdk_test
attributionResult.attributedTouchpointOriginURL
: https://abr.ge/@${YOUR_APP_NAME}/test_sdk?campaign=test_sdk_campaign&device_uuid=${YOUR_GAID}
iOS
Event Category: Install
ifa
: 에어브릿지 대시보드에 입력한 IDFA
attributionResult.channel
: airbridge_sdk_test
attributionResult.attributedTouchpointOriginURL
: https://abr.ge/@${YOUR_APP_NAME}/test_sdk?campaign=test_sdk_campaign&device_uuid=${YOUR_IDFA}
액츄얼스 리포트를 아래 같이 설정하면 테스트 과정에서 발생한 기여된 앱 설치 이벤트의 수집 여부를 확인할 수 있습니다.
기간: 테스트를 진행한 날짜를 포함해서 설정합니다.
메트릭: Install (App)을 선택합니다.
그룹바이: Channel을 선택합니다.
앱 설치 이벤트가 airbridge_sdk_test 채널에 정상적으로 기여되면 테이블에서 airbridge_sdk_test 채널의 Install (App) 수치를 확인할 수 있습니다.
오가닉 앱 설치 이벤트는 광고로 발생하지 않은 앱 설치 이벤트입니다. 오가닉 앱 설치 이벤트 테스트를 통해 이벤트 자체가 수집되는지 추가적으로 확인할 수 있습니다. 해당 테스트는 기여 여부를 확인하지 않습니다.
1. 앱을 설치하지 않은 테스트 디바이스를 준비합니다. 또는 테스트하기 전에 설치된 앱을 삭제해 주세요.
2. 테스트 디바이스에 앱을 설치합니다. 앱을 설치한 이후 실행을 해야 앱 설치 이벤트가 수집됩니다. 앱을 실행해 주세요.
3. 에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]에서 테스트 디바이스의 디바이스 ID로 발생한 이벤트를 실시간 로그로 확인합니다. 앱 설치 이벤트가 정상적으로 수집되고 있다면 Install을 확인할 수 있습니다. [앱 이벤트 실시간 로그]에서 앱 설치 이벤트를 확인하기 위해서는 최대 10분이 필요합니다.
4. 충분한 시간이 지나도 [앱 이벤트 실시간 로그]에서 Install이 확인되지 않는다면 테스트 디바이스에서 앱을 삭제한 후에 다시 테스트를 시도해 주세요.
에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]에서 실시간 로그를 확인하면 앱 설치 이벤트를 제외한 다른 이벤트가 이벤트 택소노미에 따라 정상적으로 수집되는지 확인할 수 있습니다. 검색창에 테스트 디바이스의 디바이스 ID 또는 적절한 검색어를 입력해 주세요.
알립니다
앱 역할이 대행사 또는 미디어 파트너인 에어브릿지 사용자는 [앱 이벤트 실시간 로그]를 사용할 수 없습니다.
이벤트가 에어브릿지에 의도대로 수집됐는지 확인하기 위해서는 [앱 이벤트 실시간 로그]에서 실시간 로그로 이벤트 택소노미 준수 여부를 확인해야 합니다.
아래를 참고해 주세요.
카테고리: eventData.goal.category
에서 확인할 수 있습니다.
액션: eventData.goal.action
에서 확인할 수 있습니다.
라벨: eventData.goal.label
에서 확인할 수 있습니다.
밸류: eventData.goal.value
에서 확인할 수 있습니다.
시멘틱 어트리뷰트: eventData.goal.semanticAttributes
에서 확인할 수 있습니다.
커스텀 어트리뷰트: eventData.goal.customAttributes
에서 확인할 수 있습니다.
아래 사항을 주의해 주세요.
Tracking Authorize Timeout 설정에 따라 앱 설치 이벤트의 기여 여부를 확인하기 위해 필요한 IDFA가 수집되지 않을 수 있습니다. 예를 들어 ATT 동의 프롬프트가 나오기 전에 에어브릿지가 앱 설치 이벤트를 수집하면 IDFA를 수집할 수 없습니다. 유저가 ATT 동의 프롬프트에 동의하지 않았기 때문입니다.
따라서 IDFA가 계속해서 수집되지 않으면 먼저 Tracking Authorize Timeout 설정을 충분히 길게 설정했는지 확인해 주세요.
에어브릿지에 유저가 앱을 설치한 후에 처음 수집된 실행(Open) 이벤트는 앱 설치(Install) 이벤트로 기록됩니다. 따라서 앱 설치 이벤트가 수집되면 처음 수집된 실행 이벤트는 기록되지 않을 수 있습니다.
에어브릿지 가이드를 참고해 에어브릿지 SDK가 정상적으로 설치됐는지 확인해 주세요. 개발자에게 도움을 요청해 주세요.
테스트 디바이스에 앱을 설치한 후에 설치된 앱을 실행했는지 확인해 주세요.
iOS 환경을 테스트하는 앱이라면 ATT 동의 프롬프트에서 정보 사용에 동의했는지 확인해 주세요.
ATT 동의 프롬프트에서 정보 사용에 동의해도 앱 설치 이벤트의 기여 여부가 확인되지 않으면 Tracking Authorize Timeout이 적절한 길이인지 확인해 주세요.
도움이 되었나요?