로딩중입니다
[iOS] adbrix 集成 : Unity iOS
9/2/2015 10:23:29 AM
adbrix 集成 : iOS

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


adbrix 接入程序

集成 adbrix add-on 之前,必须先完成 IGAW 共同集成。  
为了集成 adbrix 需将 IgaworksUnityPlugin_iOS~*.unitypackage 文件包含 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) 

void firstTimeExperienceUserActionTrackingSample {
    //AdBrixPluginIOS.FirstTimeExperience(string userActivity);
    AdBrixPluginIOS.FirstTimeExperience("LoadMainLogo");
    AdBrixPluginIOS.FirstTimeExperience("ContentLoading");
    AdBrixPluginIOS.FirstTimeExperience("KakaoTalkConnectSuccess");
    AdBrixPluginIOS.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)' 

//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");
-  通过 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 不同,可以分析包括新增用户在内的所有用户的行为。

void inAppActivityUserActionTrackingSample {
    //AdBrixPluginIOS.Retention(string inAppActivity);
    AdBrixPluginIOS.Retention("openStore");
    AdBrixPluginIOS.Retention("stageClear");
    AdBrixPluginIOS.Retention("purchaseItemWithVirtualCurrency");
    AdBrixPluginIOS.Retention("inviteFriends");
}
+ inAppActivity 参数建议使用无空白的英文和数字的字符串。
+ Parameter 中包含中文、韩文或其他特殊字符时,必须进行 URL Encoding 处理。
+ adbrix 高级分析 API 提供 Parameter 的下位 Parameter。


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

       用户年龄
       调用 setAge API,输入用户年龄。可以输入 1~99的整数。 
IgaworksCorePluginIOS.SetAge(20);

用户性别
调用 setGender API,输入用户性别。请在 IgaworksCorePluginIOS 中,使用已定义的 Gender enum。
IgaworksCorePluginIOS.SetGender(IgaworksCorePluginIOS.IgaworksCoreGenderFemale);
    



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年) 

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。
+ Parameter 中包含中文、韩文或其他特殊字符时,必须进行 URL Encoding。