AccountPerformanceReportColumn Value Set

Microsoft Advertising APIs

Specifies the data columns to include in an account performance report.

Syntax

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

<xs:simpleType name="AccountPerformanceReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName"/>
    <xs:enumeration value="AccountNumber"/>
    <xs:enumeration value="TimePeriod"/>
    <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="LowQualityClicks"/>
    <xs:enumeration value="LowQualityClicksPercent"/>
    <xs:enumeration value="LowQualityImpressions"/>
    <xs:enumeration value="LowQualityImpressionsPercent"/>
    <xs:enumeration value="LowQualityConversions"/>
    <xs:enumeration value="LowQualityConversionRate"/>
    <xs:enumeration value="AverageCpm"/>
  </xs:restriction>
</xs:simpleType>
<xs:element name="AccountPerformanceReportColumn" nillable="true" type="tns:AccountPerformanceReportColumn"/>

Values

Value	Description
AccountName	The account name.
AccountNumber	The account number.
AdDistribution	The ad distribution medium.
AverageCpc	The average cost-per-click.
AverageCpm	The cost-per-thousand-impressions. Note: This column can be requested only if you belong to the CPM pilot program.
AveragePosition	The average position of the ad in paid results.
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.
LowQualityClicks	The number of low-quality clicks.
LowQualityClicksPercent	The percentage of low-quality clicks.
LowQualityConversionRate	The low-quality conversion rate.
LowQualityConversions	The number of low-quality conversions.
LowQualityImpressions	The number of low-quality impressions.
LowQualityImpressionsPercent	The percentage of low-quality impressions.
Spend	The total amount spent for the time period.
TimePeriod	The time period of each report row. Note: This column cannot be requested if the `AccountPerformanceReportRequest.Aggregation` element contains "Summary".

Required Columns

The following column must always be specified in an account performance report.

Column
AccountName

Optional Columns

The columns in the following table can optionally be specified in an account performance report.

Column
AccountNumber
AdDistribution
AverageCpc
AverageCpm
AveragePosition
Clicks
ConversionRate
Conversions
CostPerConversion
Ctr
CurrencyCode
Impressions
LowQualityClicks
LowQualityClicksPercent
LowQualityConversionRate
LowQualityConversions
LowQualityImpressions
LowQualityImpressionsPercent
Spend
TimePeriod

An account 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

Time-Period Columns

If the TimePeriod column is requested, an account performance report contains at least one of the following time-period columns. The actual columns included in the report depends on the report aggregation requested.

Time-Period Column Label	Aggregation	Description
GregorianDate	Daily	Specifies the date 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.

Requirements

WSDL: ReportingService.svc in version 6.

Reference

AccountPerformanceReportRequest Data Object