로딩중입니다
애드브릭스 연동 : 유니티 안드로이드
4/24/2015 4:31:41 PM

애드브릭스

애드브릭스는 분석과 트래킹을 동시에 지원하는 서비스입니다. 애드브릭스 연동을 통해 개발사는 앱 내의 유저 행동에 대한 분석과 마케팅 채널에 대한 분석을 진행할 수 있습니다. 애드브릭스 서비스에 대한 자세한 내용은 아래의 아티클에서 확인할 수 있습니다.

[애드브릭스 서비스 안내]

[애드브릭스 유저 활동정보(activity) 작성 양식]


주의사항
  1. 애드브릭스 애드온을 연동하기 전에 반드시 IGAW 공통 연동이 진행 되어야 합니다. [IGAW 공통 연동 : 유니티 안드로이드]
  2. 애드브릭스 연동을 위해서는IgawAdbrix~*.jar 파일이 유니티 프로젝트에 포함되어 있어야 합니다. [SDK 설치 : 유니티]



애드브릭스 분석 기능

애드브릭스는 기본분석과 고급분석, 그리고 코호트분석을 제공합니다. 

기본분석

기본분석에서는 DAU, New UserRetentionChannel Quality 등을 제공합니다.
기본분석은 공통연동을 완료하시면 기본제공됩니다.

기본분석은 IGAW 공통 연동을 통해서 제공되며, 각 지표에 대한 설명은 아래 링크에서 확인할 수 있습니다.

고급분석 & 코호트분석

고급분석과 코호트 분석은 아래 API 가이드를 참고하여 진행합니다.


애드브릭스 고급 분석 API

고급분석에서는 User InfoNew User SessionIn App Purchasing, In App Activity 등의 지표를 제공합니다.
고급분석은 애드브릭스 애드온 연동을 통해서 제공 되며, 각 지표에 대한 설명은 아래 링크에서 확인할 수 있습니다.


User Info

유저정보 분석(User Info)는 유저의 나이와 성별 정보를 분석할 수 있습니다.
디바이스 모델, 통신사, 안드로이드 OS, 언어, 국가 등의 정보는 IGAW 공통 연동을 통해서 기본 제공 됩니다.

유저 나이
setAge API를 호출하여 유저 나이를 입력합니다. 유저 나이는 1~99까지의 정수를 입력합니다.
//IgaworksUnityPluginAOS.Adbrix.setAge(int age);
IgaworksUnityPluginAOS.Adbrix.setAge(30);

유저 성별
setGender API를 호출하여 유저 성별을 입력합니다. 유저 성별은 IgawCommon.Gender에 미리 정의된 값을 사용합니다.
//IgaworksUnityPluginAOS.Adbrix.setGender(IgaworksUnityPluginAOS.Gender gender);
IgaworksUnityPluginAOS.Adbrix.setGender(IgaworksUnityPluginAOS.Gender.MALE);

New User Session

최초이용활동 분석(New User Session)은 최초로 앱을 실행한 유저의 행동 패턴을 추적합니다. 이 API를 이용하여 최초로 유입된 유저의 이탈 시점을 파악할 수 있습니다.
firstTimeExperience API를 호출하여 유저의 행동 패턴을 추적하며 최초이용활동 분석에서는 최초로 유입된 당일의 데이터만을 제공합니다.
//IgaworksUnityPluginAOS.Adbrix.firstTimeExperience(String userActivity);
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("LoadMainLogo");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("ContentLoading");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("KakaoTalkConnectSuccess");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("TutorialComplete");
+ 위 샘플은 카카오톡 게임으로 가정하여 작성되었습니다.
+ userActivity 파라미터에는 영어와 숫자로 된 공백없는 문자열을 사용하시는 것을 권장합니다.
+ 애드브릭스 고급분석 API는 분석 파라미터에 추가적으로 하위 파라미터를 지원합니다.
※ 주의 : New User Session 그래프는 신규유저의 유입 당일 자정까지만의 데이트롤 보여주는 만큼, 유저가 유입 당일 도달이 가능한 액션까지만을 본 API로 연동해 주시길 바랍니다.


