Home

Support

Dynamic Ads and the Product Feed

Home

Support

Dynamic Ads and the Product Feed

Campaign

Dynamic Ads and the Product Feed

Use Dynamic Ads to deliver product ads automatically and based on data.

File Type & Encoding

The product feed should be in CSV or XML format and preferably compressed. The file extension should reflect the format and compression method.

The encoding of the feed should be in UTF-8 format.

Format

Example URL

Plain CSV

http://example.com/feed.csv

CSV with Gzip compression

http://example.com/feed.csv.gz

CSV with Zip compression

http://example.com/feed.csv.zip

Plain XML

http://example.com/feed.xml

XML with Gzip compression

http://example.com/feed.xml.gz

XML with Zip compression

http://example.com/feed.xml.zip

 

CSV

CSV files require a header row with column labels. Any CSV formats, such as TSV, Excel-compatible, or similar, can be used.

To avoid issues during import, the following restrictions should be adhered to:

  • A semicolon should be used as the separator

  • The field values should be enclosed in quotation marks

  • The newline control character should be used for line breaks

"p_id";"name";"pr";"img";"url"
"ABC123";"Colour TV";"1234.56";"http://www.example.com/abc123.jpg";"https://www.example.com/abc123.html"
"DEF456";"Black and White TV";"234.56";"http://www.example.com/def456.jpg";"https://www.example.com/def456.html"


"p_id";"name";"pr";"img";"url"
"ABC123";"Colour TV";"1234.56";"http://www.example.com/abc123.jpg";"https://www.example.com/abc123.html"
"DEF456";"Black and White TV";"234.56";"http://www.example.com/def456.jpg";"https://www.example.com/def456.html"


"p_id";"name";"pr";"img";"url"
"ABC123";"Colour TV";"1234.56";"http://www.example.com/abc123.jpg";"https://www.example.com/abc123.html"
"DEF456";"Black and White TV";"234.56";"http://www.example.com/def456.jpg";"https://www.example.com/def456.html"


XML

XML files should have a structure that is as flat as possible.

<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product>
        <p_id>ABC123</p_id>
        <name>Colour TV</name>
        <pr>1234.56</pr>
        <img>https://www.example.com/abc123.jpg</img>
        <url>https://www.example.com/abc123.html</url>
    </product>
    <product>
        <p_id>DEF456</p_id>
        <name>Black and White TV</name>
        <pr>234.56</pr>
        <img>https://www.example.com/def456.jpg</img>
        <url>https://www.example.com/def456.html</url>
    </product>
    ...
</products>
<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product>
        <p_id>ABC123</p_id>
        <name>Colour TV</name>
        <pr>1234.56</pr>
        <img>https://www.example.com/abc123.jpg</img>
        <url>https://www.example.com/abc123.html</url>
    </product>
    <product>
        <p_id>DEF456</p_id>
        <name>Black and White TV</name>
        <pr>234.56</pr>
        <img>https://www.example.com/def456.jpg</img>
        <url>https://www.example.com/def456.html</url>
    </product>
    ...
</products>
<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product>
        <p_id>ABC123</p_id>
        <name>Colour TV</name>
        <pr>1234.56</pr>
        <img>https://www.example.com/abc123.jpg</img>
        <url>https://www.example.com/abc123.html</url>
    </product>
    <product>
        <p_id>DEF456</p_id>
        <name>Black and White TV</name>
        <pr>234.56</pr>
        <img>https://www.example.com/def456.jpg</img>
        <url>https://www.example.com/def456.html</url>
    </product>
    ...
</products>


Required Fields

Name

Description

Product ID

  • The unique identifier of the product

  • Must only occur once in the feed

  • Maximum 100 characters

Name

  • The name of the product

  • Maximum 100 characters

Price

  • The current unit price of the product in euros

  • Full stop as decimal separator

  • No thousands separator grouping

Target URL

  • The URL where the user lands when they click on the ad

  • If this field is not assigned, the final click URL stored in the ad will be used

Image URL (Fallback)

  • The URL to a product image that is used if no image is available in the required format

  • If this field is not assigned, the image stored in the ad will be used


Optional Fields

Name

Description

Example

Image URL (1x1)
Image URL (4x3)
Image URL (16x9)
Image URL (10x3)

  • The URL to a product image in the corresponding format

  • If the field for the required format is not present, the product image from the "Image URL (Fallback)" field will be used

  • If "Image URL (Fallback)" is also not present, the image stored in the ad will be used 


Discount Price

  • The current reduced unit price of the product in euros

  • If present, the discount will be visually represented in %

  • Full stop as decimal separator

  • No thousands separator grouping


Shipping Costs

  • The shipping costs in euros

  • Full stop as decimal separator

  • No thousands separator grouping


Currency

  • The currency of the product price, the discount price, and the shipping costs 

  • ISO 4217 format


Category

  • The category of the product

  • Maximum 100 characters


Availability

  • The current availability of the product

  • Any label is possible here, which will be assigned to a system-usable value in the campaign wizard


Arrival (Location)

  • The target destination

  • Useful in the travel sector


Departure (Location)

  • The starting destination

  • Useful in the travel sector


Number of Adults

  • The number of adults

  • Useful in the travel sector


Number of Children

  • The number of children

  • Useful in the travel sector


Number of Rooms

  • The number of rooms

  • Useful in the travel sector


Check-In Date

  • The check-in date 

  • YYYY-MM-DD format

  • Useful in the travel sector


Check-Out Date

  • The check-out date 

  • YYYY-MM-DD format

  • Useful in the travel sector


Custom1
Custom2
Custom3
Custom4
Custom5

  • Here you can assign any values from your feed and use them later as placeholder values in your ad copies


You might also be interested in this

5 min read

Dynamic Ads with placeholders

Personalise your Dynamic Ads with placeholders from your product feed. Learn how placeholders, fallback texts and fit placeholders work and how to optimally design dynamic ads.

Advertiser

5 min read

What are Dynamic Ads and how do you use them?

Learn how Dynamic Ads automatically create individual ads based on keywords, product data or retargeting information, and how to set them up using a product feed.

Advertiser