로딩중입니다
[iOS] adbrix 集成 : Native iOS
8/26/2015 11:13:29 AM
adbrix 集成 : iOS

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


adbrix 接入程序

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

#import <AdBrix/AdBrix.h>

- (void)firstTimeExperienceUserActionTrackingSample {
    //[AdBrix firstTimeExperience:@"userActivity"];
    [AdBrix firstTimeExperience:@"LoadMainLogo"];
    [AdBrix firstTimeExperience:@"ContentLoading"];
    [AdBrix firstTimeExperience:@"KakaoTalkConnectSuccess"];
    [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)' 
#import <AdBrix/AdBrix.h>

- (void)inAppPurchasingUserActionTrackingSample {

    // AdBrix purchase:@"orderId" product:AdBrixCommerceProductModel paymentMethod:AdBrixPaymentMethod"
    [AdBrix purchase:@"orderId_1"
         product: [AdBrix createCommerceProductModel:@"productId_1"
         productName:@"商品名称"
         price:10000.00
         discount:0
         quantity:1
         currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
         category:[AdBrixCommerceProductCategoryModel create :@"分类名称1"]
         extraAttrsMap:nil]
         paymentMethod:[AdBrix paymentMethod:AdBrixPaymentMobilePayment]];
}
+ orderID : 订单账户 (注意 : 如果使用用一个 orderID,会识别为重复账户排除分析。请避免重复 orderID 使用。)
+ productID : 商品 ID
productName : 商品名称 (目前使用 Buy api 的话,在 productName 上输入 Buy api 的 purchaseItemName。)
price : 商品单价
+ discount : 打折,没有的话,就写 ‘0’。
quantity : 购买数量
+ currency : 货币单位 (使用 AdbrixCurrency)
+ category : 最多设置 5个阶段的商品分类,各阶段句号(.)隔开。
+paymentMethod : 购买方式 (使用 AdbrixPayment)
    通过 purchase API 对应应用的收入数据进行统计,建议只在 App Store 结算等实际购买的情况下使用。


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

#import <AdBrix/AdBrix.h>

- (void)inAppActivityUserActionTrackingSample {
    // [AdBrix retention:@"inAppActivity"];
    [AdBrix retention:@"openStore"];
    [AdBrix retention:@"stageClear"];
    [AdBrix retention:@"purchaseItemWithVirtualCurrency"];
    [AdBrix retention:@"inviteFriends"];
}
+ inAppActivity 参数建议使用无空白的英文和数字的字符串。
+ adbrix 高级分析 API 提供 Parameter 的下位 Parameter。


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

       用户年龄
       调用 setAge API,输入用户年龄。可以输入 1~99的整数。 
#import <IgaworksCore/IgaworksCore.h>

- (void)userAgeTracking {
    [IgaworksCore setAge:30];
}

用户性别
调用 setGender API,输入用户性别。请在 IgaworksCore.h 中,使用已定义的 Gender enum。
#import <IgaworksCore/IgaworksCore.h>

- (void)userGenderTracking {
    [IgaworksCore setGender:IgaworksCoreGenderMale];
}
    



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

#import <AdBrix/AdBrix.h>

- (void)customCohortFilterSample {
    [AdBrix setCustomCohort:AdBrixCustomCohort_1 filterName:@"paying_user"];
    [AdBrix setCustomCohort:AdBrixCustomCohort_2 filterName:@"social_sharing"];
    [AdBrix setCustomCohort:AdBrixCustomCohort_3 filterName:@"playing_2hour_per_day_user"];
}
+ 自定义筛选项的名称需使用在 AdBrix,h header 在中已定义的 enum 值。 
+ 自定义筛选项总提供已在 AdBrix.h header 定义的 AdBrixCustomCohort_1~3。