Axon 移动应用集成

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

警告

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

下载最新 SDK

您可以通过 Gradle 作为依赖下载 SDK。SDK 需要不低于 19 的 minSdkVersion。

将下列行添加至您的应用层级 build.gradle 文件：

Groovy

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation 'com.applovin:axon-sdk:+'
  ⋮
}

Kotlin

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation("com.applovin:axon-sdk:+")
  ⋮
}

ProGuard 规则

如果您使用 ProGuard，请注意 AAR 中的必要 ProGuard 规则已捆绑 AppLovin Axon SDK，因此您无需向项目添加任何额外的 ProGuard 规则。

注意

SDK 会收集 Google 广告 ID。 为此，需要安卓广告 ID (AAID) 模块 (com.google.android.gms:play-services-ads-identifier)。 请参阅 Google Play 服务依赖了解更多信息。

初始化 SDK

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

您可以在 AppLovin 控制面板的 Account > General > Keys 下找到 AXON Event Key。

Java

import com.applovin.sdk.Axon;

Axon.getInstance().initialize( "«your-event-key»", new Axon.InitializationListener()
{
  @Override
  public void onInitialized()
  {
    ⋮
  }
} );

Kotlin

import com.applovin.sdk.Axon

Axon.getInstance().initialize("«your-event-key»", {
  ⋮
})

处理深度链接

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

注意

AppLovin 仅处理来自 AppLovin 的 URL。

Java

@Override
protected void onCreate(@Nullable final Bundle savedInstanceState)
{
  super.onCreate( savedInstanceState );
  ⋮
  processIntent( getIntent() );
}

@Override
protected void onNewIntent(final Intent intent)
{
  super.onNewIntent( intent );
  ⋮
  processIntent( intent );
}

private void processIntent(final Intent intent)
{
  ⋮
  if ( Intent.ACTION_VIEW.equals( intent.getAction() ) )
  {
    final Uri uri = intent.getData();
    if ( uri != null )
    {
      Axon.getInstance().processDeepLink( uri );
    }
  }
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?)
{
  super.onCreate(savedInstanceState)
  ⋮
  processIntent(intent)
}

override fun onNewIntent(intent: Intent?)
{
  super.onNewIntent(intent)
  ⋮
  processIntent(intent)
}

private fun processIntent(intent: Intent?)
{
  ⋮

  if (intent?.action == Intent.ACTION_VIEW)
  {
    intent.data?.let { uri -> Axon.getInstance().processDeepLink(uri) }
  }
}

使用 Axon SDK 跟踪事件

注意

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

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

Java

sdk.getEventService().trackEvent( «event-name», «event-data» );

Kotlin

sdk.eventService.trackEvent(«event-name», «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 建议您创建一个 Map 作为数据负载。示例如下：

Java

Map<String, Object> parameters = new HashMap<>();
parameters.put( "currency", "USD" );
parameters.put( "value", 99.99 );

List<Map<String, Object>> items = new ArrayList<>();
...
parameters.put( "items", items );
sdk.getEventService().trackEvent( "add_to_cart", parameters );

Kotlin

sdk.eventService.trackEvent("add_to_cart", mapOf(
  "currency" to "USD",
  "value" to 99.99,
  "items" to listOf(
    ⋮
  )
))