Axon 移动应用集成

本指南介绍了如何将 Axon SDK 集成到您的原生 iOS 移动应用中，以便追踪应用事件。

警告

目前，SDK 集成仍处于测试阶段，仅在部分地区开放使用。

下载最新 SDK

您可以通过 CocoaPods 将 SDK 作为依赖项下载。

SDK 要求 iOS 最低部署目标为 iOS 12.0 或更高版本。 此外，Xcode 需要为 15 或更高版本。

通过 CocoaPods 集成 AxonSDK：

1. 将下列行添加至您的 Podfile：

   pod 'AxonSDK'

2. 在命令行中运行以下命令：

   pod install --repo-update

初始化 SDK

在启动时使用 Event Key 初始化 AxonSDK，最大化 SDK 核心服务的准备时间。 将 “«your-event-key»” 替换为您的 Axon Event Key。

要查找您的 Axon Event Key，请导航至 AppLovin 控制面板中的 Account > General > Keys。

Swift

import AxonSDK

Axon.shared.initialize(withKey: "«your-event-key»") {
  ⋮
}

Objective-C

#import <AxonSDK/AxonSDK.h>

[[ALAxon shared] initializeWithKey: @"«your-event-key»" completionHandler:^{
  ⋮
}];

处理深度链接

您必须提供一个深度链接，确保用户在点击广告时，如果已安装应用则可以无缝打开应用，否则点击会将用户引导至浏览器。 在您的应用委托中，调用 Axon SDK 的 processDeepLink: API 来处理入站深度链接和相关元数据。

注意

AppLovin 仅处理来自 AppLovin 的 URL。

Swift

func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool
{
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
        let url = userActivity.webpageURL else
  {
    return true
  }

  // Pass deep link URL to Axon SDK in order to potentially reattribute the user
  Axon.shared.processDeepLink(url)

  return true
}

Objective-C

- (BOOL)application:(UIApplication *)application
continueUserActivity:(NSUserActivity *)userActivity
 restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> *restorableObjects))restorationHandler
{
  if ( ![userActivity.activityType isEqualToString: NSUserActivityTypeBrowsingWeb] ) return YES;

  // Pass deep link URL to Axon SDK in order to potentially reattribute the user
  [ALAxon.shared processDeepLink: userActivity.webpageURL];

  return YES;
}

使用 Axon SDK 跟踪事件

注意

请至少提供 page_view、view_item、add_to_cart、begin_checkout 和 purchase 事件。 如果您的网站使用这些事件，还请添加 sign_up 或 login。

请使用以下语法向 Axon 发送电商事件。每个事件都应在其对应的事件出现在数据层中时触发。

Swift

sdk.eventService.track(event: «event-name», parameters: «event-data»)

Objective-C

[sdk.eventService trackEvent: «event-name» withParameters: «event-data»];

参数

名称	类型	描述
event_name	字符串	该事件的名称。请参阅 Axon Pixel 事件和对象，了解可用的事件。
event_data	对象	该事件的数据。请查看 Axon Pixel 事件和对象了解要发送的数据。(请注意：发送 page_view 事件时不需要发送 event_data。)

所有事件都需要 event_name 参数。除 page_view 外每个事件都需要特定的 event_data，请在下方具体事件对应版块查阅描述。

向 Axon SDK 发送数据

针对每个需要 event_data 的事件，AppLovin 建议您创建一个字典 (dictionary) 作为数据负载。 示例如下：

Swift

sdk.eventService.track(event: "add_to_cart", parameters: [
  "currency" : "USD",
  "value" : 99.99,
  "items" : [
    ⋮
  ]
])

Objective-C

[sdk.eventService trackEvent: @"add_to_cart" parameters: @{
  @"currency" : @"USD",
  @"value" : @(99.99),
  @"items" : @[
    ⋮
  ]
}];