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.  

     

  5. 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.

     

  6. Enter the Tracker Name.
  7. 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.

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

  13. Enter a Deep Link. (optional)
  14. Enter any Custom Parameter(s). (optional)
  15. Select the Pricing Type. (optional)
  16. Check Hardcode Cost and enter the amount.
  17. Click Save. (If no further trackers need to be created)
  18. Click Save & Add Another Tracker. (If additional trackers need to be created)
  19. Click Save & Create Postback (to navigate directly to the Partner Configuration page).
  20.  

    A. Campaign and Segment selection/creation section.


Install Postback Configuration

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

     

  3. Click Add a Configuration.
  4. Select Media Partner > Roku.
  5. Click Go.
  6.  

     

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

  11. Select the Roku Event Name.
  12. Select the Attribution Mode:
    1. Best Attribution Match (default setting)
    2. Click Through Attribution
    3. View Through Attribution
  13. Check Match by Device ID. (default setting)
  14. Check Match by Device Fingerprint. (optional)
  15. Check Match by Full IP. (optional)
  16. Check Match by Partial IP. (optional)
  17. Check Match by Properties. (optional)
  18. Click Save.

 


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.  

 

Post-install Event Postback Configuration:

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

     

  3. Select Roku> Network Tools () > Postbacks.
  4. Locate the desired event and Click Create for a new configuration or Edit for an existing configuration.
  5. Enter the Roku Channel ID.
  6. Enter the Roku Properties.
  7. Enter the Roku Event Name.
  8. Select the Attribution Mode:
    1. Best Match Attribution (default)
    2. Click Through Attribution
    3. View Through Attribution
  9. Check Match by Device ID. (default setting)
  10. Check Match by Device Fingerprint. (optional)
  11. Check Match by Full IP. (optional)
  12. Check Match by Partial IP. (optional)
  13. Check Match by Properties. (optional)
  14. Click Save.
  15.  


Standard Post-Install Event List:

 

Key Description
first_open First time the app is opened.
session_start App Session (First time app session should be sent as First App Session)
trial A 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_up Count 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.
subscription A 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.
qss Trigger 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_search Text Search Initiated
voice_search Voice Search Initiated
video_stream Video Playback Initiation (Request for Video Stream)
est_transaction EST Transaction (Entertainment Sell Thru) – a one time purchase
first_video_view Video View (First time video view will map to Roku FTV)
video_view Video Metadata (Detailed Content View – Content BOB Info in terms of – Network, Title, Genre, Type, Rating)
ad_initiated CSAI 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
Description Required/
Optional
Type
Product Product of impression Required Case sensitive string
Properties Properties of impression Optional Comma separated case sensitive strings
IP IP of impressions (IPv4 and IPv6 supported) Required for fingerprint attribution string
Useragent Useragent of impression Operational – Required for fingerprint attribution string
DeviceIDs Device Identifiers of IMpression (rida,adid,idga,oaid, etc.) Required for device attribution Key value string pairs
Timestamp Unix timestamp in seconds Required for all attribution types. integer
CampaignID CampaignID of Impression Required for MMP response string
CreativeID CreativeID of Impression Required for MMP response string
LineItemID LineItemID of the creative displayed Required for MMP response string
ContentID Content or Ad Unit ID displayed Required for MMP response string
PlacementType Inventory Type Required for MMP response string

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
Description Required/
Optional
Type
Product The Advertiser’s Roku Channel ID Required Case sensitive string
Properties Additional properties to be considered for that click Optional Comma separated case sensitive strings
IP IP of click ( IPv4 and IPv6 supported Required for fingerprint attribution string
Useragent Broken out into –
deviceModel
osName
osVersion
Operational – Required for fingerprint attribution Individual strings
DeviceIDs Device Identifiers of IMpression (rida,adid,idga,oaid, etc.) Required for device attribution Key value string pairs
Timestamp Unix timestamp in seconds Required for all attribution types. integer
CampaignID CampaignID of Click Required for MMP response string
CreativeID CreativeID of Click Required for MMP response string
LineItemID LineItemID of the creative being clicked Required for MMP response string
ContentID Content or Ad Unit ID being clicked. Required for MMP response string
PlacementType Inventory Type Required for MMP response string