ViewLift + Permutive
  • 13 Jul 2023
  • 3 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

ViewLift + Permutive

  • Dark
    Light
  • PDF

Article summary

What is Permutive?

With Permutive, app publishers are able to create real-time cohorts across their smart ad server campaigns on multiple platforms and screens. In addition to cohort targeting, the Permutive platform also supports event collection which will collect valuable user engagement data for further cohort creation.

Events

An event is something that occurs and the property describes aspects of that occurrence. For example, when someone clicks on a player on a video page, the event being fired might be Videoview. However, that in itself might not be enough to create a rich cohort. Instead, properties and sub-properties are included in each event to break data down into more granular chunks. For example, the isp_info might be the name of the ISP, and isp_info.autonomous_system_organization might be the organization name of the ISP for that user. This allows for more nuanced cohort creation.

In this article, we will analyze the events we pass from connected TVs to the Permutive platform. Some of these events are automatically called by the SDK, while others are called by Permutive using ViewLift's app SDKs. The log events consist of page views, page view completions, video views, and video completions, collected from TV apps. ViewLift currently supports Permutive integration with Roku, Apple TV, Fire TV, and Samsung TV. To learn more, see the Permutive Events section below.

Configuring Permutive in ViewLift Tools Platform

To link your Permutive account to your Tools account, from the AppCMS module, go to Analytics --> Permutive Integration, and enable the Enable Permutive Integration feature flag. 

The code changes required to deploy Permutive can be referenced in your Permutive Deployment Documentation.

Input the following keys for your Permutive project in Tools.

FieldDescription
Organisation IdA unique identifier for your media organization. Example: 4a7g0987-f4r4-6776-g987-6yu3141b9dd3
Work Space IdName of your media group with your unique ID:  4a7g0987-f4r4-6776-g987-6yu3141b9dd3 
API keysAdd the API keys for the platforms you support (currently integration is compatible with only Tv apps).
Note
The device platform teams in ViewLift will be using these keys in various code snippets for deployment.

Permutive events 


Permutive Audience Events Dashboard

 

This table provides an overview of the properties and their corresponding sub-properties within the following events. Each property represents a specific aspect of the event, such as geographic information, client details, page-related data, and ISP information.

EventPropertySub-propertiesDescription
Pageviewgeo_info
  • country 
  • city
  • continent
  • province
Country: India
City: Delhi
Continent: Asia
Province: National Capital Territory of Delhi
client
  • type
  • user_agent
  • title
Type: tvos
User Agent:  indicates that the event was generated by your app, utilizing the Permutive framework on a device platform. It also includes the name and version of your app installed on the user's device. Lastly, it specifies the device and the operating system running. Example: User Agent: PermutiveiOS 1.6.0(23); PIX11+(1.3); Simulator tvOS; tvOS 16.0
Title:<Content Title>
pageutmSource
UTM Source: Apple TV
isp_info
  • isp
  • autonomous_system_number   
  • autonomous_system_organization    
  • organization

ISP: Shyam Spectra Pvt
Autonomous System Number: 10029
Autonomous System Organization: SHYAM SPECTRA PVT LTD
Organization: Shyam Spectra Pvt

PageviewComplete


aggregations 
PageviewEngagement    
Aggregation related to page view engagement:
- completion: 0.0 
- engaged_time: 5

isp_info


  • isp
  • autonomous_system_number   
  • autonomous_system_organization    
  • organization

ISP: Shyam Spectra Pvt
Autonomous System Number: 10029
Autonomous System Organization: SHYAM SPECTRA PVT LTD
Organization: Shyam Spectra Pvt

pageutmSource    
UTM Source: Apple TV
client
  • user_agent
  • title
  • type
User Agent: PermutiveiOS 1.6.0(23); PIX11+(1.3); Simulator tvOS; tvOS 16.0
Title: Heavy rainfall expected in the Northern belt of the country
Type: tvos
geo_info
  • country 
  • city
  • continent
  • province
Country: India
City: Delhi
Continent: Asia
Province: National Capital Territory of Delhi
Videoviewisp_info
  • isp
  • autonomous_system_number   
  • autonomous_system_organization    
  • organization

ISP: Shyam Spectra Pvt
Autonomous System Number: 10029
Autonomous System Organization: SHYAM SPECTRA PVT LTD
Organization: Shyam Spectra Pvt

video

  • title
  • content_type
  • genre
  • runtime

Title:<Content Title>
Content Type: Video
Genre: News
Runtime: 97.0 seconds 

client
  • type
  • user_agent
  • title
Type: tvos
User Agent:  indicates that the event was generated by your app, utilizing the Permutive framework on a device platform. It also includes the name and version of your app installed on the user's device. Lastly, it specifies the device and the operating system running. Example: User Agent: PermutiveiOS 1.6.0(23); PIX11+(1.3); Simulator tvOS; tvOS 16.0
Title:<Content Title>

geo_info

  • city    
  • continent 
  • province    
  • country    

City: Delhi
Continent: Asia 
Province: National Capital Territory of Delhi 
Country: India
local_time-Local Time: 2023-06-21T04:50:55Z
VideoCompletion

geo_info

  • province
  • city
  • continent
  • country

Province: National Capital Territory of Delhi
City: Delhi
Continent: Asia
Country: India

isp_info

  • isp 
  • autonomous_system_organization 
  • autonomous_system_number  
  • organization   

ISP: Shyam Spectra Pvt
Autonomous System Organization: SHYAM SPECTRA PVT LTD
Autonomous System Number: 10029
Organization: Shyam Spectra Pvt

video


  • genre
  • content_type
  • title
  • runtime
Genre: News
Content Type: Video
Title: Heavy rainfall expected in the Northern belt of the country
Runtime: 123.0 seconds
client
  • user_agent
  • type  
  • title
User Agent: PermutiveiOS 1.6.0(23); PIX11+(1.3); Simulator tvOS; tvOS 16.0
Type: tvos
Title: Heavy rainfall expected in the Northern belt of the country
local_time-Local Time: 2023-06-21T04:50:55Z

FAQs - Permutive

Q. Do any third parties have access to or use the data Permutive collects for each publisher?

Permutive process data for the app publishers. No third parties have access to the data unless you decide as a controller, to enable this. Permutive is CCPA and GDPR-compliant.


Was this article helpful?

What's Next