mParticle Android

本文档说明了如何将 mParticle事件发送到您的Branch仪表板 。如果喜欢送分公司将安装到您的mParticle仪表板,请参阅Branch/ mParticle数据集成

这些说明适用于mParticle SDK 5+集成

mParticle在其SDK的v5中引入了一个新的归因&深度链接接API( http://docs.mparticle.com/developers/sdk/android/getting-started/#upgrade-to-version-5-of-the-sdk ),因此,如果您的应用中安装了mParticle SDK < v5,请与您的Branch或mParticle客户经理联系以获取更多详细信息。

Google Play服务版本17+

2019年6月进行的一次重大Google Play服务更改导致Branch的Android SDK(以及其他各种跨平台SDK,例如Unity)停止收集Android AID。

为确保Branch深度链接接和归因继续有效,您必须遵循Google的更新说明这里

如果您运行的Google Play服务版本低于17,则无需更新。

技术要求

Branch机构设置

配置Branch&启用应用程序链接

图像
图像

  • 将以下用于Branch URI方案的意图过滤器添加到Android清单中的LauncherActivity
<!-- Branch URI Scheme -->
<intent-filter>
  <data android:scheme="androidexample" />
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
</intent-filter>
  • 将以下用于Branchapp.link 域的意图过滤器添加到Android清单中的LauncherActivity
<!-- Branch App Links (optional) -->
<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="example.app.link" />
  <data android:scheme="https" android:host="example-alternate.app.link" />
</intent-filter>
  • android:launchMode="singleTask" 加到LauncherActivity
<!-- Launcher Activity to handle incoming Branch intents -->
<activity
          android:name=".LauncherActivity"
          android:launchMode="singleTask"
          android:label="@string/app_name"
          android:theme="@style/AppTheme.NoActionBar">

  <intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>

mParticle设置

在mParticle上启用Branch

  • 在mParticle仪表板中启用Branch之前,必须在Branch仪表板的“ 链接设置页面上检索Branch键。

  • 请遵循mParticle文档,以了解如何连接事件输出 ;即启用Branch集成。

在mParticle仪表板中添加了工具包并配置了BranchAPI密钥后,mParticle SDK将负责初始化Branch SDK并转发适当的应用程序生命周期事件以处理深度链接接。

安装mParticleBranch工具包

导入Android支持库

  • 'com.android.support:customtabs:23.3.0'
  • 'com.google.android.gms:play-services-ads:9+'
  • 'com.google.android.gms:play-services-appindexing:9.+'

mParticle套件中的初始化Branch

与任何套件一样,mParticle将自动处理初始化Branch会话。请确保在您的Android应用程序类中调用了mParticle.start() (这应该已经在基本mParticle集成中说明了)。

此时,您应该开始在Branch仪表板中看到Branch会话数据-包括安装,重新打开和任何自定义事件。

要求

[x]与任何与归因相关的集成一样,请确保已将mParticle ReferrerReceiver 添加到应用程序的AndroidManifest.xml

通过mParticle检索深度链接数据

我们与mParticle的集成支持创建和归属用于安装和打开应用程序的深度链接接。深度链接通常将包含一些其他信息,这些信息将在用户最终打开您的应用程序时使用,以便您可以将用户正确地路由到适当的内容,或者以其他方式自定义他们的体验。

请确保您遵循了 mParticle 的文档以确保检索到您的深度链接接数据。

React Native中的mParticle

如果将mParticle集成到React Native中,您仍将Branch Kit集成为Native模块,并按照上面的设置步骤进行操作。然而,而不是在本地层获取深度链接接数据,也会通过检索深度链接接数据 mParticle 小号阵营发现这里的本地函数

测试深度链接

  • Branch 控制面板中创建深度链接

  • 从设备中删除您的应用程序

  • 将您的应用编译到设备上

  • 粘贴深度链接到 Google Hangouts

  • 点击深度链接打开您的应用

实施功能

  • 有关如何通过mParticle SDK访问Branch套件的信息,请参考mParticle 直接调用套件文档。

  • 直接调用Branch SDK也需要使用.getAutoInstance()而不是.getInstance()

  • 引用Branch工具包后,请参阅Branch 本机Android SDK 文档,以了解如何实现辅助功能。

测试应用

故障排查

请参阅“ BranchAndroid SDK故障排除”部分

应用未从冷启动开始进行深度链接接

- Make sure onNewIntent is setting a new intent every time your `LauncherActivity.java` opens
public class LauncherActivity extends AppCompatActivity {
...

    @Override
    public void onNewIntent(Intent intent) {
        this.setIntent(intent);
    }

...

}
class LauncherActivity : AppCompatActivity() {
...

    public override fun onNewIntent(intent: Intent) {
        this.intent = intent
    }

...

}

Updated 5 months ago

mParticle Android


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。