Home

Support

Placement Layout Performance Report

Home

Support

Placement Layout Performance Report

Campaign

Placement Layout Performance Report

Author

Tom Wendt

30 Apr 2026

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 publisher account under 'Profile' or read about it in the support article Access API in more detail. For setting up your queries, we have gathered 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 example, 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




Click earnings divided by the number of clicks.

AverageCpm

Micro Amount




Average earnings per thousand impressions (CPM)

AverageContainerCpm

Micro Amount




Average earnings per thousand container impressions.

Clicks

Long




Number of clicks

Ctr

Double




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

ContainerCtr

Double




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

ContainerImpressions

Long




Number of container impressions.

ContainerInvalidClickRate

Double




InvalidClicks divided by ContainerImpressions.

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




InvalidClicks divided by the total number of clicks

InvalidClicks

Long




Number of clicks detected as invalid and not billed.

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




Earnings

SiteId

Long




ID of the site

SiteName

String




Name of the site

You might also be interested in this

Tom Wendt

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

Tom Wendt

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

Tom Wendt

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

Tom Wendt

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

Tom Wendt

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

Tom Wendt

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