- Print
- DarkLight
- PDF
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.
Field | Description |
---|---|
Organisation Id | A unique identifier for your media organization. Example: 4a7g0987-f4r4-6776-g987-6yu3141b9dd3 |
Work Space Id | Name of your media group with your unique ID: 4a7g0987-f4r4-6776-g987-6yu3141b9dd3 |
API keys | Add 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
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.
Event | Property | Sub-properties | Description |
---|---|---|---|
Pageview | geo_info |
| Country: India City: Delhi Continent: Asia Province: National Capital Territory of Delhi |
client |
| 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> | |
page | utmSource | UTM Source: Apple TV | |
isp_info |
| ISP: Shyam Spectra Pvt | |
PageviewComplete | aggregations | PageviewEngagement | Aggregation related to page view engagement: - completion: 0.0 - engaged_time: 5 |
isp_info |
| ISP: Shyam Spectra Pvt | |
page | utmSource | UTM Source: Apple TV | |
client |
| 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: India City: Delhi Continent: Asia Province: National Capital Territory of Delhi | |
Videoview | isp_info |
| ISP: Shyam Spectra Pvt Autonomous System Number: 10029 Autonomous System Organization: SHYAM SPECTRA PVT LTD Organization: Shyam Spectra Pvt |
video |
| Title:<Content Title> | |
client |
| 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: Delhi Continent: Asia Province: National Capital Territory of Delhi Country: India | |
local_time | - | Local Time: 2023-06-21T04:50:55Z | |
VideoCompletion | geo_info |
| Province: National Capital Territory of Delhi City: Delhi Continent: Asia Country: India |
isp_info |
| ISP: Shyam Spectra Pvt Autonomous System Organization: SHYAM SPECTRA PVT LTD Autonomous System Number: 10029 Organization: Shyam Spectra Pvt | |
video |
| Genre: News Content Type: Video Title: Heavy rainfall expected in the Northern belt of the country Runtime: 123.0 seconds | |
client |
| 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.