Support Home > Campaign Management > Create a Roku Campaign

Create a Roku Campaign

Feature Summary: The following document describes how to set up a campaign for Roku. Kochava enhances your install and event data with the Roku ad impression or click metadata directly from Roku to allow for extremely accurate and complete data.

 

Data Needed Before Beginning Process:

  • Roku Channel ID

Create a Link for a Roku Install Campaign

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Links > Campaign Manager.
  4.  

     

  1. Click Add a Tracker or Select Segment Tools () > Add a Tracker.
    1. Select the Campaign.
    2. Select the Segment.

    NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document.

     

    Add a Tracker

  2. Enter the Tracker Name.
  3. NOTE: When a Tracker is created, Kochava automatically generates a name for the Tracker. We recommend that you replace the Tracker name at this point with a clear name of your choosing.

  4. Select Tracker Type > Acquisition. (default setting)
  5. Select Media Partner > Roku.
  6. Select Agency Partner. (optional)
  7. Enter the Destination URL.
  8. NOTE: The Destination URL is not relevant and should simply be your website.

  9. Enter a Deep Link. (optional)
  10. Enter any Custom Parameter(s). (optional)
  11. Check Hardcode Cost and enter the amount.
  12. Click Save. (If no further trackers need to be created)
  13. Click Save & Add Another Tracker. (If additional trackers need to be created)
  14. Click Save & Create Postback (to navigate directly to the Partner Configuration page).
  15.  

    Acquisition Tracker Settings
    A. Campaign and Segment selection/creation section.


Install Postback Configuration

  1. Select Apps & Assets > Partner Configuration.
  2.  

     

  1. Click Add a Configuration.
  2. Select Media Partner > Roku.
  3. Click Go.
  4.  

    Media Partner Select

     

  5. Select Install > Postback Tools () > Edit.
  6. Enter the Roku Channel ID.
  7. Enter the Roku Properties for the product.
  8. NOTE: Roku properties need to be comma separated.

  9. Select the Roku Event Name.
  10. Click Save.

 

Install Postback Settings


Reengagement Configuration

The information within this section provides the steps necessary to establish a reengagment campaign. If a reengagment campaign does not need to be created, the information in this section may be disregarded.

NOTE: If a reengagement campaign does not need to be set up, but the data associated with post-install events needs to be sent to Roku follow the steps within the Create a Postback Section below.

 

Create a Reengagement Segment:

  1. Locate the desired Campaign.
  2. Select Campaign Tools () > Add a Segment.
  3. Enter a Segment Name.
  4. Enter a Segment Description. (optional)
  5. Click Submit.

 

Create a Reengagement Tracker:

  1. Click Add a Tracker or Select Segment Tools () > Add a Tracker.
    1. Select the Campaign.
    2. Select the Segment.
  2. Enter a Tracker Name.
  3. Select Tracker Type > Reengagement.
  4. Select Media Partner > Roku.
  5. Select an Agency Partner. (optional)
  6. Select the Roku Event that will map to the selected Kochava event.
  7. Add Reengagement Event.
  8.  

    BEST PRACTICES: While multiple events can be added to the reengagement tracker it is highly recommended that only 1 event be added for each reengagmeent tracker.

     

    NOTE: A Reengagement event can be added by clicking on the “+” and removed by clicking “X“.

  9. Click Save (If no further trackers need to be created).
  10. Click Save & Add Another Tracker (If additional events need to be created).
  11. Click Save & Create Postback (to navigate directly to the Partner Configuration page).
  12.  

    Reengagement Tracker Settings

 

Post-Install Event Postback Configuration:

  1. Select Apps & Assets > Partner Configuration.
  2.  

     

  1. Select Roku> Network Tools () > Postbacks.
  2. Locate the desired event and Click Create for a new configuration or Edit for an existing configuration.
  3. Enter the Roku Channel ID.
  4. Enter the Roku Properties.
  5. Enter the Roku Event Name.
  6. Click Save.
  7.  

    Post Install Postback Settings


Standard Post-Install Event List:

 

KeyDescription
first_openFirst time the app is opened.
session_startApp Session (First time app session should be sent as First App Session)
trialA Trial is when a user successfully signs up for a given trial product through Roku Pay, regardless of future subscription or cancellation, based on a 24-hour lookback of exposure to a media campaign, where exposure is the later of either the last impression or last-click
sign_upCount of a “trial start” event and “subscription start (without trail)” event occurred on a date and time at account level for a given product. This include users who converted from trials, cancels the trial, and who directly paid for the subscription.
subscriptionA Subscription is when a user pays for a subscription on Roku Pay within a 24-hour lookback of exposure (impression or click) to a media campaign.
qssTrigger QSS on Video Views exceeding 5M of contiguous video playback time. A single video view of 60M, for example, will result in a single QSS event.
text_searchText Search Initiated
voice_searchVoice Search Initiated
video_streamVideo Playback Initiation (Request for Video Stream)
est_transactionEST Transaction (Entertainment Sell Thru) – a one time purchase
first_video_viewVideo View (First time video view will map to Roku FTV)
video_viewVideo Metadata (Detailed Content View – Content BOB Info in terms of – Network, Title, Genre, Type, Rating)
ad_initiatedCSAI or SSAI In-Stream Ad Initiated

Macros

 

View-Through Attribution Macros:

View-through attribution, also known as impression tracking, is the term used when an impression leads to a user action within a certain attribution window. The view-through attribution window is supported for 14-days in order to meet business needs.

 

URL
Parameters
DescriptionRequired/
Optional
Type
ProductProduct of impressionRequiredCase sensitive string
PropertiesProperties of impressionOptionalComma separated case sensitive strings
IPIP of impressions (IPv4 and IPv6 supported)Required for fingerprint attributionstring
UseragentUseragent of impressionOperational – Required for fingerprint attributionstring
DeviceIDsDevice Identifiers of Impression (rida,adid,idga,oaid, etc.)Required for device attributionKey value string pairs
TimestampUnix timestamp in secondsRequired for all attribution types.integer
CampaignIDCampaignID of ImpressionRequired for MMP responsestring
CreativeIDCreativeID of ImpressionRequired for MMP responsestring
LineItemIDLineItemID of the creative displayedRequired for MMP responsestring
ContentIDContent or Ad Unit ID displayedRequired for MMP responsestring
PlacementTypeInventory TypeRequired for MMP responsestring

Click-Through Attribution Macros:

Click-through attribution, also known as click tracking, is the term used when a click leads to a user action within a certain attribution window. The click-through attribution window is supported for 14-days to meet your business needs.

 

URL
Parameters
DescriptionRequired/
Optional
Type
ProductThe Advertiser’s Roku Channel IDRequiredCase sensitive string
PropertiesAdditional properties to be considered for that clickOptionalComma separated case sensitive strings
IPIP of click ( IPv4 and IPv6 supportedRequired for fingerprint attributionstring
UseragentBroken out into –
deviceModel
osName
osVersion
Operational – Required for fingerprint attributionIndividual strings
DeviceIDsDevice Identifiers of Impression (rida,adid,idga,oaid, etc.)Required for device attributionKey value string pairs
TimestampUnix timestamp in secondsRequired for all attribution types.integer
CampaignIDCampaignID of ClickRequired for MMP responsestring
CreativeIDCreativeID of ClickRequired for MMP responsestring
LineItemIDLineItemID of the creative being clickedRequired for MMP responsestring
ContentIDContent or Ad Unit ID being clicked.Required for MMP responsestring
AccountInventory TypeRequired for MMP responsestring

 
 

Last Modified: Jul 19, 2023 at 12:27 pm