DFINERY SDK 연동 FAQ
Introduction
안녕하세요. 디파이너리 TS팀 입니다.
본 문서는 디파이너리 SDK 연동과 관련된 기능과 연동 시 자주 묻는 질문에 대한 답변을 제공합니다.
아래 답변을 확인하시고 매칭되는 질문이 없다면 언제든 아래 메일로 문의 주시길 바랍니다.
- 디파이너리 TS팀 문의 : support-tracker@adbrixsupport.zendesk.com
0. 공통 질문
Q. SDK 가 지원하는 각 플랫폼 별 최소 지원 OS 버전이 어떻게 되나요?
A : 각 플랫폼 별 최소 지원 버전은 아래와 같습니다.
- Android : API Level 14 이상
- iOS : iOS 11 이상
- React Native : 0.60 이상
- Flutter : Flutter version 2 이상. SDK 적용 프로젝트에는 Null Safety 가 적용되어 있어야 합니다.
- Web : Javascript ES5 를 지원하는 모든 브라우저에서 사용할 수 있습니다.
Q. SDK에서 사용하는 앱키, 시크릿키는 어디서 발급하나요?
A : 디파이너리 콘솔에서 앱을 생성하면 앱키, 시크릿키는 자동으로 발급됩니다.
Q. 내부 정책 상 MavenCentral, Cocoapods을 통해 라이브러리를 받을 수 없습니다.
A : 디파이너리 TS팀으로 연락주시면 해당 라이브러리를 전달드리겠습니다.
Q. SDK 정상 연동 판단은 어떻게 할 수 있나요?
A : SDK가 정상 연동되었다면 디파이너리 리포트 혹은 Live Brix 메뉴에서 abx:start_session 이벤트가 확인됩니다.
Q. SDK 기본 연동을 완료했으나 콘솔에서 연동 여부를 확인할 수 없습니다.
A : 앱에 설정한 앱키, 시크릿키를 다시 한번 확인 부탁드립니다. 앱키, 시크릿키에 공란은 없는지 숫자0과 알파벳o를 바꿔 설정한건 아닌지 확인 부탁드리며, 가급적 디파이너리 콘솔에서 복사하여 사용해주시기 바랍니다.
Q. SDK 기본 연동만 했을 경우 무엇을 알 수 있나요 ?
A : SDK 기본 연동 만으로 아래의 내용을 확인하실 수 있습니다.
- 앱 신규 설치/ 재설치
- 플랫폼 별 설치 / 실행 이력
- MAU
- DAU
- Daily Retention
- 광고 채널별 유입 분석
Q. SDK에서 기본적으로 수집하는 기기 정보는 어떻게 되나요?
A : 디파이너리 SDK에서는 기본적으로 아래의 기기 정보를 수집합니다.
- 기기아이디(ADID) : GAID(AOS)(선택), IDFA(선택)/IDFV(iOS)
- 디바이스 모델 / OS / 제조사 / 화면 해상도 / 통신사(AOS) / 언어 / 국가
- 플랫폼
- 이용 네트워크 (LTE, Wifi)
- 앱 정보 : 패키지 네임(AOS) / 번들 아이디(iOS), API 버전, 앱 버전, 인스톨러
Q. abx: 이벤트와 custom: 이벤트의 차이는 무엇인가요?
A : 디파이너리에서는 2가지 종류의 이벤트를 지원하고 있습니다. 공통적으로 많이 사용하는 이벤트는 SDK에서 사전에 정의하여 제공하고 있으며 이벤트명에 프리픽스 abx:가 자동으로 붙게 됩니다.
그 외 사용자가 필요한 이벤트는 커스텀으로 생성할 수 있으며, 이벤트명에 프리픽스 custom: 이 자동으로 붙어 생성됩니다.
Q. 연동한 이벤트, 이벤트 속성을 삭제하거나, 이벤트명/이벤트 속성 타입을 변경할 수 있나요?
A : 한번 생성된 이벤트와 이벤트 속성은 이름/타입을 변경할 수 없으며 삭제 또한 불가능합니다.
Q : 이벤트에 AttrModel 로 설정한 커스텀 파라미터 정보가 올라오지 않습니다.
A : AttrModel 로 설정한 파라미터의 key 는 소문자, 숫자, _(언더바)만 사용할 수 있습니다. 한글, 기타 특수문자, 영문 대문자 등이 들어가 있으면 해당 key의 값은 서버로 전송되지 않습니다.
Q. 디퍼드 딥링크 테스트는 어떻게 하나요?
A : 디퍼드 딥링크는 지연된 딥링크로 트래킹링크를 통해 앱을 설치 했을 때 서버에서 딥링크 정보를 내려주게 됩니다. 상세 테스트 방법은 다음과 같습니다.
- 테스트 환경 : IP 고정 환경, 앱 미설치 상태
- G-mail 로 트래킹링크 전달 후 클릭
- 마켓 이동 후 앱 설치
2-1) 마켓에 배포된 버전일 경우 : 마켓에서 앱 설치
2-2) 마켓에 배포되지 않은 내부 테스트일 경우 : 마켓 이동 후 로컬에서 프로젝트 빌드
트래킹링크 클릭 > 구글 플레이스토어 랜딩 > 앱 설치 버튼 클릭 후 취소 > 프로젝트 빌드 - 앱 오픈
- 디버깅 및 디퍼드딥링크 리스너에 브레이크 포인트를 걸어 딥링크 데이터 확인
1. Android
Q. DeeplinkOpen 이벤트를 연동했으나, 특정 상황에서 호출되지 않습니다.
A : onNewIntent(Intent intent) 함수 내 setIntent(intent) 코드가 없다면 intent를 새로 받지 않아, 앱이 실행된 상태에서는 DeeplinkOpen 이벤트가 호출되지 않습니다. 따라서 onNewIntent(Intent intent) 함수 내 setIntent(intent)를 추가해주셔야 합니다.
Q. 사용자가 GAID(Google ADID)를 삭제하거나, 수집을 거부할 경우 어떤 ADID는 어떻게 발급되나요?
A : SDK에서 GAID를 수집할 수 없을 경우, SDK에서 임의의 UUID를 발급해 사용하게 됩니다.
Q. 디바이스의 GAID를 확인할 수 있나요 ?
A : 구글플레이스토어에서 AdBrixRm-Tool 앱을 설치하시면 디바이스의 GAID를 확인할 수 있습니다.
Q : Google Play 에서 개인정보 보호와 관련한 경고가 왔습니다.
A : Google Play 에서는 앱 실행시 사용자 약관을 통해 어떤 개인정보를 수집하는지 표시, 그리고 Google Play 에 앱 업로드 시 Google Play Data Safety Section 을 작성하여 사용자에게 어떠한 정보가 수집되는지 알리도록 하고 있습니다. 첨부된 가이드에 따라 사용자 약관에 개인정보 수집 여부 추가 및 Google Play Data Safety Section 을 작성해 주시길 바랍니다.
참고 자료 : [Google Play 데이터 공개 요건 준비] / [Google Play 데이터 보안 설정 안내]
2. iOS
Q. iOS SDK에서는 어떤 기기아이디(ADID)를 수집하나요?
A : 애플 정책에 의해 iOS SDK는 idfv를 기본으로 수집하고 있으며, 앱 설치 이후 사용자가 ATT팝업을 통해 idfa 수집을 허용한 이후부터 idfa를 함께 수집합니다.
Q. 디바이스의 IDFA를 확인할 수 있나요 ?
A : 앱스토어에서 AdBrixRm-Tool 앱을 설치하시면 디바이스의 IDFA를 확인하실 수 있습니다.
Q. 디바이스의 IDFV를 확인할 수 있나요 ?
A : IDFV는 앱을 설치할 때마다 변경되는 정보로, 일반적으로는 확인이 어렵습니다. 개발단에서 확인이 필요합니다.