DestinationUrlPerformanceReportColumn Value Set

Microsoft Advertising APIs

Specifies the data columns to include in a destination URL performance report.

Syntax

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

<xs:simpleType name="DestinationUrlPerformanceReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName"/>
    <xs:enumeration value="AccountNumber"/>
    <xs:enumeration value="TimePeriod"/>
    <xs:enumeration value="LanguageAndRegion"/>
    <xs:enumeration value="CampaignName"/>
    <xs:enumeration value="CampaignId"/>
    <xs:enumeration value="AdGroupName"/>
    <xs:enumeration value="AdGroupId"/>
    <xs:enumeration value="AdId"/>
    <xs:enumeration value="CurrencyCode"/>
    <xs:enumeration value="AdDistribution"/>
    <xs:enumeration value="DestinationUrl"/>
    <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="DestinationUrlPerformanceReportColumn" nillable="true" type="tns:DestinationUrlPerformanceReportColumn"/>

Values

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.
AdId	The ad identifier.
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.
CampaignId	The campaign identifier.
CampaignName	The campaign name.
Clicks	The number of times the destination URL 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.
DestinationUrl	The destination URL.
Impressions	The number of impressions.
LanguageAndRegion	The language and country/region.
PricingModel	The pricing model of the ad.
Spend	The total amount of money spent for the time period.
TimePeriod	The time period of each report row. Note: The TimePeriod column cannot be requested if the `DestinationUrlPerformanceReportRequest.Aggregation` element contains "Summary".

Required Columns

The following columns will always be contained in a destination URL performance report.

Column
AccountName
CampaignName

Optional Columns

The columns in the following table can optionally be contained in a destination URL performance report.

Column
AccountNumber
AdDistribution
AdGroupId
AdGroupName
AdId
AverageCpc
AverageCpm
AveragePosition
CampaignId
Clicks
ConversionRate
Conversions
CostPerConversion
Ctr
CurrencyCode
DestinationUrl
Impressions
LanguageAndRegion
PricingModel
Spend
TimePeriod

A destination URL performance report must contain at least one of the optional columns as shown in the following table.

Column
AverageCpc
AverageCpm
AveragePosition
Clicks
Ctr
DestinationUrl
Impressions
Spend

Time-Period Columns

If the TimePeriod column is requested, a destination URL 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	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

DestinationUrlPerformanceReportRequest Data Object