Segment (import)

概述

将事件从“细分”发送到“Branch”后,您可以将下游转化(例如,通过网络和应用购买)归因于“Branch”链接点击。从细分市场导入到Branch的事件将在您通常可以在Branch内使用事件的任何地方可用,包括仪表板可视化,数据馈送,通用广告回发,Journeys(网站向App引流解决方案) 定位,Liveview等。

本指南介绍了服务器端集成,以将数据从段导入到分支。对于从Branch到Segment的数据导出,请在此处转到

Branch导入什么事件?

Branch将导入未使用Branch SDK自动跟踪的事件。这包括商务,内容,用户生命周期和自定义事件,不包括诸如点击和安装之类的事件。见支持的事件和关联的映射的完整列表这里 。分支只会导入可以绑定到用户事件

设置

  1. 联系Branch以将Branch配置为接收来自细分的事件。请注意,要启用从细分受众群到Branch的数据导入,需要订阅数据Feed
  2. 导航到“Branch”仪表板的“ 数据集成”页面

    1. 从左侧菜单中选择Segment
    2. 选择您要从中导入事件的平台,然后点击Save

      图像

  3. 导航到您的细分用户界面的“目标”页面。

    1. 点击Add Destination
    2. 在“目标目录”中搜索“Branch”,然后确认您要连接的源。
    3. 输入您的Branch密钥。可以在“Branch”仪表板的“ 帐户设置>应用部分中找到。
    4. 输入您的Branch机密。可以在“Branch”仪表板的“ 帐户设置>应用部分中找到。

对于服务器端事件导入, 可以忽略SDK集成说明

避免重复数据

为了避免重复的数据,你要么直接与Branch轨迹转换事件或追踪段事件,然后使进口处,而不是两个。如果您尝试将已跟踪的事件导入到Branch,Branch将警告您。

跟踪

Branch集成支持使用Segment的 Track 方法跟踪的某些事件。跟踪API调用是您记录用户执行的所有操作以及描述该操作的所有属性的方式。

每个动作都称为一个事件。每个事件都有一个名称(如Registered)和属性,例如,Registered事件可能具有诸如plan或accountType的属性。这是删除了大多数常见字段的典型跟踪呼叫的有效负载:

{
  "type": "track",
  "event": "Registered",
  "properties": {
    "plan": "Pro Annual",
    "accountType" : "Facebook"
  }
}

这是将生成上述有效负载的相应Javascript事件:

analytics.track("Registered", {
  plan: "Pro Annual",
  accountType: "Facebook"
});

有关更多详细信息和示例,请参见第' s 轨道文档

支持的活动

Branch仅会从尚未导入Branch SDK的自动跟踪的细分中导入事件。这意味着无法导入诸如点击和安装之类的事件。下面概述了细分事件如何映射到Branch事件,以及如何将其导入到Branch:

段事件 BranchEvent Branch活动类别 进口的
Product Added Add To Cart 商业活动 Yes
Product Added to Wishlist Add To Wishlist 商业活动 Yes
Cart Viewed View Cart 商业活动 Yes
Payment Info Entered Add 付款信息 商业活动 Yes
Checkout Started Initiate Purchase 商业活动 Yes
Order Completed Purchase 商业活动 Yes
use the Branch event name Spend Credits 商业活动 Yes
Products Searched Search 内容事件 Yes
Product Viewed View Item 内容事件 Yes
Product List Viewed View Items 内容事件 Yes
Product Reviewed Rate 内容事件 Yes
Product Shared Share 内容事件 Yes
use the Branch event name Complete Registration 生命周期事件 Yes
use the Branch event name Complete Tutorial 生命周期事件 Yes
use the Branch event name Achieve Level 生命周期事件 Yes
use the Branch event name Unlock Achievement 生命周期事件 Yes
any event name Custom 自订活动 Yes
Deep Link Clicked Click -- No
Install Attributed Install -- No
Deep Link Opened Reinstall -- No
Deep Link Opened Open -- No
- SMS Sent -- No
- Pageview -- No
- Web Session Start -- No
- Branch CTA View -- No
- Impression -- No
- Web to App Auto Redirect -- No
Application Installed -- -- No
Application Opened -- -- No
Application Updated -- -- No
Application Backgrounded -- -- No
Application Crashed -- -- No
Application Uninstalled -- -- No
Push Notification Received -- -- No
Push Notification Tapped -- -- No
Push Notification Bounced -- -- No

