--- title: "ViewLift + Permutive integration | ViewLift Knowledge Base" slug: "viewlift-permutive" description: "In this article, you will learn how to integrate Permutive with ViewLift and also learn about the events and properties that you can track in the Permutive dashboard. " updated: 2023-07-13T09:38:20Z published: 2023-07-13T09:38:20Z canonical: "docs.viewlift.com/viewlift-permutive" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.viewlift.com/llms.txt > Use this file to discover all available pages before exploring further. # ViewLift + Permutive ## 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. ![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1689185864461.png) 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).NoteThe device platform teams in ViewLift will be using these keys in various code snippets for deployment. | ## Permutive events ![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1689226193188.png)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. | **Event** | Property | **Sub-properties** | **Description** | | --- | --- | --- | --- | | **Pageview** | geo_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**: | | page | utmSource | **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 | | page | utmSource | **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 | | **Videoview** | 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 | | video | - title - content_type - genre - runtime | **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**: | | 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 | **G****enre**: 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.