mParticle (导出)
Send Branch data to mParticle to unlock a more holistic picture of the customer journey for your app.
概述
只需按一下键，就可以将 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 events sent to mParticle
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.
| Property 名称 | 值 | 来源于 | 例如 |
|---|---|---|---|
event_name | 活动名称 | 硬编码 | "归因" |
custom_event_type | "归因" | 硬编码 | "归因" |
event_id | 事件的 unique ID | Branch 事件 ID | 469939270182891107 |
custom_attributes | Branch Link 数据 Dictionary | 事件归因于链接的最后归因触点数据 | "campaign": "mParticle test", "channel": "Slack" |
timestamp_unixtime_ms | 事件的时间戳（以毫秒为单位） | 事件 | 1513280479654 |
device_info | 设备数据，例如操作系统版本和国家/地区 | 设备的 Branch 用户数据 | "os_version": "10.0","device_country": "US" |
user_identities | mParticle客户ID | 用户的 mParticle 客户 ID | user123abc |
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_id | EA7583CD-A667-48BC-B806-42ECB2B48606 | 发送iOS事件，除非用户启用了“限制广告跟踪” |
| IDFV | Apple '的供应商ID | ios_idfv | 74683E89-E010-4A73-B3ED-2741D4E5FFFE | 发送大多数iOS事件 |
| AAID | Android '的Android广告ID | android_advertising_id | cdda802e-fb9c-47ad-0794d394c913 | 与Android活动一起发送 |
| Android ID | Android ID | android_uuid | 404fc0aea39abcdf | 如果AAID不为'有时会在Android事件上发送 |
| 客户 ID | mParticle客户ID | 客户ID | user123abc | 从分支映射的客户标识符 developer_identity |
| mPID | mParticle ID | mpid | user123abc | mParticle 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中将显示为Custom Attribution Event 。然后，您可以将分支数据导出到其他数据源。
分支事件的映射如下：
- mParticle 事件类型=自定义事件
- mParticle 自定义事件类型=归因
mParticle事件名称取决于事件的类型：
- 安装=归因
- 开放=重新参与
- 其他=分支活动名称
For information on how to test your integration and see more detailed data, please review our testing instructions below.
先决条件
In order to enable mParticle (export), you need to have completed the following:
- Admin access to your Branch Dashboard.
- Enabled Data Feeds for your Branch account.
- Contact your Branch account manager or visit https://branch.io/pricing
- Implemented the AdSupportFramework on iOS and Google Play Services library on Android.
- Admin access to your mParticle account.
Enable mParticle (export)
1. Retrieve your mParticle Key & Secret
找到您的 mParticle Key & Secret，并将其输入到 Branch 操作后台 (Dashboard) 中。
- Navigate to https://app.mparticle.com and log into the Dashboard.
- 在操作后台 (Dashboard)中，前往 Directory 并搜索 Branch。
- 点击 Branch tile，然后点击 Add Branch Metrics to Setup
- 选择 Input Feed 集成类型，然后点击 Go to Setup
- 指定以下配置参数：
- 配置名称
- 充当应用 （在此处选择合适的平台）
- 您的服务器复制到服务器 Key 和 Secret —您需要将它们输入到 Branch 操作后台 (Dashboard)。
2. Enable mParticle (Export) in Branch
- On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.
- 搜索 mParticle，然后点击图块。
- 输入您的 mParticle Key 和 Secret，然后按 Enable 。
3. Verify the integration
要更详细地查看传递给 mParticle 的数据，可以将 Webhook 设置为 Requestbin。这将允许您仅将 Branch 事件的子集发送到 Requestbin 并验证数据是否按预期通过。
- 启用上面的 Branch 数据集成。从 Branch Link 安装应用以在 mParticle 中生成一些数据。自定义归因最多可能需要一个小时才能在 mParticle 中显示。
- 从操作后台 (Dashboard)的 Quick Links（快速链接）部分创建一个 Branch Link，Campaign 为 branch_test 。
- In mParticle, navigate to the Directory in mParticle and add Webhooks as an option. Add a Requestbin URL generated from https://requestb.in.
- 要优化发送到 Webhook 的数据，请前往 Connections > Connect 。
- 选择 Branch Feed 作为输入，并选择 Webhooks 作为输出。
- 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.
- 测试完成后，请删除 webhook。
支持中心
Branch 为什么不要求 mParticle 客户 ID？
Branch 不需要 mParticle 客户ID 是因为通常在安装应用时未设置该 ID。用户通常的工作流程是安装应用，然后大约三十秒钟后确认登录。Branch 安装事件会在安装后立即触发且发生在登录事件之前，因此在发送到 mParticle 之前还没有已登录的客户 ID。但是，您可以使用安装事件和登录事件附带的设备 ID 为客户加入安装事件。
Updated 2 months ago