Documentation Index

Fetch the complete documentation index at: https://help.awin.com/llms.txt

Use this file to discover all available pages before exploring further.

Hosting and column descriptions

Prev Next

If you are automating a product feed, please consider that we are able to retrieve a feed via HTTP(S), SFTP, or FTP. If you choose to use method, please ensure you whitelist our office and server locations, a Technical Services representative can provide this information on request.

Supported columns

The below tables give the XML field names which should be used in your XML feed and their mapping to the columns in the publisher download and CSV upload.

Whenever possible, please prefer a CSV file.

Generic product feed data

We support the following data fields for all industries.

All product data feeds may use these fields. 
* signifies a required field
+-----------------------+-----------------------+
| xmlFieldName          |CSV Documentation Name |
+-----------------------+-----------------------+
| pid*                  | product_id            |
| category              | merchant_category     |
| price*                | price                 |
| brand                 | brand_name            |
| upc                   | upc                   |
| ean                   | ean                   |
| mpn                   | mpn                   |
| isbn                  | isbn                  |
| modelno               | model_number          |
| name*                 | product_name          |
| desc*                 | description           |
| spec                  | specifications        |
| promotext             | promotional_text      |
| lang                  | language              |
| purl*                 | deep_link             |
| thumburl              | merchant_thumb        |
| imgurl*               | image_url             |
| deltime               | delivery_time         |
| validfrom             | valid_from            |
| validto               | valid_to              |
| currency              | currency              |
| delcost               | delivery_cost         |
| weboffer              | web_offer             |
| preorder              | pre_order             |
| instock               | in_stock              |
| stockquant            | stock_quantity        |
| forsale               | is_for_sale           |
| warranty              | warranty              |
| condition             | condition             |
| ptype                 | product_type          |
| parentpid             | parent_product_id     |
| cg                    | commission_group      |
| lastupdated           | last_updated          |
| dimensions            | dimensions            |
| colour                | colour                |
| keywords              | keywords              |
| custom1               | custom1               |
| custom2               | custom2               |
| custom3               | custom3               |
| custom4               | custom4               |
| custom5               | custom5               |
| saving                | saving                |
| delivery_restrictions | delivery_restrictions |
| reviews               | reviews               |
| average_rating        | average_rating        |
| rating                | rating                |
| alternate_image       | alternate_image       |
| large_image           | large_image           |
| basket_link           | basket_link           |
+-----------------------+-----------------------+

*signifies a required field

Fashion product feed data

In addition to the general data fields (see above), further specific data fields may optionally be provided. Here are the specific columns for the Fashion vertical:

+--------------+--------------------+
| xmlFieldName |CSV Name            |
+--------------+--------------------+
| suitable_for | suitable_for       |
| size         | size               |
| material     | material           |
| pattern      | pattern            |
| swatch       | swatch             |
+--------------+--------------------+

Tickets single offer data

In addition to the general data fields (see above), further specific data fields may optionally be provided. Here are the specific columns for the Tickets vertical:

+----------------+--------------------+
| xmlFieldName   | CSV Name           |
+----------------+--------------------+
| primary_artist | primary_artist     |
| second_artist  | second_artist      |
| event_date     | event_date         |
| event_name     | event_name         |
| venue_name     | venue_name         |
| venue_address  | venue_address      |
| available_from | available_from     |
| genre          | genre              |
| min_price      | min_price          |
| max_price      | max_price          |
| longitude      | longitude          |
| latitude       | latitude           |
+----------------+--------------------+

Travel single offer data

In addition to the general data fields (see above), further specific data fields may optionally be provided. Here are the specific columns for the Travel vertical:

+---------------------+---------------------+
| xmlFieldName        | CSV Name            |
+---------------------+---------------------+
| location            | location            |
| check_in_date       | check_in_date       |
| check_in_time       | check_in_time       |
| check_out_date      | check_out_date      |
| duration            | duration            |
| guests_per_room     | guests_per_room     |
| hotel_name          | hotel_name          |
| hotel_address       | hotel_address       |
| hotel_stars         | hotel_stars         |
| hotel_features      | hotel_features      |
| child_policy        | child_policy        |
| room_type           | room_type           |
| room_description    | room_description    |
| availability        | availability        |
| board_basis         | board_basis         |
| longitude           | longitude           |
| latitude            | latitude            |
| departure_code      | departure_code      |
| arrival_code        | arrival_code        |
| departure_date      | departure_date      |
| return_date         | return_date         |
| inbound_duration    | inbound_duration    |
| starting_from_price | starting_from_price |
| check_out_time      | check_out_time      |
| ticket_type         | ticket_type         |
| cancellation_policy | cancellation_policy |
| room_amenities      | room_amenities      |
+---------------------+---------------------+

Groupbuy single offer data

