Roku

Connect Branch and Roku to unlock a more holistic picture of the customer journey for your app on OTT/CTV.

800800

概述

Roku Ad Manager
Roku's Self-Attributing Ad Network, provides access for its third-party Measurement Partners to request attribution for install and event attribution for clients utilizing Roku’s Endemic(i.e. streaming) Media to help drive distribution and re-engagement of their apps. Similar to other Self-Attributing Networks (SANs), Roku will be able to receive conversion events tracked via Branch SDK and use it for performance optimization, audience segmenting, and re-targeting.

Roku OneView
Roku's non Self-Attributing Ad Network(non-SAN) is for all other Roku media advertising. We have a separate guide to setup Oneview here. OneView was formerly known as DataXu before Roku purchased them in 2019 and renamed it.

📘

Roku Data Sharing

Roku last-attributed data will be wiped at the log-level (via Custom Exports and Daily Exports) and this data will appear as null/blank in exports but you can still export it via aggregated data (Aggregate API or Query API)

Feature Support

功能

细节

Supported?

Engagement and Install Ads

Understand which ad impressions and clicks drove installs.
Attribution Match Methods:

  • Advertising ID
  • Fingerprint
  • Full IP
  • Partial IP
  • 属性

:白色复选标记:

Pre-Install Tracking

Measure app installs from apps packaged with your partner platforms

:白色复选标记:

Session Counts

Measure daily installs, opens, and session length

:白色复选标记:

Conversion Events

Attribute subscription events, logins, views, opens, etc. back to the last ad seen or Branch Link clicked

:白色复选标记:

Partner Events

Forward activity from partners directly to Branch

:白色复选标记:

深度链接 API

Route users directly to content in your app from the Roku Ad

:X:

App-to-App Activity

Measure user journeys to and from your various OTT apps

:X:

Supported Attribution Methods

Attribution Method

它是如何工作的?

12821282
  1. You, as an advertiser, serve an ad for your streaming media app on a CTV platform (ex. Roku, FireTV, Samsung, etc).
  2. User downloads your streaming media app on their CTV device.
    • Your streaming media app will have the Branch SDK installed.
  3. Branch connects with the Ad Partner and attributes the install & downstream streaming media app events to them.

先决条件

In order to enable Roku, you need to have completed the following:

  1. Created a Branch Dashboard.
  2. Enabled Universal Ads for your Branch account.
  3. Implemented the Branch SDK into your OTT/CTV app:
  4. Admin access to your Roku Account.

启用 Roku

1. Set up Roku Exposure Pixel & Channel ID

If you have a Roku Account Manager, send a request to them to set up the Roku Exposure Pixel on all of your eligible Roku display and video media. This ensures that all impressions and clicks are properly being attributed.

They will also be able to provide you with your Channel ID from your channel's properties. (Channel ID will be used later)

If you do not have a Roku Account Manager, you need to select Branch as the approved measurement provider when are uploading a creative:

22502250

Afterward, you can locate your Channel ID by searching by channel name and it will populate including the 6-digit ID:

14321432

2. Connect Roku in Branch

In the Branch Dashboard in Ads → Partner Management page, find and search for Roku. If you're already logged into the Branch Dashboard, you can also click here to go there directly.

设置

描述

Roku Channel ID

Obtained from your channel properties.

Attribution Mode

Choose attribution based on clicks, impressions, or considering both equally (Best Match Attribution)

  • Best Match Attribution: Find the best match treating impressions and clicks equally
  • Click-through only: Only match to clicks
  • View-through only: Only match to impressions

Match By

Attribution methods to be considered for attribution

属性

Key/value pairs to be used for advanced attribution methods

23782378

Click Save

3. Configure Events

After authenticating your Roku account to Branch, navigate to the Events Config tab to configure your events.

It's important to add your event mappings here for Branch to properly send event metadata to Roku for attribution. You should see the events you are tracking with the Branch SDK here when you Add Event Mappings.

👍

Events from mParticle or Segment

If you are using mParticle or Segment to track events, you can import them through Branch's integration. View the guides below to enable event importing:

14431443

More details on the Roku event mapping can be found here.

4. Configure Attribution Windows

After configuring your events, navigate to the Attribution Windows tab to set windows by attribution type.

You have full freedom to choose your attribution windows; however, it may cause discrepancies between the Branch and Roku when comparing.

Recommended Attribution Windows:

Attribution Type

Window

click to session start

1 day

click to install

7 days

click to conversion event

1 day

impression to session start

1 day

impression to install

1 day

impression to conversion event

1 day

Roku 和 Branch 之间的数据映射

Branch 将以下数据字段从 Roku 映射到 Branch。

Roku 数据

Branch 数据

可能的值

触控类型

last_attributed_touch_type

点击或展示

Campaign ID

last_attributed_touch_data_tilde_campaign_id

您的 Roku 广告活动的 ID

广告素材 ID

last_attributed_touch_data_tilde_creative_id

您的 Roku 广告素材的 ID

订单项 ID

last_attributed_touch_data_tilde_ad_set_id

Roku 订单项的 ID

内容 ID

last_attributed_touch_data_tilde_content_id

Roku 内容的 ID

放置类型

last_attributed_touch_data_tilde_placement

“我的渠道“或是”屏幕保护“

timestamp

last_attributed_touch_timestamp

广告展示或点击的时间戳

将事件转发到 Roku

一旦您开始通过 Branch SDK 追踪事件,我们将开始将其发送到 Roku。Roku 具有映射到预定义 Branch 事件的预定义事件,如下所示。

Branch 会将应用内事件转发给 Roku 进行广告活动优化。此外,Branch 将在 Branch 操作后台 (Dashboard)中接收归因数据以进行丰富的分析。

Branch Event Name

Roku Event Name

描述

INSTALL

first_open

首次打开应用(首次打开应用将映射到 Roku 安装)

OPEN

session_start

应用会话(首次应用会话应作为“第一应用会话”发送)

START_TRIAL

trial

设备启动了应用的试用期

COMPLETE_REGISTRATION

sign_up

设备已注册产品或服务

SUBSCRIBE

subscription

正在进行的事件,表明设备的订阅状态

COMPLETE_STREAM

qss

(“Qualified Streaming Session”)在连续视频播放时间超过5M的视频视图上触发 QSS。例如,单个视频观看60M,将导致单个 QSS 事件。

FQSS (custom event)

FQSS

该应用的第一个 QSS。

SEARCH

text_search

已启动文本搜索

voice_search (custom event)

voice_search

语音搜索已启动

INITIATE_STREAM

video_stream

视频播放启动(请求视频流)

PURCHASE

est_transaction

EST 交易(娱乐销售)-一次性购买

first_video_view (custom event)

first_video_view

视频视图(首次视频视图将映射到 Roku FTV)

VIEW_ITEM

video_view

视频 metadata(详细的内容视图-内容 BOB 信息,包括-网络,标题,流派,类型,等级)

VIEW_AD

ad_initiated

CSAI 或 SSAI 插播广告已启动