Adtraction product data specification

Use this specification to format your product information for your Adtraction partner program. Submitting your product data to Adtraction in the correct format is important for allowing your partners to market your products in the best way.

If you already have a product data file available that conforms with the Google Shopping format, this will in most cases also work with Adtraction.

Should you have any questions, please contact support.

Basic requirements

  • Format: Adtraction can import most types of text files, such as XML, CSV or TXT. We do not support files in Microsoft Excel XLS format or other non-text formats.
  • Location: Adtraction requires a static FTP or HTTPS address from which your data file can be downloaded. The URL or file name must be static, ie do not include dates or similar.
  • Encoding: It is highly recommended that your file is UTF-8 encoded.
  • Product variations: (size, colour, etc) should be listed as separate products with unique names and IDs.

Field specification

The product information you submit using these attributes is our foundation for allowing partners to market your products. Make sure everything you submit is of the quality you'd show to a customer.



Attribute Format Examples
id Required
The product's unique identifier. Use the product's SKU where possible. Keep the ID the same when updating your data. If a product is removed, its ID must not be reused for another product.
 A2B4
title Required
The product's name. Do not include promotional text like "free shipping", all capital letters or gimmicky characters. Do not include HTML tags.
 Mens Pique Polo Shirt
description Required
The product's description. Do not include promotional text like "free shipping", all capital letters or gimmicky characters. Do not include HTML tags.
 Made from 100% organic cotton, this classic red men's polo has a slim fit and signature logo embroidered on the left chest. Machine wash cold; imported.
link Required
The product's landing page. Including https. Provide a direct link without redirects. Do not include Google Analytics (UTM) tags.
 https://www.example.com/asp/sp.asp?cat=12&id=1030
image_link Required
The URL of the product's main image. Including https. Use an image of at least 200 x 200 pixels. Do not submit a placeholder or a generic image.
 https://www.example.com/image1.jpg
availability Required
The product's availability.
 in_stock
out_of_stock
price Required
The product's price including VAT, excluding delivery cost. Use the same currency as used in your partner program. Do not use thousands separator. Numeric, ISO 4217.
 15.00 EUR
sale_price Required
The product's price including VAT, excluding delivery cost. Use the same currency as used in your partner program. Do not use thousands separator. Numeric, ISO 4217.
 10.00 EUR
brand Required
The product's brand name.
 Sony
product_type Required
Product category that you define for your product.
 Home > Women > Dresses > Maxi Dresses
shipping Required
The product's shipping cost, shipping speeds, and the locations your product ships to.
 UK:::2.00 GBP
gtin Required
Global Trade Item Number (GTIN). Use European Article Number (EAN) (13 digit) if available.
 3234567890126
gender Optional
Required for all products in Clothes & Accessories.
The gender for which your product is intended.
 female
male
unisex
size Optional
Required for all products in Clothes & Accessories.
The product's size.
 XL
age_group Optional
Required for all products in Clothes & Accessories.
The demographic for which the product is intended.
 newborn
infant
toddler
kids
adult
color Optional
Required for all products in Clothes & Accessories.
The product's color.
 black
material Optional
Required for all products in Clothes & Accessories.
The product's fabric or material.
 leather
pattern Optional
Required for all products in Clothes & Accessories.
The product's pattern or graphic print.
 striped
energy_efficiency_class Optional
Required for products in Electronics & Technology.
The product's energy label.
 A+
multipack Optional
Required in France, Germany, Italy, Netherlands, Spain, Switzerland and the UK.
Submit the number of products in your multipack. If you don't submit the attribute, the default value is 0.
 6
is_bundle Optional
Required in France, Germany, Italy, Netherlands, Spain, Switzerland and the UK.
Submit yes if you're selling a custom bundle of different products. For example, a camera combined with a lens and bag. If you don't submit the attribute, the default value is no.
 yes
no
item_group_id Optional
Required for France, Germany and the UK.
ID for a group of products that come in different versions (variants).
 AB12345
condition Optional
The condition of the product at time of sale.
 new
refurbished
used
mpn Optional
The product's Manufacturer Part Number.
 GO12345OOGLE
unit_pricing_measure Optional
Defines the measure and dimension of a product. Allows users to understand the exact cost per unit.
 750ml
unit_pricing_base_measure Optional
Defines the denominator for the unit price.
 100g
google_product_category Optional
The Google-defined product category for the product.
 Apparel & Accessories > Clothing > Outerwear > Coats & Jackets
custom_label_0 Optional
custom_label_0 through custom_label_4 allow you to include custom information in your feed.
 Summer