Campaign

Retargeting with product feed

To use AdUp Native Retargeting, a product feed is required, which is regularly processed by us. This must be accessible via a URL and contain all product information that is relevant for your dynamic ads.

File Type & Encoding

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

The feed should be encoded 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 line with the column names. Any CSV format can be used, such as TSV, Excel-compatible or similar.

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

  • A semicolon should be used as a delimiter

  • Field values should be specified 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 as flat a structure 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 of 100 characters

Name

  • The name of the product

  • Maximum of 100 characters

Category

  • The category of the product

  • Maximum of 100 characters

Price

  • The current individual price of the product in Euros

  • Full stop as delimiter for decimal places

  • No thousands separators

Destination URL

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

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

Image URL (Fallback)

  • The URL of a product image, which is used if no image is available in the required format

  • If this field is not assigned, the configured image of the ad will be used


Optional Fields

Name

Description

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

  • The URL of a product image in the corresponding format

  • Should the field for the required format not exist, then the product image from the "Image URL (Fallback)" field is used

  • Should "Image URL (Fallback)" also not exist, then the configured image of the ad is used 

Discount Price

  • The current reduced individual price of the product in Euros

  • If present, then the discount is represented visually in %

  • Full stop as delimiter for decimal places

  • No thousands separators

Shipping Costs

  • The shipping costs in Euros

  • Full stop as delimiter for decimal places

  • No thousands separators

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 label is possible here, which is assigned a system-usable value in the campaign wizard

Arrival (Location)

  • The 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 

  • 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

Custom1
Custom2
Custom3
Custom4
Custom5

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