OplyticSDK 0.2.2

OplyticSDK 0.2.2

×

由 Donald Wakeling 维护。

OplyticSDK 0.2.2

  • 由
  • Oplytic 支持

OplyticSDK

Oplytic 为 App 到 App 和移动 Web 到 App 的移动营销提供归因。Oplytic 利用 iOS 的 Universal Links 和 Android 的 App Links 提供的跟踪来提供移动营销人员所需的精确归因和再归因。

Oplytic 是针对零售商和联属网络而设计的。我们知道这种关系对每个人的整体成功都多么有价值。

通过利用 iOS 和 Android 提供的本地活动跟踪，Oplytic 跟踪移动应用内的安装、操作和购买，并向联属网络合作伙伴提供精确的归因和再归因。Oplytic 在您的联属网络合作伙伴、移动分析平台、网络分析平台、CRM 和 DMP 之间无缝集成，使您能够获得全面的测量视图。我们的使命是通过帮助分析他们的营销和沟通努力，执行强大的策略以参与用户，并优化与他们的目标相匹配的渠道中的媒体，来增强营销人员追求其移动和 Web 策略。

CI Status Version License Platform

要求

最低 iOS 部署目标为 10.0。

安装

OplyticSDK 通过 CocoaPods 提供。要安装它，只需将以下行添加到您的 Podfile 中

pod 'OplyticSDK'

与 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项目。

点击项目目标，然后在“通用”选项卡下，点击嵌入二进制文件部分的“+”按钮。选择OplyticSDK.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) 跟踪 App-事件

添加事件只有两种方法。每当您想要跟踪购买、注册或其他重要应用程序事件时，请调用这些调用。

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：与事件操作相关联的字符串，例如，“view”或“shop”。
  2. eventObject：与事件操作目标相关联的字符串，例如“map”或对象 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
        }
    }

作者

Oplytic 支持部门，[email protected]

许可证

OplyticSDK 根据MIT许可证可用。更多信息请参阅LICENSE文件。