Adform

Sample

https://connectors.windsor.ai/adform?api_key=<APIKEY>&date_preset=last_7d&fields=date,campaign_id,campaign,client,impressions,clicks,cost


Fields

IDTypeNameDescription
TEXTBannerThis dimension groups information by banner for Display campaigns, or by Adgroup for Search campaigns. Banner is an advertisement vehicle. The banner is displayed through different medias/publishers on different placements. Adgroup contains one or more keywords used in Search Engine campaigns.
TEXTBanner Attribute1This dimension groups information by Banner Attribute 1. Banner attribute is a user-defined property of a banner. Banner Attribute 1 is usually assigned to the banner batch column in Banner Overview page.
TEXTBanner SizeThis dimension groups information by banner size. Banner size is shown as "width x height" in pixels, e.g. 300 x 250.
TEXTBanner TypeThis dimension groups information by creative material type. Most common banner types include Flash, Image, Rich Media, Link, Keyword and other.
buy_typeTEXTBuy TypeThis dimension indicates the booking/buy types of the selected placement. Possible values - Impressions (CPM), Clicks (CPC), Viewable Impressions (vCPM), Days, Weeks, Months and Conversions.
campaignTEXTCampaignThis dimension shows and groups information by campaign. The campaign is the base item in Adform system, it contains media, placements, banners.
campaign_idTEXTCampaign_IDThis dimension groups data by Adform campaign ID.
campaign_typeTEXTCampaign TypeThis dimension groups information by campaign type. Campaign type can be assigned in Campaign Details page, possible values - Display, Affiliate, Email, Social Media and other.
clicksNUMERICClicksThis metric shows the number of clicks for the selected dimension. A click occurs when a user interacts with the advertisement by engaging a mouse button (usually the left) while the mouse pointer is hovering over the advertisement.
clicks_to_landing_pageNUMERICClicks To Landing PageThis metric shows the percentage of clicks ending up as visits on the landing page for the selected dimension.
clickscrossdeviceNUMERICClicks Cross DeviceThis metric shows the number of times that users clicked on a banner and were directed to an advertiser's destination. When selecting uniqueness levels, a user is considered unique across all their devices and identifiers. TIP - User engagements with rich media banners, e.g., click on video play start button, are not taken into account.
clientTEXTClientDisplays client/advertiser information. Used to group campaigns, in benchmarking reports etc.
costNUMERICCostThis metric shows the cost value for the selected dimension (usually on a media, placement (line item) level). Please check documentation for more details.
cost_by_salesNUMERICCost By SalesThis metric shows Cost value divided by Sales value. Cost is either booked or accumulated cost for the selected dimension, or RTB Budget Spent in case of Real Time Bidding campaign. Sales is a system variable and represents the returned value of a campaign.
cost_non_viewNUMERICCost Non ViewThis metric shows the cost value taking into account the percentage of non-viewable and undetermined impressions. TIP - Check documentation for more details.
cost_post_clickNUMERICCost Post ClickThis metric shows the post click conversions cost.
cost_viewNUMERICCost ViewThis metric shows the cost value taking into account the percentage of viewable impressions. TIP - Check documentation for more details.
countryTEXTCountryGeographical dimension, groups information by visitor's country e.g. Denmark, UK, USA, etc.
covNUMERICCovThis metric shows the conversion rate for the selected dimension. Calculated as conversions divided from clicks, in percent.
ctrPERCENTCtrThis metric shows click-through rate for the selected dimension. It is a percentage of users who have been exposed to an advertisement and then clicked. Calculated as clicks divided from impressions, in percent.
ctr_adjustedNUMERICCtr AdjustedThis metric shows click-through rate for the selected dimension. It is a percentage of users who have been exposed to an advertisement and then clicked. Calculated as clicks divided from impressions, in percent. This metric considers all tag serving types such as Impressions, Invisible, Offile, etc. except for Clicks in order to assure consistent metric values.
ctr_uniqueNUMERICCtr UniqueThis metric shows unique click-through rate for the selected dimension. It is a percentage of unique users who have been exposed to an advertisement and then clicked. Calculated as campaign unique clicks divided from campaign impressions, in percent.
ctr_viewNUMERICCtr ViewThis metric shows the percentage of impressions that resulted in a click, taking into account only those impressions that were actually in the users' screens.
dateDATEDateThis dimension groups information by date when a transaction happened.
device_typeTEXTDevice typeTechnical dimension, groups data by device type, which can be - Desktop and Laptop, Small Screen Phone, Smart Phone, Tablet, Other Mobile, Media Hub, Console, TV, eReader, Smart Watch, Smart Speaker. It shows what share of traffic comes from different device types.
engagementsNUMERICEngagementsThis metric shows the count of user interactions with a banner. User interactions are tracked as user-initiated banner events for Rich Media, Flash and Image banner types. Examples of user-initiated banner events are mouse-over (only if > 1 sec.), video play button press, close button press, etc. Not user-initiated banner events are not included into this metric, except for auto-expand event. Examples of not user-initiated banner event are Floating Banner Shown, 25% of Video Play, etc.
engaging_impressionsNUMERICEngagingImpressionsThis metric shows the sum of impressions, where at least one engagement occurred during each impression. Engagements are tracked as user-initiated banner events for Rich Media, Flash and Image banner types. Examples of user-initiated banner events are mouse-over (only if > 1 sec.), video play button press, close button press, etc.
eventTEXTEventThis dimension groups information by banner event name. Banner events can be implemented in flash banners in order to track user interactions with banners, such as expands, clicks on play button, etc.
eventsNUMERICEventsThis metric shows how many times an event has been invoked in a banner. Events can be implemented in flash banners in order to track user interactions with banners, such as expands, clicks on play button, etc. Tip - use with dimension Event Name if several different events are implemented.
hourTEXTHourTime dimension, groups information by hour of the day (values from 0 to 23).
impressionsNUMERICImpressionsThis metric shows the number of tracked ads (formerly known as impressions) and includes both rendered and served-but-not-rendered ads. Both client-initiated and server-initiated measurement is taken into account. Only client-initiated measurement is compliant with Media Rating Council (MRC) guidelines.
line_itemTEXTLineItemThis dimension groups information by Line Item. Line Item is an advertisement spot on a media/publisher.
line_item_end_dateDATELine Item End DateThis dimension displays Line Item end date collected from Mediaplan scheduler.
line_item_idTEXTLine Item IDThis dimension groups data by Adform Line Item ID.
line_item_start_dateDATELine Item Start DateThis dimension displays Line Item start date collected from Mediaplan scheduler.
mediaTEXTMediaMedia/publisher is the provider of online advertising space, such as an online newspaper, social network site or other.
roiNUMERICRoiThis metric shows the return of investment. A positive value corresponds to capital growth, a negative value corresponds to capital decay, and a value of 0% corresponds to no change. It is calculated as (Sales - Cost) / Cost * 100%, or as (Sales - RTB Budget Spent) / RTB Budget Spent * 100% in case of Real Time Bidding campaign.
rtb_domainTEXTRtb DomainThis dimension groups data by RTB domain. RTB domains show 2nd level URLs of publisher sites (e.g. cnn.com), where a banner was displayed when impression was registered. RTB domain values are tracked and sent to Adform by AdExchanges.
rtb_inventory_sourceTEXTRtb Inventory SourceGroups information by RTB Inventory Source. Inventory source is an ad exchange, which can be selected for running a Real Time Bidding campaign, e.g. Admeld, Microsoft Ad Exchange, etc.
salesNUMERICSalesThis metric shows the sales value collected from all visits on tracked pages and is an Order level variable. Collected only if variable is implemented in Tracking points. It has predefined Uniqueness of 'No Repeat', which means that sales value form pageviews, generated by the same user within 15 minutes, are excluded.
tagTEXTTagTag is a small piece of code used to track online advertisements. This dimension groups information in relations to tags, it could be used to show rotators information.
totalcostNUMERICTotal CostThis metric shows the cost value for the selected dimension (usually on a media, placement (line item) level). Please check documentation for more details. (Duplicate)
video_views_100NUMERICVideo views 100This metric shows 100% of the interactions with video banners,where banner events are implemented. Interactions such as Play, Pause, Stop, Sound On,and others can be reported
video_views_25NUMERICVideo views 25This metric shows at least 25% of the interactions with video banners,where banner events are implemented. Interactions such as Play, Pause, Stop, Sound On,and others can be reported
video_views_50NUMERICVideo views 50This metric shows at least 50% of the interactions with video banners,where banner events are implemented. Interactions such as Play, Pause, Stop, Sound On,and others can be reported
video_views_75NUMERICVideo views 75This metric shows at least 75% of the interactions with video banners,where banner events are implemented. Interactions such as Play, Pause, Stop, Sound On,and others can be reported
visitorsNUMERICVisitorsShows the number of unique visitors in advertiser's website for the selected tracking setup.
visitsNUMERICVisitsShows the number of visits in advertiser's website for the selected tracking setup.