YouTube Insights API Connector

YouTube is a video sharing service where users can create their own profile, upload videos, watch, like, and comment on other videos

  • Channel: Social
  • Data Stream Type: Social Objects
  • Data Lagging: 2 days

Prerequisites

  • In order to connect to YouTube Insights API, you need the valid username & password for the Google account that owns the Channel you want to retrieve data for and the permissions to view YouTube Analytics reports. The Channel you want to pull data for must contain videos.
  • After you connect to YouTube from the Marketing Cloud Intelligence platform, you’re required to choose a YouTube profile.
  • Channel and Videos are automatically populated depending on the profile you connect to.

General Setup

  • After entering your credentials, select the relevant Channel you want to retrieve data for.
  • Select the Videos you want to retrieve data for. If you want to retrieve data for all videos in the selected Channel, leave this field empty.

Extended Properties

  • Location Breakdown - Select one of the available options to add further breakdowns to the data retrieved by the API, resulting in a higher level of granularity on which the Measurements are sliced. The following Breakdowns are available when pulling data from the YouTube Insights API, in addition to the standard data being pulled:
    • Country - Select this to pull country data and add the Dimension ‘Country’ to the dataset.
  • Get Video Breakdown - This checkbox is selected by default to retrieve data aggregated at the video level, clear this checkbox to retrieve data aggregated at the channel level.

Known Issues

  • It's not possible to pull data for a YouTube Channel that the selected credentials don’t own (that is, it’s insufficient to simply have manager access + YouTube Analytics access to a channel)
  • If videos don't have enough traffic under a certain breakdown, such as country, they aren't pulled.

How to QA Your Data

  • Create the desired report in the YouTube platform for the required date range.
  • Next, process the relevant Data Stream in Marketing Cloud Intelligence for the same date range.
  • In Extended Properties, make sure you select the same report as the one you created on YouTube. Create a Report/Table Widget/Pivot Table within Marketing Cloud Intelligence containing the exact same Dimensions and Measurements for the same report and date range.
  • Compare the Measurement Totals and make sure they’re aligned.