Sending events from Tealium to Branch will allow you to attribute downstream conversions like purchases across web and app to Branch link clicks. Events imported from Tealium to Branch will be available wherever you can normally use events within Branch, including dashboard visualizations, Data Feeds, Universal Ads postbacks, Journeys targeting, Liveview and more.
This guide will walk you through how to send your Tealium data to Branch using Branch Data Integration. Enabling this integration will result in automatically forwarding Tealium events to Branch via Tealium's Server-Side Connectors.
Once the Branch SDK is integrated into an app, Branch can detect which Branch Links are leading to installs, re-opens, and users' actions. Enabling this integration and sending your events to Branch will allow Branch to enhance your Tealium data with Branch data.
Branch will import events that are not auto-tracked with the Branch SDKs. This includes commerce, content, user lifecycle, and custom events, and excludes events like clicks and installs.
🚧
Avoid Duplicate Data
To avoid duplicate data, you should either track conversion events directly with Branch or track events with Tealium and then enable import to Branch, not both. Branch will warn you if you try to import events to Branch that you are already tracking.
In order to enable Tealium (import), you need to have completed the following:
- Admin access to your Branch Dashboard.
- Enabled Data Feeds for your Branch account.
- Implemented the Branch SDK into your mobile app (iOS | Android)
- You also need to be a Tealium customer using the Customer Data Hub in your app.
- Admin access to your Tealium account.
- Go to the Tealium Customer Data Hub
- 将 Branch 添加为连接器
- EventStream> 事件连接器。
- AudienceStream> Audience 连接器(用于访问者数据连接器)

- 选择要发送的数据源和事件源。
- 为您的连接器设置一个名称。
- Add your Branch Key from your Branch Dashboard

- 设置 Action 名称。
- 选择一个操作类型(这是要发送到 Branch 的事件)
- 配置必需的事件属性
- [可选]配置可选事件属性

- Use Tealium Trace
- 启动一个新的追踪。
- 点击 Actions Triggered 条目以在跟踪日志中展开,以检查要验证的操作。
- 查找您要验证的操作并查看日志状态。
🚧
Tealium Tools Browser Extension REQUIRED
Tealium Tools is needed to start and end a trace session in your browser.
可以使用可选事件参数映射进一步配置在连接器中设置的操作。
Log Commerce Event
参数 | 描述 |
---|
用户数据 | 标识移动设备的属性。 - 操作系统版本:编号,操作系统的版本。特定于 Android 和 iOS。
- 环境:string,通常为 “FULL_APP”。
- 用户代理:string,事件发生的浏览器或应用的用户代理。
- HTTP Origin:string,Web SDK 记录的 Web 会话开始的当前页面 URL。
- HTTP Referrer:string,推荐 url,该推荐网址指向 Web SDK 登录的 Web 会话开始的当前页面。
- 本地 IP:string,设备的本地 IP(仅 Android)。
- 国家/地区:string,用户的国家/地区代码,通常基于设备设置或用户代理 string。
- 语言:string,用户的语言代码,通常基于设备设置或用户代理 string。
- 品牌:string,设备的品牌。
- 型号:string,设备型号。
- 应用版本:string,用户下载的应用版本。
- 屏幕 DPI:编号,屏幕的 DPI。
- 屏幕高度:数字,屏幕高度。
- 屏幕宽度:数字,屏幕宽度。
- 开发者身份:string,用户为开发者指定的身份。
- 设备指纹 ID:Branch 内部专用字段,用于追踪设备。
- 浏览器 Fingerpring ID:Branch 内部专用字段,用于追踪浏览器。
- 限制广告追踪:如果合作伙伴选择不被广告主追踪,则为 true。
|
事件数据 | 与事件类型相关的数据。 - 交易 ID:string,供内部使用的合作伙伴指定的交易 (transaction) ID。
- 货币:string,合作伙伴最初报告收入,价格,运费,税金的货币。
- 收入:数字,合作伙伴指定的事件报告收入。
- 运输:编号,与交易相关的运输成本。
- 税:数字,与交易关联的总税。
- 优惠券:string,随交易兑换的交易优惠券(例如 “SPRING2017”)。
- 关联:发生交易的 string,商店或关联(例如 “Google Store”)。
- 描述:string,与事件相关的描述,不一定特定于任何单个内容项。
|
自定义数据 | 应用开发人员希望附加到事件的 key-values pair。 |
内容项 | 内容项属性,指定长度相等的数组类型值或单个值,该值将应用于所有项。 - 内容架构:内容的类别或架构,将来可能会用于分析。以下之一:
- COMMERCE_AUCTION
- COMMERCE_BUSINESS
- COMMERCE_OTHER
- COMMERCE_PRODUCT
- COMMERCE_RESTAURANT
- COMMERCE_SERVICE
- COMMERCE_TRAVEL_FLIGHT
- COMMERCE_TRAVEL_HOTEL
- COMMERCE_TRAVEL_OTHER
- GAME_STATE
- MEDIA_IMAGE
- MEDIA_MIXED
- MEDIA_MUSIC
- MEDIA_OTHER
- MEDIA_VIDEO
- OTHER
- TEXT_ARTICLE
- TEXT_BLOG
- TEXT_OTHER
- TEXT_RECIPE
- TEXT_REVIEW
- TEXT_SEARCH_RESULTS
- TEXT_STORY
- TEXT_TECHNICAL_DOC
- 标题:标题(用于单个内容项)。
- 描述:描述(针对单个内容项)。
- 图片网址:图片 URL(用于单个内容项)。
- Canonical Identifier: used to allow Branch to unify content/messages for Content Analytics.
Publicly Indexable: true - content can be seen by anyone, false - cannot index for public use. - 可本地索引:true-可以为本地(设备)使用编制索引内容,false-无法为本地使用编制索引。
- 价格:产品/内容的价格。
- 数量:要订购的商品数量(用于 PURCHASE,ADD_TO_CART 等)。
- SKU:产品 sku 或产品 ID。
- 产品名称:产品名称。
- 产品品牌:产品的品牌。
- 产品类别:产品的类别(如果适用)。以下之一:
- ANIMALS_AND_PET_SUPPLIES
- APPAREL_AND_ACCESSORIES
- ARTS_AND_ENTERTAINMENT
- BABY_AND_TODDLER
- BUSINESS_AND_INDUSTRIAL
- CAMERAS_AND_OPTICS
- ELECTRONICS
- FOOD_BEVERAGES_AND_TOBACCO
- 家具类
- HARDWARE
- HEALTH_AND_BEAUTY
- HOME_AND_GARDEN
- LUGGAGE_AND_BAGS
- MATURE
- MEDIA
- OFFICE_SUPPLIES
- RELIGIOUS_AND_CEREMONIAL
- SOFTWARE
- SPORTING_GOODS
- TOYS_AND_GAMES
- VEHICLES_AND_PARTS
- 产品变体:产品的变体(例如 XL,红色)。
- 平均评分:该项目的平均评分。
- 评分数:该项目的评分数。
- 最高评分:该项目的最高可能评分(例如,如果5星最高可能评分,则为5.0)。
- 创建时间戳:创建内容的时间。
- 截止日期:该内容不再有效的最后时间。 null/0 表示没有限制。应该很少设置。
- 条件:对于拍卖,该物品是否是新的,良好的,可以接受的,等等。其中之一:
- OTHER
- 新的
- 优秀的
- 好的
- 公平的
- 较差的
- 用过的
- 翻新的。
- 关键字:关键字。
- 图像标题:带有逗号分隔值的字符串,与图像关联的标题。
- 纬度:餐馆,公司,房间(酒店)等的纬度。
- 经度:餐馆,公司,房间(酒店)等的经度。
- 邮政编码:餐厅,公司,房间(酒店)等的邮政编码。
- 国家/地区:饭店,公司,房间(酒店)等的国家/地区代码。
- 地区:餐厅,公司,客房(酒店)等的州或地区。
- 城市:餐厅,公司,房间(酒店)等的街道地址。
- 街道:餐厅,公司,房间(酒店)等的街道地址。
- 自定义字段:应用开发人员希望附加到内容项的 key-values pairs。
|
日志内容事件
参数 | 描述 |
---|
用户数据 | 标识移动设备的属性。 - 操作系统版本:编号,操作系统的版本。特定于 Android 和 iOS。
- 环境:string,通常为 “FULL_APP”。
- 用户代理:string,事件发生的浏览器或应用的用户代理。
- HTTP Origin:string,Web SDK 记录的 Web 会话开始的当前页面 URL。
- HTTP Referrer:string,推荐 url,该推荐网址指向 Web SDK 登录的 Web 会话开始的当前页面。
- 本地 IP:string,设备的本地 IP(仅 Android)。
- 国家/地区:string,用户的国家/地区代码,通常基于设备设置或用户代理 string。
- 语言:string,用户的语言代码,通常基于设备设置或用户代理 string。
- 品牌:string,设备的品牌。
- 型号:string,设备型号。
- 应用版本:string,用户下载的应用版本。
- 屏幕 DPI:编号,屏幕的 DPI。
- 屏幕高度:数字,屏幕高度。
- 屏幕宽度:数字,屏幕宽度。
- 开发者身份:string,用户为开发者指定的身份。
- 设备指纹 ID:Branch 内部专用字段,用于追踪设备。
- 浏览器 Fingerpring ID:Branch 内部专用字段,用于追踪浏览器。
- Limit Ad Tracking: true, if the partner has opted to not be tracked by advertiser
|
事件数据 | 与事件类型相关的数据。 - 搜索查询:string,与事件关联的搜索查询。
- 描述:string,与事件关联的描述,不一定特定于任何单个内容项。
|
自定义数据 | 应用开发人员希望附加到事件的 key-values pair。 |
内容项 | 内容项属性,指定长度相等的数组类型值或单个值,该值将应用于所有项。 - 内容架构:内容的类别或架构,将来可能会用于分析。以下之一:
- COMMERCE_AUCTION
- COMMERCE_BUSINESS
- COMMERCE_OTHER
- COMMERCE_PRODUCT
- COMMERCE_RESTAURANT
- COMMERCE_SERVICE
- COMMERCE_TRAVEL_FLIGHT
- COMMERCE_TRAVEL_HOTEL
- COMMERCE_TRAVEL_OTHER
- GAME_STATE
- MEDIA_IMAGE
- MEDIA_MIXED
- MEDIA_MUSIC
- MEDIA_OTHER
- MEDIA_VIDEO
- OTHER
- TEXT_ARTICLE
- TEXT_BLOG
- TEXT_OTHER
- TEXT_RECIPE
- TEXT_REVIEW
- TEXT_SEARCH_RESULTS
- TEXT_STORY
- TEXT_TECHNICAL_DOC
- 标题:标题(用于单个内容项)。
- 描述:描述(针对单个内容项)。
- 图片网址:图片 URL(用于单个内容项)。
- Canonical Identifier: used to allow Branch to unify content/messages for Content Analytics.
Publicly Indexable: true - content can be seen by anyone, false - cannot index for public use. - 可本地索引:true-可以为本地(设备)使用编制索引内容,false-无法为本地使用编制索引。
- 价格:产品/内容的价格。
- 数量:要订购的商品数量(用于 PURCHASE,ADD_TO_CART 等)。
- SKU:产品 sku 或产品 ID。
- 产品名称:产品名称。
- 产品品牌:产品的品牌。
- 产品类别:产品的类别(如果适用)。以下之一:
- ANIMALS_AND_PET_SUPPLIES
- APPAREL_AND_ACCESSORIES
- ARTS_AND_ENTERTAINMENT
- BABY_AND_TODDLER
- BUSINESS_AND_INDUSTRIAL
- CAMERAS_AND_OPTICS ELECTRONICS
- FOOD_BEVERAGES_AND_TOBACCO
- 家具类
- HARDWARE
- HEALTH_AND_BEAUTY
- HOME_AND_GARDEN
- LUGGAGE_AND_BAGS
- MATURE
- MEDIA OFFICE_SUPPLIES
- RELIGIOUS_AND_CEREMONIAL
- SOFTWARE SPORTING_GOODS
- TOYS_AND_GAMES
- VEHICLES_AND_PARTS
- 产品变体:产品的变体(例如 XL,红色)。
- 平均评分:该项目的平均评分。
- 评分数:该项目的评分数。
- 最高评分:该项目的最高可能评分(例如,如果5星最高可能评分,则为5.0)。
- 创建时间戳:创建内容的时间。
- 截止日期:该内容不再有效的最后时间。 null/0 表示没有限制。应该很少设置。
- 条件:对于拍卖,该物品是否是新的,良好的,可以接受的,等等。其中之一:
- OTHER
- 新的
- 优秀的
- 好的
- 公平的
- 较差的
- 用过的
- 翻新的。
- 关键字:关键字。
- 图像标题:带有逗号分隔值的 string,与图像关联的标题。
- 纬度:餐馆,公司,房间(酒店)等的纬度。
- 经度:餐馆,公司,房间(酒店)等的经度。
- 邮政编码:餐厅,公司,房间(酒店)等的邮政编码。
- 国家/地区:饭店,公司,房间(酒店)等的国家/地区代码。
- 地区:餐厅,公司,客房(酒店)等的州或地区。
- 城市:餐厅,公司,房间(酒店)等的街道地址。
- 街道:餐厅,公司,房间(酒店)等的街道地址。
- 自定义字段:应用开发人员希望附加到内容项的 key-values pairs。
|
记录 Lifecycle Event
参数 | 描述 |
---|
用户数据 | 标识移动设备的属性。 - 操作系统版本:编号,操作系统的版本。特定于 Android 和 iOS。
- 环境:string,通常为 “FULL_APP”。
- 用户代理:string,事件发生的浏览器或应用的用户代理。
- HTTP Origin:string,Web SDK 记录的 Web 会话开始的当前页面 URL。
- HTTP Referrer:string,推荐 url,该推荐网址指向 Web SDK 登录的 Web 会话开始的当前页面。
- 本地 IP:string,设备的本地 IP(仅 Android)。
- 国家/地区:string,用户的国家/地区代码,通常基于设备设置或用户代理 string。
- 语言:string,用户的语言代码,通常基于设备设置或用户代理 string。
- 品牌:string,设备的品牌。
- 型号:string,设备型号。
- 应用版本:string,用户下载的应用版本。
- 屏幕 DPI:编号,屏幕的 DPI。
- 屏幕高度:数字,屏幕高度。
- 屏幕宽度:数字,屏幕宽度。
- 开发者身份:string,用户为开发者指定的身份。
- 设备指纹 ID:Branch 内部专用字段,用于追踪设备。
- 浏览器 Fingerpring ID:Branch 内部专用字段,用于追踪浏览器。
- 限制广告追踪:如果合作伙伴选择不被广告主追踪,则为 true。
|
事件数据 | 与事件类型相关的数据。 |
自定义数据 | 应用开发人员希望附加到事件的 key-values pair。 |
记录自定义事件
参数 | 描述 |
---|
用户数据 | 标识移动设备的属性。 - 操作系统版本:编号,操作系统的版本。特定于 Android 和 iOS。
- 环境:string,通常为 “FULL_APP”。
- 用户代理:string,事件发生的浏览器或应用的用户代理。
- HTTP Origin:string,Web SDK 记录的 Web 会话开始的当前页面 URL。
- HTTP Referrer:string,推荐 url,该推荐网址指向 Web SDK 登录的 Web 会话开始的当前页面。
- 本地 IP:string,设备的本地 IP(仅 Android)。
- 国家/地区:string,用户的国家/地区代码,通常基于设备设置或用户代理 string。
- 语言:string,用户的语言代码,通常基于设备设置或用户代理 string。
- 品牌:string,设备的品牌。
- 型号:string,设备型号。
- 应用版本:string,用户下载的应用版本。
- 屏幕 DPI:编号,屏幕的 DPI。
- 屏幕高度:数字,屏幕高度。
- 屏幕宽度:数字,屏幕宽度。
- 开发者身份:string,用户为开发者指定的身份。
- 设备指纹 ID:Branch 内部专用字段,用于追踪设备。
- 浏览器 Fingerpring ID:Branch 内部专用字段,用于追踪浏览器。
- 限制广告追踪:如果合作伙伴选择不被广告主追踪,则为 true。
|
自定义数据 | 应用开发人员希望附加到事件的 key-values pair。 |