Campaign

Account Performance Report

With our AdUp API, you can sit back and automatically transfer all your account data into your preferred BI system.

Basics

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

Segments

  • AccountId

  • Date

  • DayOfWeek

  • Month

  • MonthOfYear

  • Quarter

  • Week

  • Year

Attributes

  • AccountDescriptiveName

Metrics

  • AllConversionsRate

  • AllConversionsRateByConversionDate

  • AllConversions

  • AverageCost

  • AverageCpc

  • AverageCpm

  • AveragePosition

  • Clicks

  • ConversionRate

  • ConversionRateByConversionDate

  • Conversions

  • ConversionsByConversionDate

  • Cost

  • CostPerAllConversion

  • CostPerAllConversionByConversionDate

  • CostPerConversion

  • CostPerConversionByConversionDate

  • Ctr

  • Impressions

  • InteractionRate

  • Interactions

  • InvalidClickRate

  • InvalidClicks

  • ViewThroughConversions

  • ViewThroughConversionsByConversionDate

Example

For example, if you want to retrieve the Account Performance Report on a monthly basis per account name, you use the Segment Month, the Attribute AccountDescriptiveName, and the Metric Clicks.

{
  "report_name": "Test Report",
  "report_type": "ACCOUNT_PERFORMANCE_REPORT",
  "select": [
    "Month",
    "AccountDescriptiveName",
    "Clicks"
  ],
  "conditions": [
    {
      "field": "Clicks",
      "operator": "GREATER_THAN",
      "values": [
        "0"
      ]
    }
  ],
  "download_format": "JSON",
  "date_range_type": "LAST_MONTH"

{
  "report_name": "Test Report",
  "report_type": "ACCOUNT_PERFORMANCE_REPORT",
  "select": [
    "Month",
    "AccountDescriptiveName",
    "Clicks"
  ],
  "conditions": [
    {
      "field": "Clicks",
      "operator": "GREATER_THAN",
      "values": [
        "0"
      ]
    }
  ],
  "download_format": "JSON",
  "date_range_type": "LAST_MONTH"

{
  "report_name": "Test Report",
  "report_type": "ACCOUNT_PERFORMANCE_REPORT",
  "select": [
    "Month",
    "AccountDescriptiveName",
    "Clicks"
  ],
  "conditions": [
    {
      "field": "Clicks",
      "operator": "GREATER_THAN",
      "values": [
        "0"
      ]
    }
  ],
  "download_format": "JSON",
  "date_range_type": "LAST_MONTH"

Field Description

Name

Type

Description

AccountDescriptiveName

String

the name of the account

AccountId

Long

the ID of the account

AllConversionRate

Double

Number of all conversions tracked by AdUp divided by the number of clicks that can generate conversions.

AllConversions

Long

Currently there is no difference to "Conversions"

AverageCost

Micro Amount

Average cost per interaction

AverageCpc

Micro Amount

Cost of clicks divided by the number of clicks.

AverageCpm

Micro Amount

Average cost per thousand impressions (CPM)

AveragePosition

Double

Average position in relation to other advertisers

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 incl. externally uploaded conversions. Conversions by impression date may change retrospectively, depending on the stored tracking window.

Cost

Micro Amount

Total cost of the 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)

Impressions

Long

Number of impressions of the ads

InteractionRate

Double

Interactions divided by impressions

Interactions

Long

Interactions with the ads. Currently exclusively clicks.

InvalidClickRate

Double

InvalidClicks divided by the number of all clicks

InvalidClicks

Long

Number of clicks identified as invalid and not charged.

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

ViewThroughConversions

Long

The number of view-conversions, i.e. conversions completed after a user was shown an ad.

Week

String

Date of the Monday of the week, formatted as YYYY-MM-DD

Year

String

Year, formatted as YYYY

Notes

How can conversions be reported by conversion date? 

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