Information

URL Name	product-catalog-specs

Title	Product Catalog Field List

Article Details

Article

Product Catalog Field List

Required Product Metadata

Attribute	Type	Description	Dynamic Ad Specifications
id	Unique alphanumeric string Max 128 characters Must be unique across catalog	Customer's product identifier	Must match the item_ids passed back in the pixel for Dynamic Ads Retargeting
title	String Max 375 characters	Description of the product	Title and Price can be pulled onto the ad. Title can be up to three lines on the ad. We recommend that the title be no more than ~40 characters to ensure it is not truncated on the ad
description	String Max 5000 characters	US
link	String Max Character Limit: 2,000	Link to the product page http or https Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C"	If both link and mobile_link are present, mobile_link will be used in ad
image_link	String	Link to an image of the product http or https Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C" Images must be either WebP, jpeg or png. GIFs are not supported by the platform Images width >= 200px Image height >= 200px
availability	String Supported values: In stock Out of stock Preorder Discontinued Available for order	Availability of the product	Out of Stock ads will be auto excluded
price	String Expected Format: 199 USD. USD 199 also accepted Price cannot be null Price can be zero 0.00 Currency may be provided if not USD	Price of the product	Title and Price will be pulled into the ad by default. Please provide currency in this field if not USD.
brand, gtin, or mpn	String Brand: Max 70 characters gtin: Max 70 alphanumeric characters mpn: Max 50 numeric characters Only one of the following - brand, gtin or mpn - are required Spaces, dashes accepted, but ignored	gtin - Global Trade Item Number (GTINs) can include UPC, EAN, JAN, and ISBN. mpn - Unique manufacturer ID for product brand - Name of the brand Global Trade ID number UPC (in North America / GTIN-12) 12-digit number like 323456789012 8-digit UPC-E codes should be converted to 12-digit codes EAN (in Europe / GTIN-13) 13-digit number like 3001234567892 JAN (in Japan / GTIN-13) 8 or 13-digit number like 49123456 or 4901234567894 ISBN (for books) 10 or 13-digit numbers like 1455582344 or 978-1455582341. If you have both, only include the 13-digit number. ISBN-10 are deprecated and should be converted to ISBN-13 ITF-14 (for multipacks / GTIN-14) 14-digit number like 10856435001702 Manufacturer Part Number Max 50 numeric characters

Required App Product Metadata (Deep Link and App Install)

Attribute	Type	Description	Dynamic Ad Specifications
icon_media_url	String Max Character Limit: 2,000	URL of the icon for the app. Image must be < 5MB	Required for Dynamic App Install and Dynamic Deep Link campaigns
ios_app_name	String Max Character Limit: 255	Name of app to display	Required for Dynamic App Install and Dynamic Deep Link campaigns
ios_app_store_id	String Max Character Limit: 128	App ID for App Store. Required for App Install & Deep Link creative	Required for Dynamic App Install and Dynamic Deep Link campaigns
ios_url	String Max Character Limit: 2,000	Deep Link URI to product. Required for Deep Link creatives.	Required for Dynamic App Install and Dynamic Deep Link campaigns
android_app_name	String Max Character Limit: 255	Name of app for display	Required for Dynamic App Install and Dynamic Deep Link campaigns
android_package	String Max Character Limit: 128	Fully qualified package name for intent generation. Required for Deep Link and App Install creatives	Required for Dynamic App Install and Dynamic Deep Link campaigns
android_url	String Max Character Limit: 2,000	Custom scheme for Android app as URL. Deep Link URI to product. Required for Deep Link creatives.	Required for Dynamic App Install and Dynamic Deep Link campaigns
mobile_link	String Max Character Limit: 2,000	Product’s mobile-optimized landing page http or https	If mobile_link is present, Web ad will use mobile_link as web clicks vs. link. Dynamic Ads Deep Link campaigns will always fall back to the app store in the absence of the app.

Optional Product Metadata

