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 |