로딩중입니다
[AOS] adbrix 集成 : Unity Android
9/2/2015 10:22:55 AM
adbrix 集成 : Unity Android

adbrix 同时提供应用分析和监测广告效果服务。
本指南详细介绍 adbrix SDK 接入程序。
adbrix 服务详细介绍请查看以下文件。
[
adbrix : 应用分析 & 广告效果监测] [用户分析(Activity)编制格式]


adbrix 接入程序

集成 adbrix add-on 之前,必须先完成 IGAW 共同集成。  
为了集成 adbrix 需将 IgawAdbrix~*.jar  文件包含 Unity Project 内。 


1. 
共同集成    [使用指南] 
 
  基本分析提供日活跃用户(DAU)、留存(Retention)、媒体 / 自然获取新增用户(New User)、App Install/Open 等的指标。

    1) SDK 下载 >   2) SDK 安装  >   3) IGAW 共同集成


2. 
高级分析   

     
1) 自定义事件分析   [使用指南]
      通过自定义事件分析,能查看新增启动、注册、登录、购买等应用内的用户行为分析。

     2) 群组分析    [使用指南]
     通过群组分析,按照组别筛选出特定用户进行归类分析。 
      示例) 地区(首尔) /  等级 5 以上 / 消费 10万韩元以上用户的 DAU 推测等。 
   
   * 自定义事件分析及群组分析请参考如下使用指南。 





2-1) 高级集成 : adbrix Custom Activity 
高级分析提供 新增用户事件分析(New User Session)游戏内付费情况(In App Purchasing) 游戏内用户行为(In App Activity) 用户信息(User Info) 等的指标。

(1) 新增用户事件分析(New User Session)
- API 名称 : firstTimeExperience API 
- adbrix 报告上的名称 : Advanced analytics - New User session 
- 目的 : firstTimeExperience API 是跟踪首次启动应用的活动模式,把握用户最初流失的时间点 
- 特征 :  在初始活动分析中提供首次启动当日的数据
             
(示例 : 1月1日首次启动应用的用户在 1月2日达到等级10的话,1月1日统计为等级 9) 

//IgaworksUnityPluginAOS.Adbrix.firstTimeExperience(String userActivity);
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("LoadMainLogo");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("ContentLoading");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("KakaoTalkConnectSuccess");
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("TutorialComplete");
以上示例是以 Kakao 游戏为例。
userActivity 参数建议使用无空白的英文和数字的字符串。
adbrix 高级分析 API 提供 Parameter 的下位 Parameter。
※ 注意 : 新增用户事件分析(New User Session) 图标仅显示新增用户流入当日的数据。因此先考虑用户流入当日能达到的阶段后接入此 API。

 
(2) 付费活动(In App Purchasing)
- API 名称 : Purchase API 
- adbrix 报告上的名称 : Revenue, Advanced analytics - First - time purchase, ROAS Reporting
- 目的 : 按日分析应用内所有用户的付费活动及再次安装/启动用户的收入
- 特征 : 在 adbrix 报告上显示的收入统计方式为 '价格(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");
-  通过 Purchase api 对应应用的收入数据进行统计,建议只在 Google 结算等实际购买的情况下使用。
-  ProductName、Price、quantity 是必备添加的项目,剩余的项目可以不添加。
+ orderID : 订单账户 (注意 : 如果使用同一个 orderID,会识别为重复账户排除分析。请避免重复 orderID 使用。)
+ productID : 商品 ID
productName : 商品名称 (*目前使用 Buy api 的话,在 purchaseItemName 上输入同样的名称。这样才能按商品持续统计收入)
price : 商品单价
quantity : 购买数量
+ currency : 货币单位 (使用 IgawCommerce.Currency)
+ category : 最多设置 5个阶段的商品分类,各阶段用句号(.)隔开


(3) 应用内活动(In App Activities)  
- API 名称 : retention API 
- adbrix 报告上的名称 : Advanced Analytics - In-app activities 
- 目的 : 按日期分析应用内所有用户的行为 (例 : 登录, 达成等级, 访问商店, 注册等)
- 特征 : 和 firstTimeExperience API 不同,可以分析包括新增用户在内的所有用户的行为。

//IgaworksUnityPluginAOS.Adbrix.retention(String inAppActivity);
IgaworksUnityPluginAOS.Adbrix.retention("openStore");
IgaworksUnityPluginAOS.Adbrix.retention("stageClear");
IgaworksUnityPluginAOS.Adbrix.retention("purchaseItemWithVirtualCurrency");
IgaworksUnityPluginAOS.Adbrix.retention("inviteFriends");
+ inAppActivity 参数建议使用无空白的英文和数字的字符串。
+ adbrix 高级分析 API 提供 Parameter 的下位 Parameter。


其他1) 设置 Sub Activity
- Sub activity API 设置范围 : firstTimeExperience API, retention API 上可以设置下位 Parameter 
- adbrix 报告上的名称 : Advanced Analytics - In-app FTE, Advanced Analytics - In-app activities 
- 目的 : 可以更详细的分析用户的特定行为 (例 : 注册 - KakaoTalk / Naver / Facebook)

//IgaworksUnityPluginAOS.Adbrix.retention(String inAppActivity,String subActivity);
IgaworksUnityPluginAOS.Adbrix.firstTimeExperience("Login","Facebook");
IgaworksUnityPluginAOS.Adbrix.retention("stageClear","Tutorial");

其他2) User Info
- API 名称 : setAge API, setGender API 
- adbrix 报告上的名称 : Demographic & Device - 年龄 / 性别 
- 目的 : 用户信息(User Info)是可以分析用户年龄和性别
- 特征 : 除了年龄、性别外,IGAW 共同集成还可以提供设备型号、通讯社、Android OS、语言、国家等信息。

       用户年龄
       调用 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);
    



2-2) 
高级分析 : adbrix 群组分析 API
群组分析中提供3个自定义筛选项,可以按群组分析。
群组分析指标的说明和使用方法请参考以下链接。

自定义群组筛选项设置
- API 名称 : setCustomCohort API
- adbrix 报告上的名称 : adbrix 各指标的上端 (有些报告除外) 

   * 自定义变脸不支持以下指标 
     a. Tracking Link - Reporting, ROAS Reporting 
     b. Analytics - Retention, Active Users
     c. Advanced Analytics - New User Session
     d. Revenue - Revenue by Install date

- 目的 : 筛选 adbrix 报告上的特定用户群,进行分析该用户群的分析报告。(例 : 性别、年龄、购买金额等)
- 特征 : 自定义群组可以指定 3个,各筛选项数量可以无限使用。 
(例 : 年龄可以选 - 1900 ~ 2016年) 

//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

IGAWorks 高级推广

完成 IGAW 共同集成和 adbrix 高级分析 api 后,即可进行更高速化的推广活动。
根据分析 api 集成的时间点,可以执行 CPI 启动型 + 动作达成型。

IGAWorks 推广的详细说明请参考以下链接。