Attribute	Type	Description	Dynamic Ad Specifications
age_group	String Supported values: Newborn Infant Toddler Kids Adult	Product's targeted age group
color	String	Color of the product
material	String * Can include up to 3 values delimited by '/' Max character limit: 200	main fabric or material of the product
pattern	String * Max character limit: 100	pattern of the product
condition	String New: brand new, original, unopened packaging Refurbished: professionally restored to working order, comes with a warranty, may or may not have the original packaging Used: previously used, original packaging opened or missing	The condition of your product at time of sale
gender	String Supported values Male Female Unisex		Product's targeted gender
item_group_id	String	Id of products that come in different sizes/materials	If matching on item_group_id (as opposed to item_ids for Dynamic Ads Retargeting) this value must match the item_category passed back in the pixel
google_product_category	String Max character limit: 250	Product category based on the Google product taxonomy	Best Practice: GPC coverage: We recommend providing GPC for every product in your catalog. We use GPC to inform our ranking models, which helps us show the right products to the right users. GPC depth: We recommend that the GPC be at least a depth of 3. For example, rather than: “Apparel & Accessories > Clothing” (depth: 2) Use: “Apparel & Accessories > Clothing > Activewear” (depth: 3)
product_type	String Max character limit:750 Max count of unique product types:10	Product category that you define for your product
adult	String Supported values: Yes No	Whether product contains adult content
custom_label_0	String Max Character Limit: 100	Additional information about item	More than ~40 characters may be truncated on the ad.
custom_label_1	String Max Character Limit:100	Additional information about item	More than ~40 characters may be truncated on the ad.
custom_label_2	String Max Character Limit: 100	Additional information about item	More than ~40 characters may be truncated on the ad.
custom_label_3	String Max Character Limit: 100	Additional information about item	More than ~40 characters may be truncated on the ad.
custom_label_4	String Max Character Limit: 100	Additional information about item	More than ~40 characters may be truncated on the ad.
size	String Max Character Limit: 100	Product's size
display_size	String Max character limit: 100	Use if the product’s standardized size attribute doesn't match the size string shown to shoppers on the product details page.
size_system	String Supported values: AU, BR, CN, DE, EU, FR, IT, JP, MEX, UK, US	The country of the sizing system your product uses.
size_type	String Limit: can include up to 2 values Supported values: regular, petite, plus, tall, big, maternity	The cut of your product.
additional_image_link	String Max Character Limit: 2000	Additional URL link to an image of the product	Add up to 20 additional images.
image[].url	comma-separated list of image URLs	For each product, additional image URLs can be provided as URLs provided in separate columns where the header is: image[0].url, image[1].url, ...	Add up to 20 additional images.
sale_price	String Expected Format: 199 USD. USD 199 also accepted Price cannot be null Price can be zero 0.00 Currency may be provided in a separate column	Price of product on sale
sale_price_effective_date	String Format: Date range (use ISO 8601 standard). Submit a start date and an end date separated by slash ( / ) e.g., 2016-02-24T13:00-0800/2016-02-29T15:30-0800	Date range when sale_price becomes effective
address	String Format: Latitude and Longitude Coordinates Value:{"latitude":"39.1722629", "longitude":"-119.748689"} Please Note: Requires inclusion of availability_radius	Latitude and Longitude Coordinates indicating where product is available	Please reach out to your Snapchat representative for more information on dynamic location targeting
availability_radius	Integer Format: Distance Unit (in km) Value (example): 9.2	Radius around Latitude and Longitude Coordinates in which product is available	Please reach out to your Snapchat representative for more information on dynamic location targeting
offer_details	String, Max character limit: 10,000	This field allows advertisers with special requirements to include a text outlining any terms and conditions associated with their Ad. This field only accepts texts, links in the text will not be clickable.	This field is required if the advertiser wants to fetch their Offer details text out of a catalog.

Set up Offer Details and Disclaimers for DPA Campaigns

For DPA campaigns, please notify your account team that you’d like to utilize Offer Details, and Snap will make sure to provide you appropriate access. Once enabled, you can update your catalog and provide a new field called “offer_Details”. At this time we support 10,000 characters per ad and text only fields. Once you update your catalog, and all offer details are correctly populated, you must create a new campaign, then select “Add Offer Details” in Ads Manager. If created on API: pass offer details text via offer_disclaimer attribute on CreativeV2.