OplyticSDKRepo
Oplytic 提供了应用间和移动Web至应用间的归因营销。Oplytic 利用 iOS 的 Universal Links 和 Android 的 App Links 提供跟踪,以确保移动营销者的归因和重归因精确无误。
Oplytic 考虑到了零售商和联盟营销者的需求。我们知道这种关系对每个人的整体成功来说多么宝贵。
通过利用 iOS 和 Android 提供的原生活动跟踪,Oplytic 在移动应用中跟踪安装、活动和购买行为,并精确归因和重归因给联盟营销者。Oplytic 无缝集成在您的联盟营销伙伴、移动分析平台、Web分析平台、CRM 和 DMP 之间,为您提供全面的分析图景。我们的使命是通过帮助营销者分析他们的营销和通信努力,执行强大的策略来吸引用户,以及在映射到他们目标渠道中优化媒体,来激励营销者追求他们的企业移动和Web策略。
要求
最低的 iOS 部署目标为 10.0。
安装
OplyticSDKRepo 通过 CocoaPods 提供。要安装它,只需将以下行添加到您的 Podfile 中
pod 'OplyticSDKRepo'
与 Oplytic 设置
使用Oplytic API或客户服务注册您的应用。只需提供一个友好的单词级别的应用名称、Bundle ID和团队ID即可。
从XCode开发环境中获取Bundle ID和团队ID。在“通用”标签的“标识”和“签名”部分查找这些设置。
https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistribution指南/配置您的应用/配置您的应用.html
添加AppName配置设置
打开您的应用Info.plist文件,将鼠标悬停在信息属性列表上并点击加号。在新条目中,将“Key”设置为“oplyticappname”,将“Value”设置为您的应用名称。
启用App链接
App链接允许您的应用在Safari和其他应用的点击中直接启动。遵循标准Apple通用链接场景
https://developer.apple.com/ios/universal-links/
在您的Apple iTunes开发者账户中,在App IDs下选择您的应用,并确保已启用关联域名。
在XCode中,选择项目目标,然后单击“能力”选项卡。滚动到“关联域名”选项。单击按钮将其打开,然后单击“+”按钮添加以下项
applinks:yourapp.oplct.com
请确保您指定了提供给Oplytic的App-Name,而不是上面的“yourapp”。
注意:如果您想自己访问深链接路径和URL数据,您可以通过userActivity.webPageUrl属性访问。
注意:由于iOS浏览器安全性的问题,您无法直接在Safari的URL栏中输入或复制/粘贴上述链接。但是,您可以将链接嵌入到应用、网页、电子邮件或其他社交媒体形式中。
包含Oplytic库
按照上面“安装”部分中的说明将podfile添加到您的Xcode项目中。
单击您的项目目标,然后在通用选项卡下的嵌入的二进制文件部分单击“+”按钮。选择OplyticSDKRepo.framework,这也会在链接框架和库部分添加一个条目。
使用Oplytic库
确保将Oplytic库包含在所有使用库的文件中。
Import Oplytic
1) 启动Oplytic SDK
在您的应用程序代理类中初始化Oplytic SDK。当应用程序启动时,启动SDK。处理应用链接事件。
将以下原型代码添加到您的AppDelegate类中
func application(_ application: UIApplication, continue userActivity: NSUserActivity,
restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
Oplytic.handleUniversalLink(userActivity: userActivity)
return true
}
func application(_ application: UIApplication, willContinueUserActivityWithType userActivityType: String) -> Bool {
return userActivityType == NSUserActivityTypeBrowsingWeb
}
2) 跟踪应用事件
只有两种方法可以添加事件。每当您想跟踪购买、注册或其他重要应用程序事件时,请调用这些调用。
Oplytic SDK还自动跟踪应用安装和归因事件。每次通过应用链接访问应用程序时,SDK都会注册一个新的“最后点击”归因,所有后续事件和购买都将归因于该链接。
AddEvent是一个通用方法
public func addEvent(eventAction: String? = nil, eventObject: String? = nil, eventId: String? = nil, str1: String? = nil, str2: String? = nil, str3: String? = nil, num1: Double? = nil, num2: Double? = nil)
- eventAction:与事件动作关联的字符串,例如,“查看”或“购物”。
- eventObject:与事件动作目标关联的字符串,例如“地图”或对象SKU。
- eventId:可以传递的唯一字符串,以关联事件。
- str1,str2,str3:与事件关联的任意字符串。您可以使用这些字符串为该事件传递任何类型的相关数据。
- num1,num2:与事件关联的任意Double数值。您可以使用这些值传递该事件的相关数据。
具体使用AddPurchaseEvent来跟踪应用内购买
public func addPurchaseEvent(item: String, itemId: String, quantity: Double, price: Double, currency_unit: String)
- item:被购买项目的名称。
- Item_id:与被购买项目关联的SKU或其他ID。
- quantity:被购买项目的数量。
- price:被购买项目的价格。
- currency_unit:表示货币的字符串值,例如:“USD”
3) 处理点击归因数据(可选)
如果您的应用程序需要了解归因的点击,请分配一个OplyticAttributionHandler协议,如以下简单的ViewController示例所示
class ViewController: UIViewController, OplyticAttributionHandler {
override func viewDidLoad() {
Oplytic.OplyticAttributionHandler = self
super.viewDidLoad()
}
func onAttribution(data: [String:String]) {
//handle Attributed click query params
}
}
作者
许可证
OplyticSDKRepo可在MIT许可证下使用。有关更多信息,请参阅LICENSE文件。