코드한줄로 애드브릭스 연동 끝내기

PSGG
PSGG
Jul 27, 2017 · 8 min read

AARRR을 적당히 잘 녹인 애드브릭스 지표는 분석에 대한 지식이 없어도 많은 부분을 쉽게 시작할 수 있다.
[ AARRR이란? https://brunch.co.kr/@marketpedia/1 ]

링크 : adbrix를 활용한 구글 피쳐드 효과 분석

그런데 애드브릭스가 요즘 기능이 다양해져서 연동방법이 많이 파편화 되어있다.

나도 이번에 조금 애를 먹었는데, 결국 코드한줄로 간단히 연동을 끝낼 수 있었다. 공식문서에서는 그걸 찾기 조금 난감하다. 그래서 정리된 방법을 공유한다.

순서를 요약해보면 다음과 같다.

  1. 회원가입 / 로그인
  2. 앱생성 / 앱키, 해쉬키 발급
  3. 패키지 다운로드 / 설치
  4. 코드 1줄 연동
  5. 빌드
  6. 로그 확인

회원가입 / 로그인

회원가입은 귀찮게 여러단계가 있다. 공인인증서 같은건 없으니 봐주자.

  • 사이트(http://www.ad-brix.com) 들어가면 뭐 설명이 많은데, 오른쪽 상단에 보호색같은 버튼을 클릭한다.
로그인 버튼
  • 회원가입은 오른쪽 구석탱이에 회색바탕에 회색글씨로 있다. 클릭하자.
회원가입 링크는 저기에
  • 이메일, 비밀번호, 이름입력 -> 다음단계
  • 이메일을 열고 확인 링크 클릭
  • 회사 및 팀 정보 입력
  • 완료.

그러면 이제 로그인이 된다.

앱생성 / 앱키,해쉬키 발급

첫 로그인하고 화면 상단을 보면 [+앱추가하기] 버튼을 클릭한다.

+ 앱추가하기 클릭

그리고 몇가지 정보를 입력한다. 나중에 전부 수정할 수 있으니 확정안된건 막 입력해도 된다.

  • 플랫폼 선택
    - 안드로이드, iOS 둘중에 하나 선택한다.
    - 복수 선택이 안됨에 유의하자
    - 만약 둘다 지원하는 게임이면, 두 번 앱을 등록해야 한다.
  • 앱 이름
    - 이미 마켓에 있는가? 그러면 이름 입력하면 알아서 검색해준다. 그중에 하나 선택하자.
    - 아직 개발중인가? 그러면 아래 그림을 참고해서 링크를 클릭하고, 입력한다.
  • 패키지 이름
    - 입력한다. 일단, 아무거나 입력해도 되니, 미정이라면 대충 입력해보자.

패키지 이름을 정확히 입력하면,
마켓 랭킹 정보를 애드브릭스 지표와 섞어서 볼 수 있다.
패키지 이름 확정되면 정확하게 입력하자.

  • 앱 아이콘 (선택사항)
  • 앱 설명 (선택사항)
  • 앱 스크린샷 (선택사항)
  • 기본 화폐단위(매출조회용)
    - KRW 아니면 USD일듯

완료하면, 연동 상태 확인페이지와 appkey, hashkey가 발급된다. 일단, 왼쪽 메뉴구성을 보고 나중에 이페이지에 찾아올 수 있도록 기억해 두자.

연동을 확인할 수 있는 페이지

유니티 패키지 다운로드

유니티용으로 만들어진 패키지가 있다. 이걸 다운로드 받아서 연동을 한다.

아쉬운점은 iOS, android가 분리되어 있는데, 이는 곧 해결할 예정이라고 한다.

  • SDK 다운로드 페이지 접속 (링크)
  • Unity 플러그인 패키지 다운로드
각 OS에 맞는 패키지를 다운로드 한다.
  • 압축 해제 후 클릭하여 설치

코드 연동

  • IGAWBootstrap 파일 다운로드후 프로젝트에 추가 (다운로드링크)
  • 아래 코드를 게임 최초 진입시점에 호출 (로고 다음)
IGAWBootstrap.Setup();
  • 그리고 게임을 실행하고, Hierarchy창에 IGAWPlugin이 추가된걸 확인
IGAWPlugin 추가된것 확인

그러면 코드 연동은 끝났다.

최대한 앞에 코드를 호출해야, 분석 유실이 적다.
로고화면 직후 호출해야 한다고 이해하면 된다.

빌드

빌드에는 두가지 확인 사항이 있다.

  • AndroidManifest.xml 설정
  • Jar 충돌 해결

위 두가지만 확인하면 빌드관련 부분은 해결된다.

AndroidManifest.xml 설정

위 파일은 순수 안드로이드 개발자라면 매우 익숙한 파일이다.
그런데 유니티를 먼저 접한 개발자라면 저 파일이 생소할것이다.
그이유는 안드로이드 빌드시 유니티 엔진이 자동생성하기 때문이다.

간단히 설명하면 안드로이드앱의 설정을 담당하는 파일이라고 보면된다.

대부분의 서드파티 라이브러리들이 androidManifest.xml을 설정하는 가이드를 포함하고 있기 때문에, 어짜피 알아야 한다..

애드브릭스에도 저 파일에 몇가지 부분을 직접 설정해야 한다.

어렵지 않으니 아래 내용을 따라해본다.

AndroidManifest.xml 생성하기

이미 AndroidManifest.xml을 알고있고, 별도 관리하고 있다면 이 과정은 Skip 하자.

직접 가이드를 보고 작성해도 좋지만, 유니티가 자동으로 생성한 AndroidManifest.xml을 가져오는게 편하고 에러가 없다.

  • 일단 안드로이드 빌드를 한다.
  • [프로젝트Root / Temp / StagingArea / AndroidManifest.xml]을 찾는다.
  • [프로젝트Root / Assets / Plugins / Android]에 복사한다.

이제 직접 AndroidManifest.xml을 관리할 수 있게 되었다.

AndroidManifest.xml 수정하기

이제 몇가지 설정작업을 하자.

  • 아래코드를 <application></application>안에 추가하기
<meta-data android:name="igaworks_app_key" android:value="앱키" />
  • 위 복사한 코드에서 앱키와 해시키를 입력하자.
  • 아래 코드를 <manifest></manifest>에 추가하기
<uses-permission android:name="android.permission.INTERNET" />

XML은 위치가 중요하니 주의하도록 하자.

다 추가했다면 아래처럼 된다.

JAR 충돌 해결

애드브릭스에는 구글에서 제공하는 몇가지 라이브러리를 기본 포함하고 있다.

그런데 이미 자체적으로 사용중인 라이브러리가 있다면 충돌이 발생하여,빌드시 DEX로 시작하는 에러가 발생한다.

이를 애초에 확인하고 가는것이 좋다.

  • [프로젝트Root / Assets / Plugins / Android]를 열어보자
  • 아래 두 라이브러리중 겹치는것이 있는지 확인하고, 하나로 정리하자.
    - Android-support-빌드버전.jar
    - Google-play-services-빌드버전.jar

여기까지 확인했다면 빌드에 성공했을것이다.

로그확인

이제 빌드 결과물은 안드로이드 디바이스에 올리고, 안드로이드 스튜디오를 통해 로그를 확인해 보자.

  • 안드로이드 모니터를 열고(로그캣) 검색어에 IGAW_QA를 입력
  • 앱실행
  • Tracking response result의 내용중 result:true 확인
로그확인

만약 문제가 있다면, 로그에 표시되는 적절한 메시지를 보고 문제를 해결하자.

그래도 모르겠다면 help@igaworks.com으로 물어보자.

한국개발자와 한국담당자가 샌프란시스코 사투리가 아닌 표준 서울말로 한국시간대에 맞추어 친절하게 문제를 해결해주는게, 타서비스와 비교하면 강력한 차별점중 하나다. 연동지원팀은 기본적으로 개발을 매우 잘 알고 있고, 열정적이시다.

연동완료 및 지표 확인

이제 연동은 끝났다.

코드한줄로 DAU/WAU/MAU, 리텐션, 신규유저, 앱실행수, 앱실행빈도, 앱실행시간, 이탈유저 등등을 확인할 수 있다.

직관성 돋보이는 대시보드

물론 애드브릭스는 더 많은 기능을 가지고 있다.

매출분석, LTV, 신규유저 전환 단계별 분석, 커스텀이벤트 분석등등이 있는데, 모두 코드 한줄씩 추가하면 된다.

이는 다음 공식문서를 통해 확인후 작업하도록 하자.[링크]

끝.

PSGG

Written by

PSGG

게임개발이 취미인 애드브릭스 개발자

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade