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) 自定义事件分析 [使用指南]
通过群组分析,按照组别筛选出特定用户进行归类分析。
示例) 地区(首尔) / 等级 5 以上 / 消费 10万韩元以上用户的 DAU 推测等。
示例) 地区(首尔) / 等级 5 以上 / 消费 10万韩元以上用户的 DAU 推测等。
* 自定义事件分析及群组分析请参考如下使用指南。
2-1) 高级集成 : adbrix Custom Activity
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)
- 特征 : 在初始活动分析中提供首次启动当日的数据。
(示例 : 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 报告上的名称 : 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 结算等实际购买的情况下使用。
通过 purchase API 对应应用的收入数据进行统计,建议只在 App Store 结算等实际购买的情况下使用。
(3) 应用内活动(In App Activities)
- API 名称 : retention API
- adbrix 报告上的名称 : Advanced Analytics - In-app activities
- 目的 : 按日期分析应用内所有用户的行为 (例 : 登录, 达成等级, 访问商店, 注册等)
- 特征 : 和 firstTimeExperience API 不同,可以分析包括新增用户在内的所有用户的行为。
- 特征 : 和 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)是可以分析用户年龄和性别
- 目的 : 用户信息(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
2-2) 高级分析 : adbrix 群组分析 API
自定义群组筛选项设置
- 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。