DFINERY SDK 연동 FAQ

 

Introduction

안녕하세요. 디파이너리 CX 팀 입니다.

본 문서는 디파이너리 SDK 연동과 관련하여 기능 및 연동시 자주 묻는 질문에 대하여 답변을 드리는 공간입니다.

아래 답변을 확인 해 보시고 매칭되는 질문이 없으면 언제든 아래 메일로 문의 주시길 바랍니다.

 

• 디파이너리 CX 팀 문의 : support-tracker@adbrixsupport.zendesk.com

 

 

0.공통 질문

Q : SDK 가 지원하는 각 플랫폼 별 Minimum  OS 버전이 어떻게 되나요?

A : 각 플랫폼 Minimum 버전은 아래와 같습니다.

• Android : API Level 14 부터 지원
• iOS : iOS 10 부터 지원합니다.
• Unity : Unity 2020 LTS 부터 지원합니다.
• Flutter : Flutter version 2 부터 지원합니다. SDK 적용 프로젝트에는 Null Safety 가 적용되어 있어야 합니다.
• Web : Javascript ES5 를 지원하는 모든 브라우저에서 사용할 수 있습니다.

 

Q : 이벤트에 연동한 AttrModel 로 설정한 커스텀 파라미터 정보가 올라오지 않습니다.

A : AttrModel 로 설정한 파라미터의 key 는 소문자 및 _(언더바) -(대시) 만 사용할 수 있습니다. 한글, 기타 특수문자, 영문 대문자 등이 들어가 있으면 해당 key의 값은 서버로 전송되지 않습니다.

 

Q :  SDK 기본 연동을 완료하였는데 콘솔에서 연동 여부를 확인할 수 없습니다.

A : 연동하신 앱키 / 시크릿키를 확인 부탁드립니다. 앱키 / 시크릿키 연동란에 공란은 없는지, 숫자 0과 알파벳o 를 혼용하여 사용한 것은 아닌지 확인을 부탁드립니다. 되도록이면 앱키 / 시크릿키는 디파이너리 콘솔에서 복사하여 사용해 주시길 부탁드립니다.

 

Q :  사내에서 Cocoapods, MavenCentral 을 통해 라이브러리를 받을 수 없습니다.

A : 디파이너리 CX 팀으로 연락주시면 해당 라이브러리 파일을 전달 드리도록 하겠습니다.

메일 주소 : dfn_support@igaworks.com

 

Q : 디퍼드 딥링크는 어떻게 테스트 하나요?

A : 디퍼드 딥링크는 트랙킹 링크를 통해 앱설치가 완료된 시점에서 전달되는 딥링크 정보입니다. 아래와 같이 테스트를 부탁드립니다.

1. Download + Deeplink 형태로 트랙킹 링크 생성
2. Deeplink 정보에 디퍼드 딥링크로 받고자 하는 딥링크 정보를 설정 후 저장.
3. 앱이 설치되지 않은 상태에서 트랙킹 링크 클릭 후 SDK 연동이 완료된 앱 설치 후 실행.
4. 디퍼드 딥링크 리스너로 트랙킹 링크 생성시 설정한 딥링크 값이 오는지 확인.

 

Q : SDK 에서 사용하는 앱키 / 시크릿키는 어디서 발급하나요?

A : 연동시 사용하는 앱키 / 시크릿키는 디파이너리 콘솔에서 앱을 생성하여 발급받아 사용하실 수 있습니다.

 

Q : SDK 연동 확인은 어떻게 하나요?

A : SDK 연동 후 이벤트 확인은 디파이너리 콘솔 내 Analytics -> Live Brix 메뉴를 통해 연동하신 이벤트를 확인하실 수 있습니다.

 

Q : SDK 기본 연동만 하였습니다. 무엇을 알 수 있나요?

A : SDK 기본 연동만으로 아래의 내용을 확인하실 수 있습니다.

1. 앱의 신규 / 재설치 실행 이력
2. 플랫폼 별 설치 / 실행 이력
3. DAU
4. MAU
5. Daily Rentention
6. 광고 채널별 유입 분석

추가로 아래의 앱성장을 위한 각종 도구들을 사용할 수 있습니다.

1. 200여개의 광고 채널별 성과 추적
2. 충성 고객 분류
3. 오디언스 스튜디오를 통한 오디언스 구성
4. DMP 데이터를 통한 앱 사용자의 연령, 성별, 관심사, 경쟁사 앱 이력 분석

 

Q : SDK 에서 기본적으로 수집하는 기기 정보를 알고 싶습니다.

A : 디파이너리 SDK 에서는 기본적으로 아래의 기기 정보를 수집합니다.

• 기기아이디 : Google ADID (Android) / idfv & idfa (iOS)
• 기기 해상도
• 모델명
• OS version
• 플랫폼 (Android / iOS)
• 통신사
• 기기 제조사
• 국가 설정
• 언어 설정
• wifi only 여부
• 패키지 네임 (Android) / Bundle ID (iOS)
• App version

 

