Youtube Raw Data - GetLinkfire/raw-data-documentation GitHub Wiki

Youtube Streaming Raw Data

In order to protect user privacy, Linkfire does not receive event-by-event data for YouTube Music, and only events that can be grouped together in more than 50 are made visible. As report format for this data differs from the traffic raw data we need to send it separately.

Data will be grouped by all categorical fields, and if the group does not reach the 50 threshold it will be anonymized by changing the values of the fields ActivityId, CountryCode and UserType to "_ROLLED_UP". Please note that the "_ROLLED_UP" group will contain the sum of all anonymized data, meaning that it can have more then 50 records.

Youtube treaming Raw Data will cover conversions that might be "Track Play" or "Track plays of 30+ seconds". For more details on our general documentation of YouTube Music data in linkfire can be found in our help center article.

Fields

Note - the fields we pass along are based on the ones we receive from YouTube. We do not remove any fields.

Data Description Example
ActivityId Activity ID (string) added by the marketer to the link. Max 50 characters. ADVERTISING, button, FB
BoardId UUID of the board the visited link is in. a1c50793-2c2a-4809-ae23-3204a4584cad
BoardName Title of the board My Board
ChannelCode Two letter code for the channel used FB, IG
ChannelId UUID of the marketing channel used by the marketer. d8b8bb4f-4c47-11e6-9fd0-066c3e7a8751
ChannelName The name of the marketing channel used by the marketer when promoting the link. Instagram, YouTube Description
ChannelType The category of the marketing channel used by the marketer when promoting the link. Owned, Paid, Original
Country Two letter code of visitor's country as decoded from IP using Maxmind GeoIP. DK
EventType The type of action that took place Track Play, Track plays of 30+ seconds
Timestamp The UTC date "2020-12-24"
LinkId UUID of the visited link. 13591d85-bd99-469a-812d-4088d6320a91
LinkScanningSource Depending on linkscanningtype, a URL,ISRC,UPC or bandsintown reference https://youtu.be/track
LinkScanningType The type of source used when creating the link. URL, UPC, ISRC
LinkTitle Title of the link "Check My New Song"
LinkUrl The URL of the link. artist.lnk.to/album
Count [metric] count of plays in AM 758
Artist Name Name of the Artist of the item played in AM "Elvis Presley"
UserType Description of the user’s plan type Free, Premium
TrackTitle Name of the Title played in YT "Thank u, next"
TrackISRC ISRC of the track played
AlbumTitle Name of the Album played in YT "Dark side of the moon"
AlbumUPC UPC of the album played
OrganisationId Id of the organisation