로딩중입니다
애드브릭스 연동 : 유니티 iOS
4/28/2015 1:41:37 PM

애드브릭스

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

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

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


애드브릭스 분석 기능

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

기본분석에서는 DAU, New User, Retention, Channel Quality 등의 지표를 제공합니다.

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

[애드브릭스 : 어플리케이션 분석]


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


애드브릭스 고급 분석 API

고급분석에서는 User Info, New User Funnel, In App Purchasing, In App Activity 등의 지표를 제공합니다.

고급분석은 애드브릭스 애드온 연동을 통해서 제공되며, 각 지표에 대한 설명은 아래 링크에서 확인할 수 있습니다.

[애드브릭스 : 어플리케이션 분석]


User Info

유저정보분석(User Info)에서는 유저의 나이, 성별 정보를 분석합니다.

디바이스 모델, 통신사, iOS 버전, 언어, 국가 등의 정보는 IGAW 공통 연동을 통해서 기본 제공됩니다.

유저 나이

SetAge API를 호출하여 유저 나이를 입력합니다. 유저 나이는 1~99까지의 정수를 입력합니다.

IgaworksCorePluginIOS.SetAge(20);


유저 성별

SetGender API를 호출하여 유저 성별을 입력합니다. 유저 성별은 IgaworksCorePluginIOS 에 정의된 Gender enum 값을 사용합니다.

IgaworksCorePluginIOS.SetGender(IgaworksCorePluginIOS.IgaworksCoreGenderFemale);


New User Session

최초이용활동 분석(New User Session)은 최초로 앱을 실행한 유저의 행동 패턴을 추적합니다. 이 API를 이용하여 최초로 유입된 유저의 이탈 시점을 파악할 수 있습니다.

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



In App Purchasing

구매활동 분석(In App Purchasing)은 유저의 인앱구매 행동을 추적하고 앱의 매출을 분석할 수 있습니다.
purchase API를 호출하여 유저의 인앱구매를 추적합니다.
주의  : 애드브릭스에 노출되는 매출은 price x quantity 로 계산됩니다.
//string currency = AdBrixPluginIOS.AdBrixCurrencyName(AdBrixPluginIOS.AdBrixCurrencyKRW);
//AdBrixPluginIOS.AdBrixPurchase(String orderID, String productID, String productName, double price, int quantity, currency, String category);

string currency = AdBrixPluginIOS.AdBrixCurrencyName(AdBrixPluginIOS.AdBrixCurrencyKRW)
AdBrixPluginIOS.AdBrixPurchase("oid_1","pid_1","gold_package", 1100.00, 1,currency, "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를 이용하여 유저의 모든 일반적인 행동을 추적합니다.
void inAppActivityUserActionTrackingSample {
    //AdBrixPluginIOS.Retention(string inAppActivity);
    AdBrixPluginIOS.Retention("openStore");
    AdBrixPluginIOS.Retention("stageClear");
    AdBrixPluginIOS.Retention("purchaseItemWithVirtualCurrency");
    AdBrixPluginIOS.Retention("inviteFriends");
}
+ inAppActivity 파라미터에는 영어와 숫자로 된 공백없는 문자열을 사용하시는 것을 권장합니다.
+ 한글이나 특수문자가 포함된 파라미터를 사용하실 때에는 반드시 URL Encoding 처리를 하셔야 합니다.
+ 애드브릭스 고급분석 API는 분석 파라미터에 추가적으로 하위 파라미터를 지원합니다.

애드브릭스 코호트 API

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


커스텀 코호트 필터 설정

SetCustomCohort API를 이용하여 커스텀 코호트 필터를 설정합니다.
유저가 지정한 조건에 일치하는 경우에 코호트 필터를 설정하여 유저 그룹을 생성할 수 있습니다.
코호트 필터의 이름은 AdBrixPluginIOS 에 미리 정의된 enum 값을 사용합니다.
void adbrixCustomCohortTrackingSample {
    //AdBrixPluginIOS.SetCustomCohort(코호트필터, string filterName);
    AdBrixPluginIOS.SetCustomCohort(IgaworksADPluginIOS.AdBrixCustomCohort_1, "paying_user");
    AdBrixPluginIOS.SetCustomCohort(IgaworksADPluginIOS.AdBrixCustomCohort_2, "social_sharing");
    AdBrixPluginIOS.SetCustomCohort(IgaworksADPluginIOS.AdBrixCustomCohort_3, "playing_2hour_per_day_user");
}
+ 코호트 필터는 AdBrixPluginIOS 에 미리 정의된 AdBrixPluginIOS.AdBrixCustomCohort_1~3 까지 총 3개가 제공됩니다.
+ 한글이나 특수문자가 포함된 파라미터를 사용하실 때에는 반드시 URL Encoding 처리를 하셔야 합니다.



IGAWORKS
© IGAWorks. ALL Rights Reserved.