In addition to the general data fields (see above), further specific data fields may optionally be provided. Here are the specific columns for the Group Buying vertical:

+-----------------+--------------------+
| xmlFieldName    | CSV Name           |
+-----------------+--------------------+
| event_city      | event_city         |
| event_address   | event_address      |
| number_sessions | number_sessions    |
| terms           | terms              |
| number_sold     | number_sold        |
| min_required    | min_required       |
| supplier        | supplier           |
| group_latitude  | group_latitude     |
| group_longitude | group_longitude    |
| deal_start      | deal_start         |
| deal_end        | deal_end           |
+-----------------+--------------------+

Telco single offer data

In addition to the general data fields (see above), further specific data fields may optionally be provided. Here are the specific columns for the Telco vertical:

+------------------+--------------------+
| xmlFieldName     | CSV Name           |
+------------------+--------------------+
| contract_type    | contract_type      |
| term             | term               |
| initial_cost     | initial_cost       |
| month_cost       | month_cost         |
| gift             | gift               |
| inc_minutes      | inc_minutes        |
| inc_data         | inc_data           |
| connectivity     | connectivity       |
| inc_texts        | inc_texts          |
| tariff           | tariff             |
| storage_size     | storage_size       |
| special_offer    | special_offer      |
| network          | network            |
| operating_system | operating_system   |
+------------------+--------------------+

XML product data feed

We recommend providing the product data for single offers as a CSV file, as experience has shown this to be less error-prone. For automatic import of the article list via xml file, we recommend using the Awin XML labels (see previous section).

XML Scheme:

<products><product>…</product></products>

Our XML format is also described in the Awin Product Data Feed DTD 1.4.

Note

For Google Shopping feed XML files in the Google Shopping feed format (using Google labels instead of Awin XML feed labels), a feed import script adjustment is required. Alternatively, use the Awin feed API (based on the Google Shopping feed format).

Example:

<products>
<product>
<pid>Z187552zGDNst2b</pid>
<name>example single offer abc123</name>
<purl>https://shop-advertiserdomain.com/product/37f2c197a930?utm_source=awin&utm_medium=affiliate&utm_campaign=product-data-feed&utm_content=product-ads&utm_term=!!!productid!!!</purl>
<price>99.00</price>
<delcost>9.00</delcost>
<currency>EUR</currency>
<brand>examplebrandname</brand>
<category>examplecategoryname</category>
<colour>beige</colour>
<condition>new or refurbished</condition>
<deltime>7-12 days</deltime>
<desc>this product offer is the best, because...</desc>
<lang>EN</lang>
<basket_link>https://shop-advertiserdomain.com/product/37f2c197a930?add-to-cart=1&utm_source=awin&utm_medium=affiliate&utm_campaign=product-data-feed&utm_content=product-ads&utm_term=!!!productid!!!</basket_link>
<instock>1</instock>
<weboffer>1</weboffer>
<forsale>1</forsale>
<imgurl>https://images.cdn....com/...v0-middle.jpg</imgurl>
<thumburl>https://images.cdn....com/...v0-very-small-preview.jpg</thumburl>
<large_image>https://images.cdn....com/...v0-large.jpg</large_image>
<alternate_image>
https://images.cdn....com/...v1.jpg</alternate_image>
<modelno>ABC-387V3a</modelno>
</product>
<products>

CSV product data feed - column descriptions

Generic column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

deep_link

generic

always used

must be an URL

mandatory

direct link to single offer or product

https://www.example.com/product/17290

product_id

generic

always used

Must be present, unique and non empty.

Must be 75 characters or shorter. No control

characters allowed.

Must satisfy the regex

/^[\p{Cc}]+$/u

mandatory

advertiser’s unique

Product ID

9815, 1,

13546421,

d8fea6e6-787b-401

6-9dcc-a78c005ab3

a5, 16817108,

255, SANSOCKS,

0070691,

SHADLA, 2965

product_name

generic

always used

Must be present

and non-empty.

HTML tags are

stripped

mandatory

advertiser’s product or single offer name

Madeira, Aberdeen Central (Family Room - Saver rate) Check..., Adams Jack Brand Crystal Rye IPA, 12 x 330ml bott...,

price

generic

always used

Must be a number.

mandatory

price online

110.00, 6.88,

5.00, 12.00,

2107.43

image_url

generic

always used

Must be present

and non-empty.

direct link to image

https://www.example.com/images/123875.jpg

alternate_image

generic

sometimes used

optional

direct link to an additional product image

https://www.example.com/images/123875-a.jpg

alternate_image_tw

o

generic

sometimes used

optional

direct link to an additional product image

https://www.example.com/images/123875-b.jpg

alternate_image_thr

ee

generic

sometimes used

optional

direct link to an additional product image

https://www.example.com/images/123875-c.jpg

alternate_image_fo

ur

generic

sometimes used

optional

direct link to an additional product image

