Home

Support

Placement Layout Performance Report

Home

Support

Placement Layout Performance Report

Campaign

Placement Layout Performance Report

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

Basics

In order to benefit from the AdUp API, you need access. You can find this in your publisher account under ‘Profile’ or read up on it in more detail in the support article API Access. For setting up queries, we have compiled everything you need to know in the Basics article.

The Placement Layout Performance Report contains statistics at the PlacementLayout level (one row per PlacementLayout). If other segment fields are used, you will get more than one row per PlacementLayout.

Segments

  • PlacementLayoutId

  • Date

  • DayOfWeek

  • Month

  • MonthOfYear

  • Quarter

  • Week

  • Year

Attributes

  • PlacementId

  • PlacementLayoutName

  • PlacementLayoutStatus

  • PlacementName

  • PublisherId

  • PublisherDescriptiveName

  • SiteId

  • SiteName

Metrics

  • AverageCpc

  • AverageCpm

  • AverageContainerCpm

  • Clicks

  • ContainerCtr

  • ContainerImpressions

  • ContainerInvalidClickRate

  • Ctr

  • Impressions

  • InvalidClickRate

  • InvalidClicks

  • Revenue

Example

For instance, if you want to retrieve the Placement Layout Performance Report on a monthly basis per site, you use the Segment Month, the Attribute SiteName and the Metric Revenue.

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


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


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

Field Description

Name

Type

Description

AverageCpc

Micro Amount

Revenue from clicks divided by the number of clicks.

AverageCpm

Micro Amount

Average revenue per thousand impressions (CPM).

AverageContainerCpm

Micro Amount

Average revenue per thousand container impressions.

Clicks

Long

Number of clicks.

Ctr

Double

Clicks of the ads divided by the number of ad impressions.

ContainerCtr

Double

Clicks of the ads divided by the number of container impressions.

ContainerImpressions

Long

Number of container impressions.

ContainerInvalidClickRate

Double

Invalid clicks divided by container impressions.

Date

String

Formatted as YYYY-MM-DD.

DayOfWeek

String

Name of the day (e.g. Monday).

Impressions

Long

Number of impressions of the ads.

InvalidClickRate

Double

Invalid clicks divided by the total number of 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).

PlacementId

Long

ID of the placement.

PlacementLayoutId

Long

ID of the placement layout.

PlacementLayoutName

String

Name of the placement layout.

PlacementLayoutStatus

String

Status of the placement layout.

PlacementName

String

Name of the placement.

PublisherDescriptiveName

String

Descriptive name of the publisher.

PublisherId

Long

ID of the publisher.

Quarter

String

First day of the quarter, formatted as YYYY-MM-DD.

Revenue

MicroAmount

Revenue.

SiteId

Long

ID of the site.

SiteName

String

Name of the site.

You might also be interested in this

5 min read

Basics of the AdUp API

Use the AdUp API to retrieve reports and performance data automatically. Learn how to authenticate via OAuth, generate reports and efficiently integrate data into your own systems.

Product

5 min read

Our Delivery API

Use the AdUp Delivery API to programmatically integrate, update or remove ads – ideal for dynamic websites and modern web applications.

Publisher

5 min read

Campaign Performance Report (Advertiser API)

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

Advertiser

5 min read

Ad Performance Report (Advertiser API)

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

Advertiser

5 min read

Account Performance Report

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

Advertiser

5 min read

Access to the AdUp API

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

Advertiser

Publisher