Campaign

Dynamic Ads and the Product Feed

In order to be able to use Dynamic Ads, a product feed is required, which is processed by us on a regular basis. This feed must be accessible via URL and contain all product information that is eligible for Dynamic Ads.

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.

 

FormatExample URL
Pure CSVhttp://example.com/feed.csv
CSV with Gzip compressionhttp://example.com/feed.csv.gz
CSV with Zip compressionhttp://example.com/feed.csv.zip
Pure XMLhttp://example.com/feed.xml
XML with Gzip compressionhttp://example.com/feed.xml.gz
XML with Zip compressionhttp://example.com/feed.xml.zip

 

CSV

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

To avoid problems during import, the following restrictions should be observed:

  • A semicolon should be used as a separator.

  • The field values should be specified in quotation marks.

  • The newline control character should be used as a line break.

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

XML

XML files should have as flat a structure as possible.

<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product>
        <p_id>ABC123</p_id>
        <name>Color 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 Example
Product ID
  • The unique identification of the product
  • May only appear 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
  • Dot as separator for decimal places
  • No grouping of the thousand digits
Target URL
  • The URL that the user lands on when they click on the ad.
  • If this field is not assigned, the stored final click URL of the ad is used.
Image URL (Fallback)
  • The URL to a product image that will be used if no image is available in the required format.
  • If this field is not assigned, the stored image of the advertisement is 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 appropriate format.
  • If the field for the required format is not available, the product image from the field "Image URL (Fallback)" is used.
  • If "Image URL (Fallback)" is also not available, the image stored in the ad is used. 
Discount price
  • Der aktuelle reduzierte Einzelpreis des Produkts in Euro
  • Wenn vorhanden, dann wird der Rabatt in % visuell dargestellt
  • Punkt als Trennzeichen für Nachkommastellen
  • Keine Gruppierung der Tausenderstellen
Shipping costs
  • The shipping costs in euros
  • Dot as separator for decimal places
  • No grouping of the thousand digits
Currency
  • The currency of the product price, the discount price and the shipping costs. 
  • Format ISO 4217
Category
  • The category of the product
  • Maximum 100 characters
Availability
  • The current availability of the product
  • Any designation is possible here, which is assigned to a value that can be used by the system in the campaign wizard.
Arrival (place)
  • The destination
  • Useful in the travel sector
Departure (place)
  • The start 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 
  • Format YYYY-MM-DD
  • Useful in the travel sector
Check-Out Date
  • The check-out date 
  • Format YYYY-MM-DD
  • Useful in the travel sector
User-defined1
User-defined2
User-defined3
User-defined4
User-defined5
  • Here you can assign any values from your feed and use them later as placeholder values in your ad texts