如何接入 5Rocks 的服务

5Rocks 简介

5Rocks 成立于2013年6月,是韩国一家分析与营销自动化公司,其在数据科学、深度报告、预测性分析及客户关系管理服务等方面有独到优势。

开篇

本文介绍如何使用5Rocks iOS SDK 接入 5Rocks的服务。

1. 注册登陆

首先我们需要一个5Rocks账号。去这里,点击右上角的 Sign up 按钮, 在弹出的页面中输入您的邮箱, 之后您的邮箱中应该就能收到一封来自5Rocks的注册邮件。点击邮件中的Confirm your email  链接,如下图:

确认邮件

之后会进入5Rocks真正的注册界面, 填写一些相关信息,注意其中 Referral Code 那一项不用填, 最后点击 Start . 完成后就会跳转到下面的页面:

开始界面

这里我们选择第一个:

Currently own live game/app, and wants to integrate with 5Rocks

在接下来的页面中填入你的 app name, 支持的orientation, app icon, 时区,以及你app内购买会使用到的货币种类,这里我们选择如下的设置:


创建页面

点击下一步,再接下来的页面中选择 I will integrate SDK , 记录下下面的 App ID, APP Key, App Secret, 这些我们在集成SDK的时候会用到。同样在这个页面我们可以下载各个版本的SDK,这里我们下载iOS的SDK, 之后直接点击 Next. 接下来这个页面不用管它,直接点击 Done, 好了,我们终于进入了 5Rocks 的UI 界面了。接下来我们就可以暂时离开这个页面,去我们的iOS 项目中做集成了。

2. SDK集成

下面我们新建一个iOS项目 MyTestApp, 之后解压刚才下载好的 5Rocks SDK, 会得到一个目录 5rocks-ios-sdk, 把这个目录直接添加到我们创建好的iOS 项目中,这部做完后我们的项目目录结构应该如下图所示:


ios 项目目录

接下来我们需要做一下必要的项目设置,首先在 Build Phases -> Link Binary With Library 里添加Security.framework。libFiveRocks.a文件应该在上一步就已经自动添加好了,完成之后,项目设置应该如下图所示:

项目设置

接下来选择Build Settings 选项卡,找到 Other Linker Flags 这项设置项, 你可能需要在左上角选择 All 才能看到这个设置项,如下图所示:


双击 Other Linker Flags 设置项,在弹出的窗口中新加一个值 : "-lstdc++", 完成之后应该如下图所示:


这样我们的项目设置就完成了。

在项目中新建一个 Header File, 将它命名为 “5rocksConstants.h", 里面import 5Rocks header 文件,并且定义两个宏,用来存储 App Id, 以及 App Key (填入你刚才在 5Rocks UI中得到的相应值), 如下所示:


然后编辑 AppDelegate.m 文件,import 5rocksConstants.h , 并且在 application: didFinishLaunchingWithOptions: 函数中添加如下代码:

在 applicationWillResignActive: 函数中调用 [FiveRocks endSession];

在 applicationDidEnterBackground: 函数中调用 [FiveRocks endSession];

在 applicationWillEnterForeground: 函数中调用 [FiveRocks startSession:FIVEROCKS_APP_ID withAppKey:FIVEROCKS_APP_KEY];

在 applicationDidBecomeActive: 函数中调用 [FiveRocks startSession:FIVEROCKS_APP_ID withAppKey:FIVEROCKS_APP_KEY];

最后在 applicationWillTerminate: 函数中调用 [FiveRocksendSession];

这样基本的初始化就完成了。

接下来就是一些事件发生后给5Rocks通知的API,比如在你的app中用户完成了一次应用内购买,这个时候你就可以调用一个5Rocks的API 来追踪这件事,这里我们用一个button的click事件来模拟一次应用内购买,添加的代码(在你的ViewController.m中)如下:

这里的 "RUBY_SINGLE_PACK" 可以是任意的字符串,用来表示这一次购买,currencyCode 应该是这次购买使用的货币类型,这里我们用了 USD, price中就是这次的价格, campaignId 可以是nil, 如果你在 5Rocks 的 UI 中创建过 campaign,并且这里想要和这个campaign 关联,那么可以填入那个campaign id.

如果你的app有一些类似的社交功能,那么可以用下面的代码发送一些用户数据给 5Rocks 做统计:

这里我们传人了当前用户的Id (DemoUser), 他当前的level (1级), 以及当前user有几个Friend (3个)

好了,到这里基本的5Rocks 集成就完成了,接下运行几次你的app,看看效果吧。运行几次后,你应该就会收到 5Rocks 的邮件,邀请你去UI中看看统计数据,等一段时间,你就应该能看到一些数据了。 以下是我的测试应用的以下数据展示:




还有更多的API,可以参考5Rocks SDK中的文档。基本上就是发生了一些事件,然后调用5Rocks 的API, 向他们发送相应的数据,5Rocks 有了这些数据,就能够做一些统计信息了。

关于Android 的SDK接入其实是大同小异的,相信有了iOS SDK接入的经验,聪明的你一定能够轻松搞定Android 的接入了。可以参考这个文档。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,076评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,658评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,732评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,493评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,591评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,598评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,601评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,348评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,797评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,114评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,278评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,953评论 5 339
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,585评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,202评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,442评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,180评论 2 367
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,139评论 2 352

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,012评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,088评论 4 62
  • 从朱买臣的故事告诉我们三点启示: 第一,从心态管理上要学习他的淡定从容的心态,不受外界的影响,不管外面的人如何嘲笑...
    青春沸腾阅读 206评论 0 0
  • 一生一世地爱你, 是不是就能够一生白头? 爱你, 不变心。 �o~
    雨凉夏墨阅读 146评论 0 0
  • 每天的生活总是按你的逻辑思维的运转,生活也就不一样,上班,做生意完全不是一样,简单的我总是把每一天过得很充...
    F文泰森阅读 345评论 0 0