YouTube

​

YouTube

DirectionDestination

Environment

WebiOSAndroidCTV

Capability

Cohort Activation

SDK RequiredYes

Product(s) RequiredCore Platform

YouTube is the world’s largest video platform, enabling content creators and advertisers to reach global audiences.

​

Overview

• Destination: Permutive cohorts are passed to YouTube IFrame Player ad requests as key-value parameters for real-time targeting.

• Target video ads in embedded YouTube players with Permutive cohorts
• Deliver personalized video advertising based on user behavior and interests
• Optimize video ad inventory monetization with audience targeting
• Enable real-time cohort activation for pre-roll, mid-roll, and post-roll video ads

​

Environment Compatibility

​

Prerequisites

• Google Ad Manager Integration: The GAM integration must be enabled in Permutive before setting up YouTube targeting.
• Permutive SDK: The Permutive SDK must be installed on your website or app where the YouTube player is embedded.
• Cohorts with GAM Activation: Cohorts must have GAM Activation Sync enabled in the Permutive dashboard.
• YouTube IFrame API (Web): You must be using the YouTube IFrame Player API to embed videos.
• Access to Player Configuration: You need the ability to modify your YouTube player configuration code to pass custom parameters.

​

Setup

var cohortIds;
try {
  cohortIds = JSON.parse(window.localStorage._pdfps || '[]')
    .slice(0, 250)
    .toString();
} catch (e) {
  cohortIds = '';
}

var player;
function onYouTubeIframeAPIReady() {
  // Retrieve cohort IDs
  var cohortIds;
  try {
    cohortIds = JSON.parse(window.localStorage._pdfps || '[]')
      .slice(0, 250)
      .toString();
  } catch (e) {
    cohortIds = '';
  }

  // Initialize player with cohort targeting
  player = new YT.Player('player', {
    height: '390',
    width: '640',
    videoId: 'YOUR_VIDEO_ID',
    events: {
      'onReady': onPlayerReady,
      'onStateChange': onPlayerStateChange
    },
    embedConfig: {
      adsConfig: {
        adTagParameters: {
          cust_params: encodeURIComponent('permutive=' + cohortIds)
        }
      }
    }
  });
}

​

Data Types

​

Troubleshooting

window.permutive = window.permutive || [];
window.permutive.push(['ready', function() {
  // Initialize YouTube player here
  onYouTubeIframeAPIReady();
}]);

​

Changelog