https://www.example.com/images/123875-d.jpg

average_rating

generic

sometimes used

use rating

How users have rated the product (see also rating)

base_price

generic

sometimes used

Whenever possible

use price, old_price

or rrp_price

Price per unit in numbers

20.49, 0.00,

52.69, 10.85

base_price_amount

generic

sometimes used

Whenever possible

use price, old_price

or rrp_price

Amount the base price is relative to. This should just be a price.

15.99, 2625, 50

base_price_text

generic

sometimes used

Unit the BasePrice refers to. This should be text e.g. 100ml, kg

100ml, lb, kg,

litre

basket_link

generic

sometimes used

Trackable link for pre-filled customer basket

https://shop-advertiserdomain.com/product/37f2c197a930?add-to-cart=1&utm_source=awin&utm_medium=affiliate&utm_campaign=product-data-feed&utm_content=product-ads&utm_term=!!!productid!!!

brand_name

generic

often used

Name of product brand according to the advertiser

Apple, Alcatel,

Oakworth Furniture, Ferm Living, Beats by Dr. Dre

colour

generic

often used

Color of the product

Grey, Blue, Orange

commission_group

generic

sometimes used

Commission group of the product

CAR_TOOLS

ACCESSORIES

condition

generic

often used

Condition of the product

New

currency

generic

often used

Must be a three letter ISO 4217 code. If blank will be the programme currency

Three letter ISO 4217 currency code of price and associated costs (like shipping, discounts, etc).

GBP, EUR, USD

custom1

generic

often used

additional field used as needed

custom2

generic

often used

additional field used as needed

custom3

generic

often used

additional field used as needed

custom4

generic

sometimes used

additional field used as needed

custom5

generic

sometimes used

additional field used as needed

custom6

generic

sometimes used

additional field used as needed

custom7

generic

seldom used

additional field used as needed

custom8

generic

seldom used

additional field used as needed

custom9

generic

seldom used

additional field used as needed

delivery_cost

generic

often used

important within the EU

Cost of delivering the product

0.00, 0, 4.99

delivery_restrictions

generic

sometimes used

Whenever possible, use delivery_cost

Description of any restrictions on delivering the product (e.g. age or location)

Not available in Northern Ireland, Alcohol can only be sent to recipients over 18. ID may be required on delivery.

delivery_time

generic

sometimes used

Estimated delivery time and unit (usually in days)

7-10 working days, 1 to 6 days, Next Day, 1-3 Days, 3, 4-5 jours

delviery_weight

generic

seldom used

Weight of the product (for delivery)

description

generic

mostly used

recomendation: remove html tags

Product or offer description provided by advertiser

West Ham United 1986 Avco Home Shirt Frank McAvenn..., Let your little one step out in style in these inf..., The Alessandra Adjustable Bed has been designed to...

dimensions

generic

sometimes used

for fashion, use

size

Product dimensions usually given as length x width x height

143.4 x 70.5 x 6.8

mm, 12 x 30 cm,

15 inches

ean

generic

often used

Whenever possible, use productGTIN. EAN is also a valid GTIN. EAN is only in Europe.

European Article Number. We do not validate the EAN.

5019093001530,

34262626,

9336328002213

in_stock

generic

often used

Where possible use 1 to indicate in stock and 0 to indicate no stock. Leaving the field blank will also assume there is no stock. Populating the field with any text apart from 1 or 0 will assume there is stock.

Denotes if the product is in stock

0, 1

is_for_sale

generic

often used

Consider in_stock

Denotes if the item can be bought

0, 1

isbn

generic

sometimes used

Whenever possible,

use productGTIN.

ISBN is also a valid

GTIN.

International Standard Book Number. We do not validate the ISBN.

8695700,

50220922,

5060167489525,

5060020625954,

5055534397954

keywords

generic

sometimes used

Product’s keywords

Dash Fashion, Navy Jogger Regular, 055041557, beurre,

corporel, Triple Stacking Storage

Trunk, G2291

language

generic

often used

Must be two-letter

ISO 639-1 code. If empty, defaults to 'en'

Language of the product data as two-letter ISO 639-1 code

FR, en_GB, de_DE

large_image

generic

sometimes used

direct link to a large image (non-trackable)

https://www.example.com/images/123875.jpg

last_updated

generic

often used

Must be a date time

Date the product was last updated

2026-05-25,2026-05-25T00:00:00, 2026-05-25 00:00:00

merchant_category

generic

often used

Advertiser’s product categorisation

Nutrition, Beauty, Men’s Lace-up shoes, Gifts > Anti-Ageing Sets, Fitness  Equipment, SALE, Home

merchant_product_

category_path

generic

often used

use also merchant_category

Product’s category path as specified by the advertiser

Apparel > Clothing

> T-Shirts & Tops

merchant_product_

second_category

generic

sometimes used

