mParticle iOS

GitHub tag (latest by date)GitHub tag (latest by date)

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

📘

这些说明适用于mParticle SDK版本7+集成

mParticle introduced a new attribution & deep linking API in v7 of their SDK (http://docs.mparticle.com/developers/sdk/ios/getting-started/#upgrade-to-version-7-of-the-sdk), so please contact your Branch or mParticle Account Managers for more details, if you have mParticle SDK < v7 installed in your app.

🚧

iOS 11.2上通用链接行为不一致

将设备更新到iOS 11.2后,我们发现安装应用后,应用的AASA文件不再可靠地下载到用户的设备上。因此,点击通用链接将不再一致地打开该应用程序。您可以在Branch链接上设置强制uri重定向模式 ,以使用URI方案打开应用。在 Apple Bug报告中查看问题的详细信息

技术要求

📘

iOS 14实施

为了帮助您全面管理用户体验,Branch SDK 将不会触发 IDFA 许可模式。

然而,如果您选择触发这一模式,在可行的情况下,Branch 仍然可以收集并使用 IDFA。

学到更多

Branch机构设置

配置 Bundle identifier

图像图像

确认应用程序前缀(app prefix)

图像图像

配置Branch仪表板&启用通用链接

图像图像
图像图像

配置associated domains(关联域)

  • Branch 控制面板中添加链接域名

  • -alternate 网站内部的 Web SDK 进行通用链接时需要

  • test- 如果需要使用测试键,则需要

  • 如果您使用自定义链接域 ,则需要包括旧链接域, -alternate链接域和新链接域

图像图像

配置 entitlements

  • 确认权利在目标范围内

图像图像

配置 info.pList

  • 添加 Branch 控制面板的参数

    • branch_app_domain 下添加您的 live key 下的域名
    • 添加您的URI Scheme为URL Types - > Item 0 - > URL Schemes
    • 不要将您的API密钥添加到文件中(mParticle通过仪表板进行处理)

图像图像

mParticle设置

在mParticle上启用Branch

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

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

  • 如果您为Branch实施启用了Apple Search Ads,则还必须在“连接设置”中选中Enable Apple Search Ads

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

安装mParticleBranch工具包

选项 1:CocoaPods

platform :ios, '8.0'

    target 'APP_NAME' do
      # if swift
      use_frameworks!

      ‘pod 'mParticle-BranchMetrics', '~> 7'
    end

选项 2:Carthage

github "mparticle-integrations/mparticle-apple-integration-branchmetrics"

导入iOS支持库

  • AdSupport
  • SafariServices
  • MobileCoreServices
  • CoreSpotlight
  • iAd

mParticle套件中的初始化Branch

mParticle iOS SDK(版本5.4.1和更高版本)将自动调用Branch Kit的以下方法:

  • initSessionWithLaunchOptions:application:didFinishLaunchingWithOptions:

  • handleDeepLink:application:openURL:options:

  • continueUserActivity:application:continueUserActivity:restorationHandler:

这意味着mParticle将自动处理初始化Branch会话。但是,请确保在mParticleOptions 对象中启用了.onAttributionComplete

🚧

mParticle appDelegate代理未启用

如果未启用mParticle appDelegate代理,则必须将mParticle URI &域中继添加到appDelegate。

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

通过mParticle检索深度链接数据

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

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

📘

React Native中的mParticle

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

测试深度链接

  • Branch 控制面板中创建深度链接
  • 从设备中删除您的应用程序
  • 在设备上编译和测试
  • 粘贴深度链接到 Apple Notes
  • 长按深度链接(并非 3D 触点)
  • 点击Open in "APP_NAME" 打开您的应用( 示例

实施功能

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

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

测试应用

故障排查

请参考分公司的iOS SDK故障排除部分

更新17 天前


mParticle iOS


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

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