mParticle (导出)

概述

只需按一下键,就可以将 Branch 数据发送到 mParticle 操作后台 (Dashboard),帮助您了解 Branch 作为获客途径的功能,将数据导出到整个分析工具套件,并在 Branch 数据上建立自定义的受众。

本文档说明了如何将分支事件发送到mParticle 。 mParticle将此称为入站提要集成。

If you'd like to send mParticle events to Branch through your app, please review the Branch/mParticle SDK Kit integration documentation for iOS and Android.

If you'd like to send mParticle events to Branch through a server-to-server integration, please review the mParticle (import) documentation.

它是如何工作的?

将Branch SDK集成到应用后,Branch可以检测到哪些链接导致安装,重新打开和用户'操作。启用此集成并提供您的mParticle密钥/秘密,将导致Branch以mParticle期望的确切格式自动将属性事件转发到mParticle。

Branch 发送什么事件?

Branch will send attributed installs, opens, commerce events, user lifecycle events, content events, and custom events. Branch also sends all the data that is attached to the link that drove the attributed events. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users. You can see the list of fields that we send to mParticle here.

它是什么样子的?

分支事件在mParticle中将显示为Custom Attribution Event 。然后,您可以将分支数据导出到其他数据源。

分支事件的映射如下:

  • mParticle 事件类型=自定义事件
  • mParticle 自定义事件类型=归因

mParticle事件名称取决于事件的类型:

  • 安装=归因
  • 开放=重新参与
  • 其他=分支活动名称
13841384

For information on how to test your integration and see more detailed data, please review our testing instructions below.

设置

先决条件

检索 mParticle Key & Secret

找到您的 mParticle Key & Secret,并将其输入到 Branch 操作后台 (Dashboard) 中。

  1. Navigate to https://app.mparticle.com and log into the Dashboard.
  2. 在操作后台 (Dashboard)中,前往 Directory 并搜索 Branch。
  3. 点击 Branch tile,然后点击 Add Branch Metrics to Setup
  4. 选择 Input Feed 集成类型,然后点击 Go to Setup
13841384
  1. 指定以下配置参数:
    • 配置名称
    • 充当应用 (在此处选择合适的平台)
13841384
  1. 您的服务器复制到服务器 Key 和 Secret —您需要将它们输入到 Branch 操作后台 (Dashboard)。
13841384

启用集成

  1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.

  2. 搜索 mParticle,然后点击图块。

  3. 输入您的 mParticle Key 和 Secret,然后按 Enable

    图片图片

🚧

请测试集成!

Branch 对不正确的 API Key 概不负责。

*额外的 mParticle 资源:**

您可以在 mParticle 文档中找到有关 Branch 和 mParticle 集成的额外信息。

高级

Branch 发送到 mParticle 的内容

Property 名称来源于例如
event_name活动名称硬编码"归因"
custom_event_type"归因"硬编码"归因"
event_id事件的 unique IDBranch 事件 ID469939270182891107
custom_attributesBranch Link 数据 Dictionary事件归因于链接的最后归因触点数据"campaign": "mParticle test", "channel": "Slack"
timestamp_unixtime_ms事件的时间戳(以毫秒为单位)事件1513280479654
device_info设备数据,例如操作系统版本和国家/地区设备的 Branch 用户数据"os_version": "10.0","device_country": "US"
user_identitiesmParticle客户ID用户的 mParticle 客户 IDuser123abc
application_info应用信息,如包装名称Branch SDK /应用详细信息"application_name": "Branch-3rdParty-SDK-Testbed","application_version": "1.2.0"
IP事件 IP设备192.82.115.928

mParticle身份策略

分支将几个标识符发送给mParticle作为Webhook有效负载的一部分。值得注意的是,这些是:

标识符mParticle字段例如注意事项
IDFA苹果'广告编号ios_advertising_idEA7583CD-A667-48BC-B806-42ECB2B48606发送iOS事件,除非用户启用了“限制广告跟踪”
IDFVApple '的供应商IDios_idfv74683E89-E010-4A73-B3ED-2741D4E5FFFE发送大多数iOS事件
AAIDAndroid '的Android广告IDandroid_advertising_idcdda802e-fb9c-47ad-0794d394c913与Android活动一起发送
Android IDAndroid IDandroid_uuid404fc0aea39abcdf如果AAID不为'有时会在Android事件上发送
客户 IDmParticle客户ID客户IDuser123abc从分支映射的客户标识符 developer_identity
mPIDmParticle IDmpiduser123abcmParticle ID identifier mapped from Branch developer_identity

请确保您的mParticle身份策略与Branch发送的标识符对齐。如果不为' t,则mParticle最终可能会为从Branch发送的事件创建新的配置文件,而不是将这些事件附加到正确的现有配置文件上。

The Customer ID or mPID is of particular importance. If you set developer_identity with Branch (docs here), Branch will automatically map this to mParticle's Customer ID or mPID. Make sure the value you set here with Branch corresponds to the value you're using for that user in mParticle.

If you're using a different value in developer_identity please reach out to your Branch account team.

测试您的整合

要更详细地查看传递给 mParticle 的数据,可以将 Webhook 设置为 Requestbin。这将允许您仅将 Branch 事件的子集发送到 Requestbin 并验证数据是否按预期通过。

  1. 启用上面的 Branch 数据集成。从 Branch Link 安装应用以在 mParticle 中生成一些数据。自定义归因最多可能需要一个小时才能在 mParticle 中显示。

  2. 从操作后台 (Dashboard)的 Quick Links(快速链接)部分创建一个 Branch Link,Campaign 为 branch_test

    图片图片

  3. In mParticle, navigate to the Directory in mParticle and add Webhooks as an option. Add a Requestbin URL generated from https://requestb.in.

    图片图片

  4. 要优化发送到 Webhook 的数据,请前往 Connections > Connect

  5. 选择 Branch Feed 作为输入,并选择 Webhooks 作为输出。

  6. Finally, view the Requestbin. You can do this by appending ?inspect to your requestbin URL. You should be able to copy paste the POST body from the request bin into a JSON formatter like https://jsonlint.com/ to view the event details.

  7. 测试完成后,请删除 webhook。

常见问题

Branch 为什么不要求 mParticle 客户 ID?

Branch 不需要 mParticle 客户ID 是因为通常在安装应用时未设置该 ID。用户通常的工作流程是安装应用,然后大约三十秒钟后确认登录。Branch 安装事件会在安装后立即触发且发生在登录事件之前,因此在发送到 mParticle 之前还没有已登录的客户 ID。但是,您可以使用安装事件和登录事件附带的设备 ID 为客户加入安装事件。

筛选项