Click to Rate and Give Feedback
MSDN
MSDN Library
Online Services
 AdGroupPerformanceReportColumn Valu...
Collapse All/Expand All Collapse All
Microsoft Advertising APIs
AdGroupPerformanceReportColumn Value Set

Specifies the data columns to include in an ad group performance report.

<xs:complexType name="ArrayOfAdGroupPerformanceReportColumn">
  <xs:sequence>
    <xs:element minOccurs="0" maxOccurs="unbounded" name="AdGroupPerformanceReportColumn" type="tns:AdGroupPerformanceReportColumn"/>
  </xs:sequence>
</xs:complexType>
<xs:element name="ArrayOfAdGroupPerformanceReportColumn" nillable="true" type="tns:ArrayOfAdGroupPerformanceReportColumn"/>

<xs:simpleType name="AdGroupPerformanceReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName"/>
    <xs:enumeration value="AccountNumber"/>
    <xs:enumeration value="TimePeriod"/>
    <xs:enumeration value="LanguageAndRegion"/>
    <xs:enumeration value="Status"/>
    <xs:enumeration value="CampaignName"/>
    <xs:enumeration value="CampaignId"/>
    <xs:enumeration value="AdGroupName"/>
    <xs:enumeration value="AdGroupId"/>
    <xs:enumeration value="CurrencyCode"/>
    <xs:enumeration value="AdDistribution"/>
    <xs:enumeration value="Impressions"/>
    <xs:enumeration value="Clicks"/>
    <xs:enumeration value="Ctr"/>
    <xs:enumeration value="AverageCpc"/>
    <xs:enumeration value="Spend"/>
    <xs:enumeration value="AveragePosition"/>
    <xs:enumeration value="Conversions"/>
    <xs:enumeration value="ConversionRate"/>
    <xs:enumeration value="CostPerConversion"/>
    <xs:enumeration value="AverageCpm"/>
    <xs:enumeration value="PricingModel"/>
  </xs:restriction>
</xs:simpleType>
<xs:element name="AdGroupPerformanceReportColumn" nillable="true" type="tns:AdGroupPerformanceReportColumn"/>

Value Description

AccountName

The account name.

AccountNumber

The account number.

AdDistribution

The ad distribution medium.

AdGroupId

The ad group identifier.

AdGroupName

The ad group name.

AverageCpc

The average cost-per-click.

AverageCpm

The cost-per-thousand-impressions.

Bb671495.note(en-US,MSADS.60).gifNote:
This column can be requested only if you belong to the CPM pilot program.

AveragePosition

The average position of the ad in paid results.

CampaignId

The campaign identifier.

CampaignName

The campaign name.

Clicks

The number of times that the ad was clicked.

ConversionRate

The conversion rate.

Conversions

The number of conversions.

CostPerConversion

The cost-per-conversion.

Ctr

The click-through rate.

CurrencyCode

The currency code.

Impressions

The number of impressions.

LanguageAndRegion

The language and country/region.

PricingModel

The pricing model of the ad group.

Spend

The total amount of money spent for the time period.

Status

The status of the ad group.

TimePeriod

The time period of each report row.

Bb671495.note(en-US,MSADS.60).gifNote:
This column cannot be requested if the AdGroupPerformanceReportRequest.Aggregation element contains "Summary".

The following columns will always be contained in an ad group performance report.

Column

AccountName

AdGroupName

CampaignName

The columns in the following table can optionally be contained in an ad group performance report.

Column

AccountNumber

AdDistribution

AdGroupId

AverageCpc

AverageCpm

AveragePosition

CampaignId

Clicks

ConversionRate

Conversions

CostPerConversion

Ctr

CurrencyCode

Impressions

LanguageAndRegion

PricingModel

Spend

Status

TimePeriod

An ad group performance report must contain at least one of the optional columns as shown in the following table.

Column

AverageCpc

AverageCpm

AveragePosition

Clicks

Ctr

Impressions

Spend

If the TimePeriod column is requested, an ad group performance report contains at least one of the following time-period columns. They specify the time period of the report row.

Time-Period Column Label Aggregation Description

GregorianDate

Daily

Hourly

Specifies the date of the report row.

Hour

Hourly

Specifies the hour of the report row.

MonthStartDate

Monthly

Specifies the first day of the month of the report row.

WeekStartDate

Weekly

Specifies the first day of the week of the report row.

Year

Yearly

Specifies the year of the report row.

WSDL: ReportingService.svc in version 6.

© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker