Direct Placement Performance Report Advertiser API

Basics

To take advantage of the AdUp API, you need an account. Find it in your advertiser account under 'Profile' or read the support article Access API in more detail. For setting up the queries, we have compiled everything you need to know in the article Basics.

Segments

Date
DayOfWeek
Id
Month
MonthOfYear
Quarter
Week
Year

Attributes

AccountId
AccountDescriptiveName
AdgroupName
AdgroupStatus
CampaignId
CampaignName
CampaignStatus
DisplayName
Status

Metrics

AllConversionsRate
AllConversions
AverageCost
AverageCpc
AverageCpm
AveragePosition
Clicks
ConversionRate
Conversions
Cost
CostPerAllConversion
CostPerConversion
Ctr
Impressions
InteractionRate
Interactions
ViewThroughConversions

Description fields

Name	Typ	Beschreibung
AccountDescriptiveName	String	the name of the account
AccountId	Long	The ID of the account.
AdgroupId	Long	The ID of the AdGroup
AdgroupName	String	The name of the adgroup.
AdgroupStatus	String	The status of the adgroup.
AllConversionRate	Double	Number of all conversions tracked by AdUp divided by the number of clicks that can generate conversions.
AllConversions	Long	Currently the same as "Conversions"
AverageCost	Micro Amount	Average cost per interaction
AverageCpc	Micro Amount	Cost of clicks divided by number of clicks.
AverageCpm	Micro Amount	Average cost per thousand impressions (CPM)
AveragePosition	Double	Average position in relation to other advertisers
CampaignId	Long	ID of the campaign
CampaignName	String	name of the campaign
CampaignStatus	String	Status of the campaign
Clicks	Long	number of clicks
ConversionRate	Double	Number of conversions divided by the number of clicks that can generate conversions.
Conversions	Long	All click conversions available in the statistics by impression date. Including externally uploaded conversions. Conversions by impression date can change afterwards, depending on the tracking time window specified.
Cost	Micro Amount	Total cost of ads
CostPerAllConversion	Micro Amount	Cost divided by AllConversions
CostPerConversion	Micro Amount	Cost divided by conversions
Ctr	Double	Clicks of the ads divided by the number of impressions of the ads.
Date	String	Formatted as YYYY-MM-DD
DayOfWeek	String	Name of the day (e.g. Monday)
DisplayName	String	Name of the Direct Placement
Id	Long	The ID of the ad
Impressions	Long	Number of impressions of the ads
InteractionRate	Double	Interactions divided by impressions
Interactions	Long	Interactions with the ads. Currently only clicks.
Month	String	First day of the month, formatted as YYYY-MM-DD
MonthOfYear	String	Name of the month (e.g. January)
Quarter	String	First day of the quarter, formatted as YYYY-MM-DD
Status	String	The status of the ad
ViewThroughConversions	Long	The number of view conversions, i.e. conversions that are completed after a user has been shown an ad.

Notes

How can I report conversions by conversion date?

Conversions by conversion date are currently not available via the API.