Product’s sub-category as specified by the advertiser

Bath & Body,

Jongensfietsen,

DVDs

merchant_product_t

hird_category

generic

sometimes used

Product’s third category level as specified by the advertiser

Pulls, Mattresses,

Films

merchant_thumb

generic

often used

maybe 70×70 pixels

direct link to thumbnail image (non-trackable)

https://www.example.com/images/123875small.jpg

model_number

generic

often used

Manufacturer Model Number

HD130, 1940000,

4YH63,

70-100-05,

230011700302540

mpn

generic

often used

Manufacturer Part Number

95760, P1089NAVSHAKE

R700ML, 7110513092012,

5068-01VG,

MAS015,

10270109,

1108-BT-BF-Q21

number_available

generic

seldom used

use also stock_quantity

Product stock available (see stock_quantity)

parent_product_id

generic

sometimes used

Product ID of other

bundled product(s)

AAFCK, 60405,

10216434, PP-44,

10076451, FH7938, 023162, 370631, 10000654

pre_order

generic

often used

Can the user pre order if not yet in stock

0, 1

product_GTIN

generic

often used

Global Trade Item Number. We do not validate GTIN.

5051145189278,

5055534322987,

0040818088319,

074469475983

product_model

generic

seldom used

Whenever possible,

use model_number

Model name of the product

Cartouche Couleur

CANON CL-511, Slim Fit, Red, Space Grey

product_price_old

generic

sometimes used

Whenever possible, use also: rrp_price

The original price; will be empty if bigger than or equal to the price

10.95, 15.95, 39.99

product_short_desc

ription

generic

often used

Brief product description

White cultured pearl in graduate size lariat neckl..., Lave et prolonge l'éclat des cheveux colorés, Experience unrivalled moisture with Mio Skincare's...

product_type

generic

often used

Consider using category

Product type

Accessory, Rent, Buy

promotional_text

generic

sometimes used

HTML tags are

stripped

Product promotional

message

Try 6 issues of History Revealed magazine for just..., Web Exclusive,

Postage and Packing USD 6.95. Free shipping for..., Discounted by…

rating

generic

seldom used

Product rating

7, 8, 8.5, 3.5

reviews

generic

sometimes used

Consider using rating

Textual reviews

from customers

Wonderful!, We loved it!, Disappointing

rrp_price

generic

often used

Recommended retail price

Recommended

Retail Price of

product

10.95, 15.95, 39.99, 3970.29

saving

generic

sometimes used

Absolute savings in

currency. Consider

using savings_percent for savings in pecent

Product saving

16.68, 6.60, 140.00

savings_percent

generic

sometimes used

Savings in percentage.

Consider using saving for absolute savings.

The discount

expressed in %

40.00, 39.39, 0.00

size_stock_amount

generic

seldom used

Number of products

in stock for each

size

S:0|M:0|L:0|XL:0|X

XL:13|XXXL:30|4XL

:1,

39:1,41:7,42:21,43:

25,43+:15,44:15,44

+:2,45:10,46:...

size_stock_status

generic

seldom used

Stock status of the product for each size

24;28;29;30;31;32;

33;34,

XS:available|S:avai

lable|M:available|L:

available|X...

specifications

generic

often used

HTML tags are

stripped

Product technical

specifications

Black, Cups&Band: 100% polyester; Cup &

Band Lining: 100%..., * Colour: Black * SIM Type: Micro SIM *

Camera Meg...

stock_quantity

generic

often used

Product stock available

200, 9, 1475, 3

stock_status

generic

sometimes used

use in_stock

Stock status indication

in stock, out of stock, available, not available

store_price

generic

often used

Price in-store

10.74, 16.79, 43

terms_of_contract

generic

seldom used

Conditions of contract for the product

Your Activity: Using your gift voucher...

upc

generic

sometimes used

Whenever possible,

use productGTIN.

UPC is also a valid

GTIN.

Universal Product Code

05034948040403,

700053288591,

077315000056

valid_from

generic

sometimes used

Product offer start date

2026-05-25,2026-05-25T00:00:00, 2026-05-25 00:00:00

valid_to

generic

sometimes used

Product offer expiry date

2026-12-31,2026-12-31T23:59:59, 2027-01-01 00:00:00

warranty

generic

sometimes used

HTML tags are

stripped

Product warranty

Furniture Insurance available: 3 Year Protection £..., 1 year, No quibbles money back guarantee

web_offer

generic

often used

Must be '1' or '0' or

'yes' or 'no'. Default

'0'

Denotes if the product is only available online (usually True/False or Yes/No)

0, 1

Fashion column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

suitable_for

fashion

often used

Who products are suitable for

Male, Unisex, Female, Boys, Girls, Maternity

category

fashion

seldom used

Use

merchant_category

Fashion category

size

fashion

often used

Size of product

