OplyticSDKRepo 0.2.0

OplyticSDKRepo 0.2.0

Ryan Siska 维护。



  • 作者:
  • siska

OplyticSDKRepo

Oplytic 提供了应用间和移动Web至应用间的归因营销。Oplytic 利用 iOS 的 Universal Links 和 Android 的 App Links 提供跟踪,以确保移动营销者的归因和重归因精确无误。

Oplytic 考虑到了零售商和联盟营销者的需求。我们知道这种关系对每个人的整体成功来说多么宝贵。

通过利用 iOS 和 Android 提供的原生活动跟踪,Oplytic 在移动应用中跟踪安装、活动和购买行为,并精确归因和重归因给联盟营销者。Oplytic 无缝集成在您的联盟营销伙伴、移动分析平台、Web分析平台、CRM 和 DMP 之间,为您提供全面的分析图景。我们的使命是通过帮助营销者分析他们的营销和通信努力,执行强大的策略来吸引用户,以及在映射到他们目标渠道中优化媒体,来激励营销者追求他们的企业移动和Web策略。

CI Status Version License Platform

要求

最低的 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)
  1. eventAction:与事件动作关联的字符串,例如,“查看”或“购物”。
  2. eventObject:与事件动作目标关联的字符串,例如“地图”或对象SKU。
  3. eventId:可以传递的唯一字符串,以关联事件。
  4. str1,str2,str3:与事件关联的任意字符串。您可以使用这些字符串为该事件传递任何类型的相关数据。
  5. num1,num2:与事件关联的任意Double数值。您可以使用这些值传递该事件的相关数据。

具体使用AddPurchaseEvent来跟踪应用内购买

public func addPurchaseEvent(item: String, itemId: String, quantity: Double, price: Double, currency_unit: String)
  1. item:被购买项目的名称。
  2. Item_id:与被购买项目关联的SKU或其他ID。
  3. quantity:被购买项目的数量。
  4. price:被购买项目的价格。
  5. 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
        }
    }

作者

斯卡斯,[email protected]

许可证

OplyticSDKRepo可在MIT许可证下使用。有关更多信息,请参阅LICENSE文件。