应用程序事件的标识符

必须输入标识符,事件才能导入到Branch。您必须包括:

  • context.device.advertisingId和context.os.name或
  • context.device.id和context.os.name或

Branch将Segment '的标识符映射到以下内容:

段字段 Branch领域
userId developer_identity
context.device.advertisingId idfa 要么 aaid
context.device.id idfv 要么 android_id
context.os.name os

如果将User ID与Segment一起使用,Branch将自动将此映射到开发人员身份 。有关更多详细信息,请查看第' s 用户ID文档

Branch不会将Segment '的匿名ID映射到任何字段,并且不会将从服务器到服务器集成接收到的注销Web事件归为属性。匿名ID 仍可以附加到事件

网络事件的标识符

为了准确地在网络上进行归因,重要的是收集Branch SDK '的浏览器指纹并将其传递给细分跟踪功能。 Branch将其与Segment SDK收集的userAgent 结合使用,以标识用户'的角色,平台,操作系统和其他参数。可以使用以下代码段来收集浏览器指纹:

仅适用于登录的网络事件

即使传递匿名ID,分支机构也不会将已注销的网络事件归因于网段。

const loadBranchAndGetFingerprint = new Promise(function(resolve, reject) {
  branch.init('BRANCH_KEY', {}, function(err, data) {
  branch.getBrowserFingerprintId(function(err, fingerprint) {  // fetch the browser fingerprint from the SDK
    if (!!err) {
      reject(err);
      return;
    }
    resolve({...data, fingerprint});
  });
  });
});

然后,您可以将其传递到细分跟踪事件的有效负载中:

loadBranchAndGetFingerprint.then(function(data) {
    const { fingerprint } = data;
    // Load the Segment SDK and initialize with key here

    // Segment track request
    analytics.track('Order Completed', {
        browser_fingerprint_id: fingerprint // add the browser fingerprint to the Segment track event
        //... Other event details ...
    })
});

验证整合

一旦在“细分”和“Branch”中都打开了导入功能,事件就会发生。如果Branch发生了以下事件,您将在导入卡上看到一个绿点:

图像

要查看有关即将发生的事件的更多信息,可以查看 Liveview origin SEGMENT 事件:

图像

Branch机构从细分市场导入的事件为商务,用户生命周期,内容或自定义事件

使用导入的事件

从细分市场导入到Branch的事件将在您通常可以在Branch中使用事件的任何地方可用。这包括仪表板可视化,数据馈送(包括数据集成,查询API,Webhooks和每日导出API),通用广告回发,Journeys(网站向App引流解决方案) 定位,Liveview等。

高级

将匿名ID附加到事件

从带有细分ID的细分中导入的事件将保留该事件的值,并且如果从Branch中导出回去,则在custom_data字段中将可用。要将匿名ID附加到由Branch自动跟踪的事件(安装,打开等),请遵循这里的指示。

网络上已注销用户的归因

Branch使用自定义的内部标识符为Web上注销的用户使用。如果启用服务器到服务器从细分到分支的集成,则无法将已注销的Web事件从细分中归因于使用Branch运行的广告系列。因此,您可能想直接使用Branch Web SDK跟踪网络事件,同时仍将应用事件服务器从细分发送到服务器。分支允许您随后关闭Web事件导入,以防止重复数据。

更新5 天前

Segment (import)


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

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