ONE, 30ml,

universal, 11 (45),

10, 3, 9 (43),

O/S, UNI, 8-10

material

fashion

sometimes used

Material product is made from

Wool, Cotton, Polyester, Viscose, Leather, Lace, 38% Acrylique 32% Polyester 25% Laine 3% D´autres

pattern

sometimes used

Patter / Design of

products

Plain, Pierre Black Loafer, Francis Tan Brogue Shoe, Gingham, Cruise Suede Grey Chukka Boot, Flannel Grey

swatch

seldom used

Consider using colour. colourSwatch should be a picture

Image of the fabric of the fashion product

https://www.example.com/images/123875.jpg

Group Buying column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

deal_end

group buying

sometimes used

Date and time from when the deal is no longer available

2026-06-25

00:00:00

deal_start

group buying

sometimes used

Date and time from when the deal is available

2026-05-25

00:00:00

event_address

group buying

often used

Address of event venue

35 E. 76th St.,

ZSL London Zoo,

Chichester Street

event_city

group buying

often used

City of event venue

London, New York City, Berlin, Paris, Texas

event_date

group buying

often used

Date of event

2026-02-01

expiry_date

group buying

seldom used

Consider deal_end

Date when the coupon or group buying deal expires

2027-07-20

expiry_time

group buying

seldom used

Consider deal_end

Time when the coupon or group buying deal expires

00:00:00

group_latitude

group buying

seldom used

The latitude associated with this item

51.512759000000,

51.505551300000,

40.764220200000,

51.496398500000

group_longitude

group buying

seldom used

The longitude associated with this

item

-73.963528099999,

-0.134454499999,

-74.004297500000,

-73.974274700000

min_required

group buying

rare

Minimum number of

products to be purchased

number_sessions

group buying

sometimes used

Number of sessions

available

1000, 5000, 25

number_sold

group buying

Number of products

currently sold

supplier

group buying

sometimes used

Provider of product

B.B. King Blues Club & Grill, Le Vacherin, RS

Hispaniola

terms

group buying

sometimes used

Terms & Conditions

of products

Voucher can be redeemed immediately; valid daily..., The regular value stated above is based on the max...

Shopping column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

energy_label

shopping

sometimes used

energy label (e.g. within the EU)

A+++, B, C

energy_label_link

shopping

Direct link to a full image or page giving more energy label details (non-trackable)

energy_label_logo

shopping

Direct link to energy label icon logo (non-trackable)

google_taxonomy

shopping

Google Shopping taxonomy path

Apparel & Accessories > Clothing Accessories > Sunglasses

Telcos column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

connectivity

telcos

often used

Type of connectivity

mobile contract or

device has

contract_type

telcos

often used

Name or type of contract

deal_cashback_json

telcos

often used

Enhanced Telco Data Feeds

deal_cost_json

telcos

often used

Enhanced Telco Data Feeds

deal_discounts_jso

n

telcos

often used

Enhanced Telco Data Feeds

deal_extras_json

telcos

often used

Enhanced Telco Data Feeds

deal_legal_info

telcos

often used

Enhanced Telco Data Feeds

deal_promo_info

telcos

often used

Enhanced Telco Data Feeds

deal_retailer_json

telcos

often used

Enhanced Telco Data Feeds

deal_tags_json

telcos

often used

Enhanced Telco Data Feeds

deal_type_json

telcos

often used

Enhanced Telco Data Feeds

device_features_json

telcos

often used

Enhanced Telco Data Feeds

device_full_name

telcos

often used

Enhanced Telco Data Feeds

device_images_json

telcos

often used

Enhanced Telco Data Feeds

device_product_edit

ion_json

telcos

often used

Enhanced Telco Data Feeds

device_product_json

telcos

often used

Enhanced Telco Data Feeds

device_product_ver

sion_json

telcos

often used

Enhanced Telco Data Feeds

device_specification

s_json

telcos

often used

Enhanced Telco Data Feeds

device_description

telcos

often used

HTML tags are

stripped

Device description

gift

telcos

often used

Free gift included

with product

inc_data

telcos

often used

Amount of data included in deal (usually in GB)

inc_minutes

telcos

often used

Number of minutes

included in deal

inc_texts

telcos

often used

Number of text messages included in deal

initial_cost

telcos

often used

Initial upfront cost

month_cost

telcos

often used

Monthly cost of contract, especially

telecom contracts

network

telcos

often used

The Mobile Network

operator’s brand name

network_details_json

telcos

often used

Mobile Network details

operating_system

telcos

often used

The device’s operating system

special_offer

telcos

often used

Special offer

storage_size

telcos

often used

Size of storage required for products

subscription_name

telcos

often used

Name of the subscription plan

subscription_price_

effective

telcos

often used

Effective costs per month, taking into account discounts and offers

subscription_renew

al

telcos

often used

