English
Log In
You can then view all documents
增长参谋/数据接入文档/归因服务接入-iOS
归因服务接入-iOS
Last updated 2022-09-29 14:38:51

重要提示:

  1. 归因服务接入后,会关联归因接入兼容数据接入,全部联调成功后,需要有真实归因数据进来才能真正接入成功,需要创建推广活动,用生成的监测链接配置在对应投放平台上
  1. oppo渠道配置监测链接门槛:需连续7天投放消耗在1w以上

1.环境准备

  • iOS 8.0 及以上
  • Xcode 10.0+

2. 导入SDK

2.1 使用CocoaPods安装SDK

在Podfile中,添加source源:

2.2 引入SDK

在Podfile中,引入SDK,并执行pod install --repo-update更新Pods。

2.3 手动安装SDK

注意 6.x 版本开始默认不提供 sdk 包,需要的话请联系技术支持。下载 RangersAppLog iOS SDK 并解压缩。将安装包下的文件复制到项目文件夹下,并在XCode中依次添加到项目中。

2.4 添加依赖

如果您使用CocoaPods安装,请跳过这一步。

  • libz.tbd
  • libsqlite3.tbd
  • CoreGraphics.framework
  • CoreFoundation.framework
  • Foundation.framework
  • UIKit.framework
  • Security.framework
  • CoreTelephony.framework (读取运营商名称)
  • SystemConfiguration.framework (判断网络状态)
  • JavaScriptCore.framework (不使用全埋点或圈选功能就不需要依赖)
  • WebKit.framework(不使用全埋点、圈选功能和H5打通功能就不需要依赖)
  • AdSupport.framework (不使用全埋点或圈选功能就不需要依赖)

同时需要添加编译项 other linker flags,如下图:

  • -ObjC
  • 或者-force_load $(PROJECT_DIR)/yourpath/[RangersAppLog.framework/Versions/A/RangersAppLog](http://RangersAppLog.framework/Versions/A/RangersAppLog)

3. 添加URL Scheme

在应用信息中找到URL Scheme:

将URL Scheme添加到你的项目中:

如果是iOS 13,重写UISceneDelegate的回调方法:

如果iOS版本低于13,则重写UIApplicationDelegate的回调方法

4.初始化SDK

请在App启动完成的时候,就初始化配置(如果在页面展示完毕之后 才初始化配置,会导致部分事件采集有缺失)。

初始化参数说明

appid

channel

为增长参谋应用列表中生成的AppID

自定义,一般为应用市场名称


5. 深度事件回传(可选)

如果在广告投放平台进行投放时只统计激活数,可忽略此步骤。

如果需要此功能,须根据深度事件进行自定义埋点,然后在增长参谋创建推广活动的时候做关联

4.1系统事件

系统深度事件

事件类型

事件名称(自定义)

上报时机

激活(系统自带,可以不用埋点)

activation

-

留存(系统自带,可以不用埋点)

app_launch

-

4.2自定义事件

自定义深度事件

事件类型(固定)

事件名称(自定义)

上报时机(自定义)

注册

例:register

根据业务场景

付费

例:pay

根据业务场景

订单

例:order

根据业务场景

关键行为

例:key_behavior

根据业务场景

下载

例:download

根据业务场景

6. 埋点上报

用户行为日志采用事件event + 属性params的形式,事件一般对应多个属性,也可以仅有事件没有属性。代码埋点方案一般由数据分析师或产品运营设计。仅上报事件的代码埋点,示例如下:

Objective-C请参考:

Swift请参考:

上报事件和对应属性的代码埋点,示例如下:

Objective-C请参考:

Swift请参考:

例如上报付费场景,自定义事件名称为pay,以下为两种上报方式示例,选择其中一种即可


Contents
Contact us