Skip to main content
Roku

Consent management for Roku channels

SceneGraph · BrightScript · Roku OS 10.0+

Secure Privacy's Roku SDK is a SceneGraph component you copy into your channel. Check the viewer's consent status, show the banner or the preference center from your scene, and read the stored consent records through the TV Consent API. It needs Roku OS 10.0 or later and one manifest setting, rsg_version=1.2.

SceneGraph SDK
Roku OS 10.0+
Banner + preference center
Consent records via API
Essential services supported
Roku logo on a Secure Privacy shield
0+

Roku OS minimum

0

Consent states tracked

0

Folders to copy

0

Manifest setting needed

Why Secure Privacy

Consent that runs
inside your channel

Roku's Data Processing Policy requires channel publishers to obtain the consents the law requires. The SDK gives your channel the screens, the saved choice and the records.

Native SDK

  • SPConsentEngine node added to your Scene or Group

  • Works in SceneGraph channels on Roku OS 10.0+

  • No package manager: copy three folders

  • No extra permissions, bs_libs entries or entitlements

What your viewers see

  • Banner with accept, deny and customize

  • Preference center listing frameworks and services

  • Essential services that viewers cannot deny

  • Privacy policy tab in the preferences screen

What you can prove

  • Status: pending, collected or recollection required

  • Recollection reason: expired or structure changed

  • Last consent time through getLastConsentedAt

  • Server-side records through the TV Consent API

Roku SDK features

Everything You Need forConsent on Roku

Each feature below maps to a call or screen in the Roku SDK documentation, so your engineers can see exactly what they are adding.

Consent status check

Ask the engine whether consent is pending, collected or needs recollecting before your channel loads ads or analytics.

  • getConsentStatus returns PENDING, COLLECTED or RECOLLECTION_REQUIRED
  • Compare against SPConsentStatus() instead of raw strings
  • A result code of 200 means the status is valid

Consent banner

Show the banner from your scene with one action when consent is needed.

  • Accept, deny or customize
  • Optional secondary banner with a second application ID
  • PNG or JPG logo, configured in the platform (SVG is not supported)

Preference center

Let viewers review and change their choices service by service.

  • Frameworks and their services are listed
  • Enable or disable consent per service
  • Open it directly with showPreferenceCenter

Re-consent handling

Know when a saved choice no longer applies, and why.

  • EXPIRED when consent has lapsed
  • STRUCTURE_CHANGED when your packages or services change
  • getConsentRecollectionReason tells you which

Package-level checks

Gate one ad partner or analytics tool on its own consent package.

  • getPackage returns packageId, name and isEnabled
  • Start or stop each SDK from the viewer's choice

Consent events

React to the viewer's choice the moment it happens.

  • Observe the consentEvent field
  • Events for accept, decline, customize, save and cancel
  • Unobserve when you no longer need updates

Data requests

Give viewers a way to ask about their data from inside the channel.

  • Request Data section in the SDK screens
  • Viewers submit a request through a form

Consent records API

Read stored consent for audits and reconciliation.

  • GET /api/tvconsents for Roku TV, tvOS and Android TV apps
  • Filter by date, status, country and consent ID
  • Up to 1,000 records per page

Session control and debugging

Reset cleanly on logout and see what the SDK is doing during development.

  • clearSession wipes persisted SDK state and in-memory caches
  • Re-run init before the next SDK call
  • debugEnabled turns on error, info and warning logs
Installation Guide

Add the SDK to your Roku channel

Follow the Roku SDK guide: copy three folders, set one manifest line, initialise SPConsentEngine with your Application ID, then check status and show the banner.

01

Get your Application ID

In cmp.secureprivacy.ai open TV apps, select your app and copy Your Application ID from the Installation tab.

02

Download and copy the SDK

Unzip the latest SPRokuConsent package, then copy source/securePrivacy/, components/securePrivacy/ and the sp_* images into your channel. Keep the paths as they are.

03

Set the manifest

Add rsg_version=1.2. No other permissions, bs_libs entries or entitlements are needed.

04

Initialise the engine

Create an SPConsentEngine node, append it to a Scene or Group, observe initResult and send the init action with your Application ID. A result code of 200 means the SDK is ready.

Your channel now asks for consent.
Global Compliance, Built In

Instant Access to 55+ Legal Templates Worldwide

Automatically adapt legal templates and consent banners by location — compliant by default, seamless for users.

Privacy Laws Mapped & Monitored

Countries Covered

Continuously Updated Regulations

Core Global Privacy Frameworks

Why Choose Secure Privacy

Secure Privacy SDK vs building it yourself

FeatureSecure Privacy SDKBuild in-house
Banner and preference centerIncluded in the SDKDesign, build and test on the remote
Consent statesPending, collected, recollection requiredYour own logic
Re-consent triggersExpiry and service changes detectedYour own tracking
Data requestsRequest Data form in the SDKSeparate build
Consent recordsStored server-side, queryable through the TV Consent APIYour own storage and API
MaintenanceSDK updates from Secure PrivacyYours to maintain
Same platform as your tvOS and Android TV apps
TV and app stack

Part of the Secure Privacy TV family

0+ native integrations and growing

Can't find your platform?Request an integration →
Transparent Pricing

TV apps are priced per app

Secure Privacy lists its TV plans per app, per month, so you can see the price before you talk to anyone.

Resources

Everything You Need to Ship on Roku

Roku TV consent management guide

How Roku's rules, signals and kids flags fit into your consent flow.

Learn more
Frequently Asked Questions

Frequently Asked Questions

Yes. The Roku SDK is a SceneGraph component, SPConsentEngine, that you copy into your channel. It shows the banner and preference center and returns the viewer's consent status.

GET STARTED IN MINUTES

Ready to add consent to your Roku channel?

Copy the SDK, initialise it with your Application ID and show the banner on first launch.

Free trial
Per-app pricing
Docs and support