Renewal of subscription

tariff

telcos

often used

Phone deal tariff

tariff_allowances_json

telcos

often used

Tariff allowances

tariff_details_json

telcos

often used

Tariff details

tariff_group_details

_json

telcos

often used

The tariff group allows for grouping of tariffs

tariff_out_of_plan_c

harges_json

telcos

often used

Details of costs outside of tariff

term

telcos

often used

Term of contract

Enhanced Datafeeds for (Mobile) Telecoms Sector

We offer detailed developer documentation about the Awin enhanced telco feeds.

Telcos NL column descriptions

Alternative template for telco offers:

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

connectivity

telcos NL

often used

Type of connectivity

mobile contract or

device has

contract_type

telcos NL

often used

Name or type of contract

device_monthly_cost

telcos NL

often used

Monthly part of the

subscription cost (e.g. for the mobile device)

gift

telcos NL

often used

Free gift included with product

inc_data

telcos NL

often used

Amount of data included in deal (usually in GB)

inc_minutes

telcos NL

often used

Number of minutes

included in deal

inc_texts

telcos NL NL

often used

Number of text messages included in deal

initial_cost

telcos NL

often used

Initial upfront cost

month_cost

telcos NL

often used

Monthly cost of contract, especially telecom contracts

network

telcos NL

often used

The Mobile Network

operator's brand name

operating_system

telcos NL

often used

The device’s operating system

reproduction_tax

telcos NL

sometimes used

Added tax-price on data carriers for copy rights

special_offer

telcos NL

often used

Special offer

storage_size

telcos NL

often used

Size of storage required for products

subscription_download_speed

telcos NL

often used

Download speed in

megabits per second

subscription_internet

telcos NL

often used

Name of the internet subscription (especially for Benelux markets)

subscription_internet_cost

telcos NL

often used

Cost internet subscription (especially for Benelux markets)

subscription_interne

t_cost_special_offer

telcos NL

sometimes used

Current special offer price for internet subscription (especially for Benelux markets)

subscription_length

telcos NL

often used

Length of the subscription in  months, either until the user can cancel the contract or when the contract expires

subscription_minutes_cost

telcos NL

often used

Cost of included voice minutes (especially for Benelux markets)

subscription_minutes_cost_special_offer

telcos NL

sometimes used

Current special offer price for included voice minutes (especially for Benelux

markets)

subscription_monthly_cost_special_offer

telcos NL

sometimes used

Current special offer price

subscription_name

telcos NL

often used

Name of the subscription plan

subscription_upload_speed

telcos NL

often used

Upload speed in megabits per second

term

telcos NL

sometimes used

Term of contract

Tickets column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

available_from

tickets

sometimes used

When tickets are available from

2026-10-07

07:00:00

event_date

tickets

often used

Date of event

2027-02-01

event_duration

tickets

often used

Duration of the event

event_location_address

tickets

often used

Address of the event venue

event_location_city

tickets

often used

Whenever possible, use venue_address

City where the event takes place

Verona, Los Angeles, Los Angeles, Venice

event_location_coordinates

tickets

often used

Geographic coordinates of the event location

event_location_country

tickets

often used

Whenever possible, use venue_address

Country where the event takes place

France, United Kingdom, Germany, IT, US

event_location_region

tickets

sometimes used

Whenever possible,

use venue_address

Region where the event takes place

Texas, Georgia

event_location_zipc

ode

tickets

sometimes used

Whenever possible,

use venue_address

Zip code or postal code of the event venue

30305, 90028, 37010

event_name

tickets

often used

Name of event

Absolute Bowie 1711, Taylor Baker Duo, A Night with Janis Joplin, Lol Stand up comedy show

genre

tickets

often used

Genre of event

Sports, Theatre, Rock, Comedy

latitude

tickets

often used

Latitude of destination

40.158021,

41.880875, 0,

-115.1717702,

35.658978,

53.95294

longitude

tickets

often used

Longitude of destination

-73.980187,

0.76744655784508

1, -111.95298,

-73.9840306,

174.761966

max_price

tickets

often used

Maximum price of tickets

79.90, 115, 19.50, 85.00, 988.73,'82.50, 30.00

min_price

tickets

often used

Minimum price of tickets

0.00, 15.00, 20.00, 5.99, 19.50

primary_artist

tickets

sometimes used

Primary artist at event

WWE, An American In Paris, British Grand Prix, Andre Rieu, Mac

King Comedy Magic Show, An Evening

with Aggers & Bumble

second_artist

tickets

seldom used

Support artist at event

Pittsburgh Pirates, WWE Smackdown,

Kansas City Royals, Milwaukee Brewers

venue_address

tickets

often used

Address of venue

122 W. Monroe Street, Chicago, IL, US - 60603, Phoenix Theatre, Charing Cross

Road, London, WC2H

venue_name

