Available fields for Streaming Ads catalogs
Streaming Ads support the entertainment and media catalog type.
Tip: To help get started, you can use one of our Streaming Ads catalog templates:
Streaming Ads: Multi-Show Experience catalog templateStreaming Ads: Media Card catalog templateTikTok recommends using all fields to better match your product with a user's intent.
Important: All data in the catalog must be entered using unicode. Other text types are not supported and will cause errors.
Field names and their use cases
Multi-Show Experience template
Field | Is required? | Description |
media_id | Required | Unique ID that corresponds with the promoted title on your website. If you're passing back the content_id parameter (as recommended), this field should be the content_id parameter value that corresponds with each title. If you're not passing back content_id, this value simply needs to be a unique identifier associated with each title. All media_id values must be unique in the catalog. Max characters: 100 |
title | Required | Name of the media title that appears on each video tile. Max characters: 150 (<20 strongly recommended as titles over 20 will be cut off.) |
image_link | Required | Link to tile thumbnail image that shows in the Multi-Show Experience grid view prior to video playback. Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx and must be a direct link to download the image file, not a link to a media player such as YouTube. Test the link in your browser to make sure it prompts an image file download.
Images must be 2:3 aspect ratio and 720x960px or larger in size. |
video_link | Required | Link to the video asset file that plays within a given title's video tile in the Multi-Show Experience grid view. Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx and must be a direct link to download the video file, not a link to a video player such as YouTube. Test the link in your browser to make sure it prompts a video file download. |
link | Required | Landing page URL where Multi-Show Experience tiles drive traffic when clicked on. Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx. |
qid | Required | IMDb ID of the promoted media title. Typically, in the format of "tt" followed by 7 digits. Max characters: 150 |
price | Optional | The price of the media subscription Note: Format price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency. Currency must match the catalog's default currency. |
description | Optional | Brief description of the media title. Max characters: 20,000 |
Media Card template
Field | Is required? | Description |
media_id | Required | Unique ID that corresponds with the promoted title on your website. If you're passing back the content_id parameter (as recommended), this field should be the content_id parameter value that corresponds with each title. If you're not passing back content_id, this value simply needs to be a unique identifier associated with each title. All media_id values must be unique in the catalog. Max characters: 100 |
title | Required | Title (name of the streaming library title that populates on each Media Card). Max characters: 150 (<35 strongly recommended as titles above 35 will be cut off). |
image_link | Required | Poster image associated with title (primary Media Card creative asset) Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx and must be a direct link to download the image file, not a link to a media player such as YouTube. Test the link in your browser to make sure it prompts an image file download. |
qid | Required | IMDb ID of the promoted media title. Typically, in the format of "tt" followed by 7 digits. Used to retrieve IMDb ratings info and help backend model learnings. Max characters: 150 |
link | Required | Landing page URL where Media Card drives traffic when clicked on. Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx |
genres | Optional | Genre(s) of streaming titles may optionally be displayed on Media Cards. Note: Must come from the list outlined in the Example column. Up to five of these genres may be selected per title if they are separated by a comma. |
custom_label_0 | Optional | Customizable Label 1 – optionally shown on Media Card |
custom_label_1 | Optional | Customizable Label 2 – optionally shown on Media Card |
custom_label_2 | Optional | Customizable Label 3 – optionally shown on Media Card |
custom_label_3 | Optional | Customizable Label 4 – optionally shown on Media Card |
custom_label_4 | Optional | Customizable Label 5 – optionally shown on Media Card |
price | Optional | The price of the media subscription Note: Format price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency. Currency must match the catalog's default currency. |
description | Optional | Brief description of the media title Max characters: 20,000 |
video_link | Optional | Optional field for pairing specific in-feed video assets (9x16 aspect ratio) with certain Media Card titles. When configured, the video link populated in this field will play behind the Media Card configured in the same catalog row. You can use this field while also toggling on Use catalog creative at the ad level to activate Media Cards via the Catalog Video format. Note: Link URL should be formatted as x://xxx.xxx/xxx?xxx=xxx and must be a direct link to download the video file, not a link to a video player such as YouTube. Test the link in your browser to make sure it prompts a video file download. |
Note: Although custom labels have a max character limit of 150, they will be cut off at different character lengths on Media Card, depending on which card label position (primary or secondary) the catalog field is assigned to in the ad level card editor.
Primary Label: 24 character cutoff
Secondary Label: 22 character cutoff
