디파이너리 셀프 검증 가이드
본 문서에 대하여
이 문서는 디파이너리 연동 후 기본 연동 및 이벤트 연동 확인을 위한 가이드입니다.
문서를 보기 전 참고자료
본 문서를 보기 전 SDK 연동이 정상적으로 되어 있는지 아래 사전 체크리스트를 통해 확인 하실 수 있습니다.
셀프 검증을 위한 4가지 방법
연동 완료 여부를 확인하는 세가지 방법이 있습니다.
- Application 관리 메뉴
- LiveBrix 메뉴
- 이벤트 리포트 수치 확인
- Bigdata export 기능의 RAW 데이터 활용 (권장)
(1) Application 관리 메뉴
이벤트 연동이 완료되면 최초로 확인하실 수 있는 메뉴는 Application 관리 메뉴 입니다.
adbrix SDK 연동 후 최소 1번 이상 호출한 이벤트 및 User / Event Property 내역을 확인할 수 있습니다.
- Setting & SDK 에서 Applications 메뉴 클릭
- App 리스트에서 우측 상단에 관리 버튼 클릭
- 호출한 이벤트 리스트 확인 가능
본 이벤트 리스트에서는 아래의 내역을 확인할 수 있습니다.
- PreDefined Events : adbrix SDK 에서 사전에 정의된 이벤트 호출 내역을 보여줍니다. 해당 이벤트는 모두 abx:XXXX 라고 표시됩니다.
- Custom Events : PreDefined Events 외에 사용자가 Custom 하게 설정한 이벤트를 표시합니다. 해당 이벤트는 모두 custom:XXXX 라고 표시됩니다.
- Trigger Events : Growth Action 에서 일정 조건 달성시 서버에서 호출하는 이벤트입니다. 해당 이벤트는 모두 trg:XXXX 로 표시됩니다.
- User Properties : adbrix SDK 의 setUserProperty API 를 통해 설정한 사용자 정보입니다. adbrix SDK 가 사전에 정의한 내역은 abx:xxxx / 사용자가 커스텀하게 입력한 property 는 custom:xxxx 으로 정의합니다.
- Event Properties : adbrix SDK 에서 호출한 이벤트 내 정보를 표시합니다. adbrix SDK 가 사전에 정의한 내역은 abx:xxxx / 사용자가 커스텀하게 입력한 이벤트 정보는 custom:xxxx 으로 정의합니다.
(2) LiveBrix
LiveBrix 에서는 현재 adbrix SDK 에서 호출한 이벤트 내역을 1분 단위로 최대 25분까지 실시간 스트리밍으로 보실 수 있습니다. 본 메뉴에서는 이벤트 호출 내역만 빠르게 확인할 수 있으나 Event / UserProperty 내역은 확인할 수 없습니다.
1) Dfinery console 의 좌측 메뉴에서 Analytics -> LiveBrix 메뉴를 클릭합니다.
2) 클릭시 광고 액션 / 이벤트를 통해 현재 호출되고 있는 내역을 확인할 수 있습니다.
- 광고 액션 : 트랙킹 링크의 클릭, 컨버전 이력을 확인할 수 있습니다.
- 이벤트 : 현재 호출되고 있는 이벤트를 확인할 수 있습니다.
(3) 이벤트 리포트 확인
이벤트 리포트를 통해 날짜별 / 시간별 리포트를 확인할 수 있습니다. 이벤트 리포트는 SDK 연동완료 후 SDK 연동 테스트시 가장 정확하게 확인 할 수 있는 수단입니다.
[[인용:정보]] Report 는 매 정시에 업데이트 됩니다. (Ex. 14:05 에 테스트를 진행했다면 15:00 이후부터 리포트 확인 가능)
1) Dfinery console 의 좌측 메뉴에서 Analytics -> Data Explorer 메뉴를 클릭합니다.
2) 우측 상단에 Create New Report 버튼을 클릭하여 나오는 리포트 생성 메뉴에서 General Event Analytics 를 선택합니다.
3) Report Builder 에서 Group by 메뉴를 편집하여 아래와 같이 Daily -> Platform -> Event Name 으로 Group by 를 설정합니다. 시간대별 이벤트 호출 이력을 확인하고 싶으시다면 Daily -> Hourly -> Platform -> Event Name로 설정합니다.
[[인용:정보]] 시간대별 이벤트 호출 이력을 확인하고 싶으시다면 Daily -> Hourly -> Platform -> Event Name로 설정합니다.
[[인용:정보]] Group By 에서는 각 이벤트 별로 호출된 Event properies / User properties 까지 설정하실 수 있습니다.
4) Report Builder 의 Conditions 메뉴에서 리포트 날짜 및 세부 사항을 옵션으로 선택할 수 있습니다. 선택 후 리포트 생성 버튼을 클릭합니다.
[[인용:정보]] Analytics Conditions 에서 사용하고 있는 테스트 디바이스의 ADID(ADID/IDFA 설정) 혹은 디바이스 모델(Model 로 설정) 을 입력하여 설정된 컨디션에 해당하는 내역만 리포트로 확인하실 수 있습니다.
5) 생성되는 리포트에서 이벤트 호출 이력을 확인합니다.
(4) Bigdata export 기능의 RAW 데이터 활용 (권장)
아래 이미지와 같이 추출을 희망하시는 컬럼을 추가하여 로우 데이터 형태로 데이터를 검증할 수 있습니다.
- Data studio > Bigdata export > Create Export(우측상단) > 신규작업 생성하기 > App Event 선택
- Table Design - group by조건에 검증에 필요한 조건 값을 추가합니다.
이벤트 검증이라면 조건값 중 event name을 필수로 입력하고, 프로퍼티 확인이라면 귀사 개발팀이 입력한 프로퍼티 명칭을 추가합니다. - Conditions - 이벤트를 호출한 기간을 정하거나, 특정 이벤트만 따로 필터링 할 수 있습니다.
귀사 개발팀에게 정상적으로 연동이 되었는지 확인을 부탁드립니다.
딥링크 검증
딥링크는 이미 앱이 설치되어 있는 사용자를 대상으로 앱을 오픈시켜주는 기능입니다. adbrix SDK 에서는 deeplinkOpen API 를 통해 이를 분석할 수 있고 이를 통해 마케팅의 중요 지표 중 하나인 사용자의 Re-engagement 를 확인할 수 있습니다.
이를 검증하기 위해서는 기본적으로 Android / iOS 모두 deeplinkOpen API 가 연동되어 있어야 합니다.
(1) 트랙킹 링크 생성
딥링크 검증을 위해서는 우선 딥링크가 설정된 트랙킹 링크가 생성된 상태여야 합니다. 트랙킹 링크 생성은 아래 가이드를 참고해 주시길 바랍니다.
(2) 딥링크 테스트
딥링크가 설정된 트랙킹 링크 생성이 완료되면 이를 통해 딥링크 테스트를 진행할 수 있습니다. 딥링크 테스트는 아래의 절차를 따릅니다.
- 테스트 앱이 테스트 기기에 설치되어 있어야 합니다.
- 테스트는 아래 두가지 경우를 설정하여 테스트를 진행합니다.
- 앱 완전히 종료되어 메모리에서 내려간 상태.
- 홈버튼을 통해 앱이 전환된 상태. (onPause)
- 트랙킹 링크를 테스트 기기에서 클릭합니다. (Mail 클라이언트에서 클릭하는 것을 권장합니다.)
- 딥링크로 앱이 오픈되며 딥링크로 설정된 화면으로 이동합니다.
(3) DeeplinkOpen API 연동 확인.
딥링크를 통해 딥링크로 설정된 화면으로 이동이 화면되면 연동된 DeeplinikOpen API 가 정상적으로 오픈되었는지 확인해야합니다. 해당 API 호출은 트랙킹 링크 리포트를 통해 확인할 수 있습니다.
[[인용:경고]] Report 는 매 정시에 업데이트 됩니다. (Ex. 14:05 에 테스트를 진행했다면 15:00 이후부터 리포트 확인 가능)
1) 테스트 하신 트랙킹 링크의 Action 버튼을 클릭하고 Report 를 클릭합니다.
2) Report Builder -> Conditions 의 Open Attribution Type 을 New Install, Re-install, Deeplink Open 모두 선택합니다. 이후 테스트하신 날짜를 설정하고 실행 버튼을 클릭합니다.
3) 생성된 리포트를 통해 Deeplink Open 수치를 확인합니다.
문의사항
연동 및 검증 관련 추가적으로 문의사항이 있을 경우 아래 메일로 컨택을 부탁드립니다.
연동 및 검증 문의사항 : support-tracker@adbrixsupport.zendesk.com