tickets

often used

Name of venue

Phoenix Theatre, Fabulous Fox Theatre - Atlanta, Colette Club New Orleans

Travel column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

arrival_code

travel

often used

IATA airport code

Arrival airport code

HRG, CMB, MLA, BCN, BER

availability

travel

often used

prefer in_stock

Travel offer availability (see also ‘in_stock‘)

board_basis

travel

often used

Which meals are included in the price

Breakfast and Dinner, Self-catered, All inclusive

cancellation_policy

travel

sometimes used

Cancellation policy

First Night Stay Chargeable, Full

refund up to 48 hours before departure

check_in_date

travel

sometimes used

YYYY-MM-DD

Date when the guest can check-in

2026-08-07

check_in_time

travel

sometimes used

HH:MM

Time from when the

guest can check-in

14:00, 2:00 PM

check_out_date

travel

sometimes used

YYYY-MM-DD

Date when the guest must check-out

2026-08-12

check_out_time

travel

sometimes used

HH:MM

Time when the guest must check-out

10:00, 11:00, 12:00 PM

child_policy

travel

seldom used

Accommodation policy on children

Yes, No,

1, 0,

TRUE, FALSE

departure_code

travel

often used

IATA airport code

Departure airport code

HRG, CMB, MLA, BCN, BER

departure_date

travel

sometimes used

YYYY-MM-DD

Date of departure for travel products

2026-09-09

destination_address

travel

seldom used

Whenever possible,

use hotel_address or location

Destination address

2110 Market Center Blvd, Stralauer Allee 2b, 10245 Berlin, Germany

destination_city

travel

often used

Destination city

Paris, Berlin

destination_coordinates

travel

sometimes used

Geographic coordinates of the

destination

destination_country

travel

often used

Destination country

US, France, GER

destination_name

travel

sometimes used

Name of the destination

destination_region

travel

sometimes used

Destination region

Noord-Frankrijk,

Provence, BC

destination_type

travel

sometimes used

Type of destination

Hotel, Resort

destination_zipcode

travel

sometimes used

Destination zip or

postal code

90210, 10245, CB4 2EE

duration

travel

often used

Duration of stay for

travel products

7 days, 3 hours, 3 nights

guests_per_room

travel

seldom used

Number of guests

allowed

4, 5, 3, 8, 22

hotel_address

travel

often used

Address of hotel for

travel offers

Buckingham Road, Aylesbury,

Buckinghamshire, HP1..., Kilmarnock Road, Monkton,

Ayr, Ayrshire, KA9 2RJ, ..., 8080 N Davis Hwy

hotel_features

travel

often used

Hotel features for travel offers

Hotel Non-Smoking

Throughout;Disabled Facilities;A...,

Arcade/game room, Free newspapers in lobby, Hotel Non-Smoking

Throughout;Cots available;Weddin…,

Free parking

hotel_name

travel

often used

Hotel name for travel offers

Bognor, Shiba Park - Tokyo, Hilton Al Hamra Beach & Golf Resort, Bognor, Village Hotel Swindon, Hotel Panorama Mellieha

Bay, Hotel Paradise Bay

hotel_stars

travel

often used

Hotel Star Rating for travel offers

5, 4, 3, 2

inbound_duration

travel

sometimes used

Duration of inbound

journey

latitude

travel

often used

Latitude of destination

40.158021, 41.880875, 0, -115.1717702, 35.658978,

53.95294

location

travel

often used

Location of destination

Malta, Beijing, Albany, Hong Kong, Scotland, St Anton, Singapore, Green Bay, Jersey

longitude

travel

often used

Longitude of destination

-73.980187, 0.767446557845081, -111.95298, -73.9840306,

174.761966

price_per_person

travel

often used

Price per person

100, 10.00, 231.27

return_date

travel

often used

YYYY-MM-DD

Date of return for travel products

2026-12-01

room_amenities

travel

often used

Consider

hotel_features

Features of the room like a mini-bar and free wifi

Minibar, Storage heaters with

woodburning stove in sitting ..., Free Wifi

room_description

travel

often used

Consider

hotel_features

Description of room

for travel products

Air conditioning, Sea view, Rock and roll theme

room_type

travel

often used

Type of room for travel products

Superior Room,

Double/Twin Balcony,

Double/Twin Room,

Standard Double/Twin,

Standard Twin Balcony/Terrace,

Deluxe Room

starting_from_price

travel

often used

Price travel products start from

1099.00, 33.41, 571.00, 68.58

ticket_type

travel

sometimes used

Type of ticket

Return, Single,

(DE: Hin, Hin- und Rückflug)

travel_pax_max

travel

sometimes used

Maximum number of participants

travel_pax_min

travel

sometimes used

Minimum number of

participants

travel_rating

travel

sometimes used

Use rating

Travel/hotel rating