Q : 유니버셜 링크 / 앱링크만 사용할 수 없나요?

A : 유니버셜 / 앱링크의 경우 기본적으로 Apple / Google 에서 만든 앱에서만 동작이 가능합니다. 기타 다른 플랫폼에서 광고 진행시 유니버셜 / 앱링크만 연동하실 경우 동작이 안될 수 있으니 딥링크 (연동필수) - 유니버셜 / 앱링크 (서브) 형태로 연동을 진행해 주시길 부탁드립니다.

 

Q : abx 이벤트와 custom 이벤트와의 차이는 무엇인가요?

A : abx 이벤트는 디파이너리 SDK 에서 사전에 정의한 이벤트로 해당 이벤트는 모두 네트워크가 켜저 있을 경우 실시간으로 전송됩니다. custom 이벤트는 사용자가 자체적으로 만든 이벤트로 이는 디파이너리 SDK 에서 설정한 조건 (이벤트 호출 후 60초 혹은 커스텀 이벤트 30회 호출) 에 따라 전송됩니다.

 

Q : 저희 앱은 하이브리드 앱입니다. 연동이 가능하나요?

A : 하이브리드 앱도 연동이 가능합니다. 하이브리드 앱의 경우 네이티브 환경에서 SDK 연동 이외에 웹에서 발생한 이벤트를 앱으로 전달하는 Javascript 브릿지 설정이 필요하고 전달받은 이벤트를 디파이너리 SDK 이벤트 API 로 호출해 주셔야 합니다.

 

Q : SDK 연동 시 AttrModel 로 Value 를 String 으로 설정한 데이터를 long 타입으로 변경하였는데 데이터가 확인되지 않습니다.

A : AttrModel 로 설정한 데이터의 Value 타입은 한번 정해지면 바꿀 수 없습니다. 데이터의 Value 타입을 바꾸셨다면 key 역시 이에 맞게 바꾸셔야 데이터 노출이 됩니다.

 

Q : SDK 연동에 얼마나 시간이 소요될까요?

A : SDK 연동에는 많은 시간이 소요되지 않습니다. SDK 기본연동에는 3분정도면 연동이 완료되어 기본 데이터를 확인하실 수 있습니다.

 

Q : SDK 로 수집된 데이터 내 Carrier 의 수집 기준이 궁금합니다.

A : Carrier 통신사의 경우 기기 내 USIM 을 기준으로 측정합니다.

 

Q : SDK 로 수집된 데이터 내 Country 의 수집 기준이 궁금합니다.

A : Country 는 기기 내 국가 / 언어 설정을 기준으로 측정합니다.

 

Q : SDK 지원 플랫폼 종류는 어떻게 되나요 ?

A : Android, iOS, Unity, Flutter, React Native, 하이브리드 앱, WEB 를 지원합니다.

 

 

1. Android

Q : DeeplinkOpen 이벤트를 연동하였으나, 특정 상황에서 호출되지 않습니다.

A : onNewIntent(Intnet intent) 함수 내 setIntent(intent) 코드가 들어가지 않을 경우 intent 를 새로 받지 않기 때문에 앱이 실행된 상태에서는 deeplinkOpen 이벤트가 호출되지 않습니다. 그러므로 onNewIntent(Intent intent) 내 setIntent 를 추가해 주시길 부탁드립니다.

 

Q : 사용자가 Google ADID 사용을 막을 경우 어떤 ID 가 들어오나요?

A : 사용자가 Google ADID 의 사용을 막을 경우 SDK 에서 자체적으로 만든 1회성 ID 가 들어오게 됩니다. 해당 ID는 앱 삭제 시 초기화 됩니다.

 

Q : 제 디바이스의 Google 광고 ID (ADID) 를 확인할 수 있는 방법은 없나요?

A : Google Play 내 AdBrixRm-Tool 이라는 앱을 통해 디바이스의 Google 광고 ID 를 확인하실 수 있습니다.

 

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 에서는 어떤 기기아이디를 수집하나요?

A : iOS SDK 는 idfv 를 기본으로 수집합니다. 이후 사용자가 ATT팝업을 통해 앱 트랙킹을 승인했을 경우 idfa 정보를 같이 수집하게 됩니다.

 

Q : 제 디바이스의 IDFA 를 확인할 수 있는 방법은 없나요?

A : AppStore 내 AdBrixRm-Tool 이라는 앱을 통해 디바이스의 IDFA 를 확인하실 수 있습니다.

 

Q : 제 디바이스의 IDFV 를 확인할 수 있는 방법은 없나요?

A : IDFV는 앱을 설치할때마다 변경되는 정보로 일반적으로는 확인이 어려워 개발단에서 확인이 필요합니다.