In App Purchasing
구매활동 분석(In App Purchasing)은 유저의 인앱구매 행동을 추적하고 앱의 매출을 분석할 수 있습니다.
purchase API를 호출하여 유저의 인앱구매를 추적합니다.
주의  : 애드브릭스에 노출되는 매출은 price x quantity 로 계산됩니다.
//IgaworksUnityPluginAOS.Adbrix.purchase(String orderID, String productID, String productName, double price, int quantity, Currency currency, String category);
IgaworksUnityPluginAOS.Adbrix.purchase("oid_1","pid_1","gold_package", 1100.00, 1,IgaworksUnityPluginAOS.Adbrix.Currency.KR_KRW, "cat1.cat2.cat3.cat4.cat5");
+ orderID : 주문 아이디
+ productID : 상품 아이디
productName* : 상품명 (Buy api를 사용했던 앱을 업데이트 하는 경우, productName에 기존 사용하셨던 buy api의 purchaseItemName을 입력합니다.)
price* : 상품단가
quantity* : 구매 수량
+ currency : 구매 통화 단위 (IgawCommerce.Currency 사용)
+ category : 최대 5단계의 상품 카테고리, 각 단계는 마침표(.)으로 구분
   "*"표시된 항목은 필수 입력값입니다. 나머지 항목은 필요에 따라 연동하시면 됩니다.
    purchase API를 통해서 앱의 매출 지표가 집계되기 때문에 구글결제 등의 실제 구매에 대해서만 사용하는 것을 권장합니다.

Buy API 제공 종료 안내

2017. 8. 31 부로 Buy API 제공이 종료되었습니다. Purchase api 를 이용해 주시길 부탁드립니다.



In App Activity

유저활동 분석(In App Activity)는 위 2가지 유저행동 외의 모든 패턴을 추적하는데 사용합니다.
retention API를 이용하여 유저의 모든 일반적인 행동을 추적합니다.
//IgaworksUnityPluginAOS.Adbrix.retention(String inAppActivity);
IgaworksUnityPluginAOS.Adbrix.retention("openStore");
IgaworksUnityPluginAOS.Adbrix.retention("stageClear");
IgaworksUnityPluginAOS.Adbrix.retention("purchaseItemWithVirtualCurrency");
IgaworksUnityPluginAOS.Adbrix.retention("inviteFriends");
+ retention api 의 파라미터에는 영어와 숫자로 된 공백없는 문자열을 사용하시는 것을 권장합니다.
+ 애드브릭스 고급분석 API는 분석 파라미터에 추가적으로 하위 파라미터를 지원합니다.

Sub Activity 설정

각각의 유저 분석 액티비티는 하위 액티비티 설정이 가능합니다.
하위 액티비티 설정을 통해 액티비티에 대한 추가 분석하실 수 있습니다.
//IgaworksUnityPluginAOS.Adbrix.retention(String inAppActivity,String subActivity);
IgaworksUnityPluginAOS.Adbrix.retention("stageClear","Tutorial");



애드브릭스 코호트 API

코호트 분석에서는 유저 그룹을 생성하여 그룹 별로 분석할 수 있습니다.
코호트 분석에서는 직접 설정하여 사용할 수 있는 3개의 커스텀 필터와 IGAW 공통 연동을 통해 제공되는 4개의 기본 필터(트래킹링크/국가/OS버전/접속일자)를 제공합니다.
코호트 분석 지표에 대한 설명과 사용법은 아래 링크에서 확인할 수 있습니다.

커스텀 코호트 필터 설정

setCustomCohort API를 이용하여 커스텀 코호트 필터를 설정합니다.
유저가 지정한 조건에 일치하는 경우에 코호트 필터를 설정하여 유저 그룹을 생성할 수 있습니다.
코호트 필터의 이름은 CohortVariable 에 미리 정의된 값을 사용합니다.
//IgaworksUnityPluginAOS.Adbrix.setCustomCohort(CohortVariable cohortFilter, String inAppActivity);
IgaworksUnityPluginAOS.Adbrix.setCustomCohort(CohortVariable.COHORT_1, "level_1");
IgaworksUnityPluginAOS.Adbrix.setCustomCohort(CohortVariable.COHORT_2, "visit_10_times");
IgaworksUnityPluginAOS.Adbrix.setCustomCohort(CohortVariable.COHORT_3, "last_visit_10_days_before");
+ CohortVariable에 미리 정의된 필터는 CohortVariable.COHORT_1~3 까지, 총 3개가 제공됩니다.


IGAWorks 고급 마케팅

IGAW공통 연동과 애드브릭스 고급 분석 API가 정상적으로 연동되었다면 더 고도화된 마케팅을 진행할 수 있습니다.
각 분석 API가 연동된 시점을 완료 조건으로 하는 CPI실행형 + 추가 액션형의 광고를 애드팝콘 네트워크를 통해서 진행할 수 있습니다.

IGAWorks 마케팅에 대한 자세한 설명은 아래 링크에서 확인할 수 있습니다.