Ad media export file

Creating the URL

The URL required for creating an ad media data export file is build up as following:

https://export.net.[domain]/[your_api_key]/adm-admedia.[file_extension]?[filters]

Once you have filled in your domain, your API key, your user ID and the relevant file extension and you have applied your filters, your URL should look more or less like this:

https://export-demonet.ingenioustech.biz/a1234a-8855-6584-abcd-363d08461785/adm-admedia.csv

By default your system-generated default API key is used in the export links.

Applying filters

For the ad media data export file, following filters can be applied:

Filter description

Filter name

Compulsory

Format

Filter description

Filter name

Compulsory

Format

Allows you to limit the export to the ad media of a specific advertiser.

mid

Yes

Use the MID (merchant ID) you find overview of your advertisers.

These filters are to be added to the URL as parameters. Use the the question mark (?) for the first parameter and the ampersand (&) for all further parameters. Add the word filter, the filter name, the equals sign (=) and the relevant values according to the format mentioned in the table.

Output

The ad media export file contains the following data:

Name

Explanation

Example

Name

Explanation

Example

merchantid

The ID of the advertiser to which the ad media element belongs.

123

bannerid

The ID of the ad media item.

1234

type

The type of the ad media item. Possible values are banner, html, text (for text links) and flash.

banner

title

The name of the ad media item.

Product banner 125 x 125

width

The width of the ad media item. For text links and html item, the value will be 0.

125

height

The height of the ad media item. For text links and HTML item, the value will be 0.

25

targeturl

The URL to which a costumer using the ad media item will be directed.

http://shopping.com/

admdescription

The description of the ad media item.

Standard 125×25 banner.

admcatid

The ID of the category in which the ad media item is stored.

123

advars.target

The URL where the image used for the ad media item stored. For text links, this field will be empty.

https://images.shopping.com/?image=1234

advars.htmlsource

The source code of the HTML ad media . Obviously, this field is only relevant for HMTL ad media items.

 

code

advars.swfurl

The URL where the file used for your Flash ad media item is stored. This field is only relevant for Flash ad media items.

http://creatives.shopping.com/ng_1501_300x250.swf

advars.clicktag

The value for the click tag parameter used for your Flash ad media item, i.e. the target URL of the flash ad media item. This field is only relevant for Flash ad media items.

http://shopping.com

advars.swfparameter

The value for an additional parameter that can be added to a Flash ad media item. This field is only relevant for Flash ad media items.

lang=ENG

advars.altbanner

A brief text that will be used when a customer’s browser cannot load the image or HTML file related to the ad media item.

Click here for Shopping.com!

advars.linktext

The text of a text link. This field is only relevant for text links.

Enjoy the spring collection on shopping.com!

delete.admedia

This field indicates whether the ad media item has been deleted or not. 0 means the item is active, 1 means it has been deleted.