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) 自定义事件分析 [使用指南]
通过群组分析,按照组别筛选出特定用户进行归类分析。
示例) 地区(首尔) / 等级 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)
//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 报告上的名称 : 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 不同,可以分析包括新增用户在内的所有用户的行为。
- 特征 : 和 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)
- 目的 : 可以更详细的分析用户的特定行为 (例 : 注册 - 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)是可以分析用户年龄和性别
- 目的 : 用户信息(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
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年)
//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 推广的详细说明请参考以下链接。