Skip to main content

广告模块

广告模块包括激活事件和深度链接 (DeepLink)，激活事件是当用户应用第一次打开时有且仅发一次的事件，深度链接是提供客户通过活动网页等形式提供 App 渠道的跳转和下载。 在深度链接技术场景中，可以直接唤起 App 并跳转至指定页面，同时根据条件判断用户跳转路径，当用户已经安装 App 时可以直接唤起 App，当用户未安装 App 时会引导用户下载 App。

info

平台版本 >=4.0 支持，产品使用文档可参考 深度链接

使用时注意模块版本需要与采集 SDK 版本保持一致

深度链接配置​

  1. 在顶部导航栏选择 获客分析 -> 产品配置 -> 深度链接配置，进入深度链接配置页面

  1. 找到需要配置的 iOS 应用，点击更多信息，查看当前应用的配置

  2. 点击 Universal Link 编辑按钮，获取 Team ID 并填入表单中

如何获取 Team ID

在苹果开发者网站中找到 Team ID 与 Bundle ID

  1. 点击 复制 Link 按钮，在您的 Xcode 项目配置中打开 Associated Domains 功能，并将所复制的 Link 添加到 Associated Domains 列表中

  2. 勾选我已完成 Xcode 配置，允许 Universal Link 跳转，点击保存

模块集成​

  1. 添加 GrowingModule_Ads Package
  1. 在 AppDelegate.swift 中导入 import GrowingModule_Ads

模块配置​

广告模块中提供了相关配置：

配置接口参数类型是否必填默认值说明
readClipboardEnabledBool否true是否允许读取剪切板的应用信息
deepLinkHostString否https://link.growingio.com深度链接配置地址，SaaS取默认值
deepLinkCallbackClosures否nil监听深度链接中的地址参数
let config = AutotrackConfig(accountId: "YourAccountId")
config?.dataCollectionServerHost = "YourServerHost"
config?.dataSourceId = "YourDatasourceId"
config?.urlScheme = "YourURLScheme"

// 是否允许读取剪切板的应用信息
config?.readClipboardEnabled = true
// 深度链接配置地址
config?.deepLinkHost = "Your DeepLinkHost"
// 监听深度链接中的地址参数
config?.deepLinkCallback = { (params: [AnyHashable : Any]?,
                              processTime: TimeInterval,
                              error: Error?) -> Void in
}

Autotracker.start(config!, launchOptions: launchOptions)

可以通过该方法手动发送 DeepLink 事件，该接口常用于应用内部广告获客接收

配置接口参数类型是否必填默认值说明
doDeeplinkURL是null深度链接URL，示例：https://n.datayi.cn/k4wudMXn
let ads = Advertising.sharedInstance()
let callback = { (params: [AnyHashable : Any]?,
                  processTime: TimeInterval,
                  error: Error? ) -> Void in
}
ads.doDeeplink(by: URL(string: "Your DeepLinkUrl")!, callback: callback)

获取 Apple Search Ads 归因数据分析​

如您需要使用 Apple Search Ads 归因数据分析，在 SDK 初始化时打开 ASAEnabled 开关：

let config = AutotrackConfig(accountId: "YourAccountId")
config?.dataCollectionServerHost = "YourServerHost"
config?.dataSourceId = "YourDatasourceId"
config?.urlScheme = "YourURLScheme"

// 打开 ASAEnabled 开关
config?.ASAEnabled = true

Autotracker.start(config!, launchOptions: launchOptions)

在 Target -> Build Phases -> Link Binary With Libraries，添加 iAd.framework 和 AdServices.framework，并设置 AdServices.framework status 为 Optional