Back to overview
Targetings

Retargeting with product feed

In order to use AdUp Native Retargeting, a product feed is required, which is processed by us on a regular basis. This must be accessible via URL and contain all product information that is eligible for your 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
Category
  • The category 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
  • The current reduced unit price of the product in euros.
  • If available, the discount is visually displayed in %.
  • Dot as separator for decimal places
  • No grouping of the thousand digits
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
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 Travel
Departure (place)
  • The start destination
  • Useful in Travel
Number of adults
  • The number of adults
  • Useful in Travel
Number of children
  • The number of children
  • Useful in Travel
Number of rooms
  • The number of rooms
  • Useful in Travel
Check-In Date
  • The check-in date 
  • Format YYYY-MM-DD
  • Useful in Travel
Check-Out Date
  • The check-out date 
  • Format YYYY-MM-DD
  • Useful in Travel
User defined 1
User defined 2
User defined 3
User defined 4
User defined 5
  • Here you can assign any values from your feed and use them later as placeholder values in your ad texts

Related topics