Field and Format

Requirements

item_group_id

ID representing a group of products available in different versions (variants)

Priority: Required

Limit: 50
Type: String
Case sensitive: No, the value “ABCD” would be considered the same as “abcd”.
Characters Requirements: The item_group_id can only contain ASCII characters, and must not contain quotation marks.

Sample Value:
- Text feed (CSV/TSV): Ab1234
- XML feed: <g:item_group_id>Ab1234</g:item_group_id>

Use the same value for the item_group_id field to group all product variants. Product variants are similar products that differ from each other only in product details (sizes, color, material, pattern, age range, or gender).
This relationship establishes that the products with the same item_group_id are variants (or child) of the parent product (item_group_id).
By using this field to group the products, you remove the risk of displaying duplicated products within the same banner.
The id and item_group_id fields must be different, use the id field to uniquely identify a single product and use itemGroupId to group multiple products as variants.
Don't mix up item_group_id and id fields, The item_group_id must be chosen outside of the id range. If a product has the same id as an existing item_group_id or vice versa, the behavior is undefined and the updates on your products may be ignored.
Example: 3 product variants linked by the same item_group_id:
- ids: 001, 002, 003
- prices: 600, 700, 800
- item_group_id: ABC

condition

The product’s condition

Priority: Optional

Limit: 25
Type: String
Sample Value: new

The product's condition (e.g., new, refurbished, used). Local translations are also acceptable. Consider enabling automatic item updates to prevent condition mismatches.
Only 3 supported values new, refurbished, and used.

adult

Priority: Optional

Limit: 5
Type: Boolean
Sample Value: false

The adult attribute indicates if the product is safe to be shown for all users and all audiences. Adult products can’t be shown in Criteo banners and might lead to your campaign being blocked by publisher networks. You can also use this field with the value "true" if you want this product to be non-recommendable and not displayed in the banners.
Only 2 values are supported: true, false.

multipack

Priority: Optional

Limit: 25
Type: Number
Sample Value: 3

The quantity of identical products sold as part of the same item.
If the product is a single multipack packaged by the manufacturer, avoid using the multipack attribute. Instead, use the unit_pricing_measure field to specify the number of units.

is_bundle

Priority: Optional

Limit: 5
Type: boolean
Sample Value: true

Indicates if the product is a bundle of multiple items.
Only 4 values are supported: yes, true, no, false.

age_group

Priority: Optional

Limit: 25
Type: String
Sample Value: Adult

Specification:

Indicates the age group targeted for your product, this field helps standardize the sizes displayed to users.

Character Requirements: Only 5 values are accepted: newborn, infant, toddler, kids, adult
Limit: 25
Type: String

color

Priority: Optional

Limit: 100
Type: String
Sample Value: Blue

Represents the dominant color(s) of the product
Include standard color names

gender

Priority: Optional

Limit: 25
Type: String
Sample Value: female

Represents the product's intended gender, this field helps standardize the sizes displayed to users.
Only 3 values are accepted: male, female, unisex

material

Priority: Optional

Limit: 200
Type: String
Sample Value: Mesh, Rubber

The material(s) used in the product, this information helps create accurate filters.
Include up to 3 materials

pattern

Priority: Optional

Limit: 100
Type: String
Sample Value: Solid

The pattern or design of the product, this information helps create accurate filters.
Choose a value that users will easily understand.

size
Priority: Optional

Limit: 100
Type: String
Sample Value: XL

Use the size parameter to describe the standardized size of your product.
Submit only one attribute per product
Provide more size details using the other size fields: size_type, size_system

size_type
Priority: Optional

Limit: 100
Type: String
Sample Value: regular

The type of the size, this information helps create accurate filters.
Only 6 values are accepted: regular, petite, plus, big, tall, maternity

size_system
Priority: Optional

Limit: 100
Type: String
Sample Value: US

The country’s sizing system the product uses, this information helps create accurate filters.
Only these values are accepted: AU, BR, CN, DE, EU, FR, IT, JP, MEX, UK, US

filters
Priority: Optional

Limit: 2000
Type: String
Sample Value: 'Color=Red|Black, Size=S|M|L|XL, Screen size=21'

Attributes that designate differences between products in the same category. This feature allows Criteo to return relevant products on filtered pages.
Comma-separated.
Pipe | must be used as an “or” separator for multiple filter values.
Ensure that there are no ampersand characters (&) in the filter names or values as this will break the URL parsing when included in an ad request.

product_rating
The product’s rating

Priority: Optional

Limit: 8
Type: String
Character Requirements: Must start with a number or a letter.
Sample Value: 1, 2, 3.50, 4, 4.92, or 5.

Product Rating enables the display of aggregated customer reviews on your product pages, showcasing a one- to five-star rating.
This feature is available in Dynamic/Showcase and Meta Ads when the "Star Rating" or “Retailer” layout is selected.
These ratings provide valuable insights for customers during their research and decision-making process, helping them make informed purchase choices. By offering this feature, you can attract more qualified shoppers to your product pages and enhance their overall shopping experience.

badge
The product’s badge image

Priority: Optional

Limit: 2000
Type: String
Character Requirements: The badge URL must start with http:// or https:// and include the full image URL. Ensure all symbols are properly encoded (e.g., $ becomes %24).
Sample Value: https://static.criteo.net/images/2116/img_728x90.jpg

The badge is an image URL used to highlight a discount, eco-label, or special message (e.g., "Sale!") for a product.
It will appear in Dynamic/Showcase and Meta Ads when the "Retailer" layout is selected. The image must have a specified Content-Type header (image/png, image/gif, or image/jpeg). If the image is restricted from cURL access, please whitelist our user agent to ensure proper display in Criteo banners: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

number_of_reviews
Priority: Optional

Limit: 8
Type: String
Sample Value: 215

Number of reviews the product has received.

Specifications