2.0, 2.5, 8.0

travel_transport

travel

sometimes used

Type of transport

travel_type

travel

sometimes used

Type of travel or holiday

Travel NL column descriptions

Alternative template for travel offers:

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

booking_fee

travel NL

sometimes used

Reservation (administration) costs

check_in_date

travel NL

sometimes used

YYYY-MM-DD

Date when the guest can check-in

2026-08-07

check_in_time

travel NL

sometimes used

HH:MM

Time from when the

guest can check-in

14:00, 2:00 PM

check_out_time

travel NL

sometimes used

HH:MM

Time when the guest must check-out

10:00, 11:00, 12:00 PM

deal

travel NL

sometimes used

Details of the special offer or package holiday

destination_address

travel NL

seldom used

Whenever possible,

use hotel_address or location

Destination address

2110 Market Center Blvd, Stralauer Allee 2b, 10245 Berlin, Germany

destination_city

travel NL

often used

Destination city

Paris, Berlin

destination_type

travel NL

sometimes used

Type of destination

Hotel, Resort

hotel_name

travel NL

often used

Hotel name for travel offers

Bognor, Shiba Park - Tokyo, Hilton Al Hamra Beach & Golf Resort, Bognor, Village Hotel

Swindon, Hotel Panorama Mellieha

Bay, Hotel Paradise Bay

inbound_duration

travel NL

sometimes used

Duration of inbound

journey

latitude

travel NL

often used

Latitude of destination

40.158021, 41.880875, 0,

-115.1717702, 35.658978,

53.95294

location

travel NL

often used

Location of destination

Malta, Beijing, Albany, Hong Kong, Scotland, St Anton, Singapore, Green Bay, Jersey

longitude

travel NL

often used

Longitude of destination

-73.980187, 0.767446557845081, -111.95298, -73.9840306,

174.761966

price_per_person

travel NL

often used

Price per person

100, 10.00, 231.27

return_date

travel NL

often used

YYYY-MM-DD

Date of return for travel products

2026-12-01

room_description

travel NL

often used

Consider

hotel_features

Description of room

for travel products

Air conditioning, Sea view, Rock and roll theme

terms

travel NL

sometimes used

Terms & Conditions of products

Voucher can be

redeemed immediately; valid

daily..., The regular value stated above is based on the max...

transport

travel NL

sometimes used

Type of transport offered: air, sea, train, etc

travel_pax_max

travel NL

sometimes used

Maximum number of participants

travel_pax_min

travel NL

sometimes used

Minimum number of

participants

Books column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

author

books

often used

Name of the person or people who wrote the book

composer

books

often used

Name of the person or people who composed the piece of music

print

books

sometimes used

Number of the print run for the book

publisher

books

sometimes used

Name of the publisher of the book or music

Jobs column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

education

jobs

sometimes used

Mandatory graduation /

education when apply for this job

employer_name

jobs

often used

Company name

employment

jobs

often used

Occupation, work, business

experience

jobs

often used

Knowledge of a particular field

group

jobs

sometimes used

Vacancy group / category

hours

jobs

often used

Working hours weekly

intermediate_country

jobs

often used

Intermediaryoffice country

intermediate_location

jobs

often used

Intermediaryoffice city

intermediate_postal

_code

jobs

often used

Intermediaryoffice postal code

intermediate_region

jobs

often used

Intermediaryoffice region

intermediate_type

jobs

often used

Intermediarytype: mediator, employment

agency, etc.

job_type

jobs

often used

Type of occupation or businesses

location

jobs

often used

Location of destination

Malta, Beijing, Albany, Hong Kong, Scotland, St Anton, Singapore, Green Bay, Jersey

region

jobs

often used

Region of the work / business office

salary

jobs

often used

Fixed periodically (usually monthly) paid wage for the work

start_date

jobs

often used

Date the vacancy was added

Education column descriptions

CSV column name

Vertical name

Frequency

Validation /

restrictions

Advertiser mapping notes

Description

Example

daypart

education

sometimes used

Part of the day and duration to attend the course

deadlines

education

sometimes used

The latest time or date by which a course should be completed

field

education

often used

Field of education

institute

education

often used

Name of institute which offers the course

level

education

often used

Education level: High-school, Community college, Higher education, Academy, Science education

location

education

often used

Location of destination

Malta, Beijing, Albany, Hong Kong, Scotland, St Anton, Singapore, Green Bay, Jersey

max

education

often used

Maximum duration of the course in month before the exam or obtain a diploma / graduate

min

education

often used

Minimum duration of the course in month before the exam or obtain a diploma / graduate

month_price

education

often used

Course monthly fee

next

education

sometimes used

Next level after graduation

previous

education

sometimes used

Compulsory graduation level before attending the course

start_fee

education

sometimes used

Initial cost / registration fee

time

education

sometimes used

Duration of the course in hours