Microsoft Advertising APIs
AdDynamicTextPerformanceReportColumn Value Set

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

Syntax

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

<xs:simpleType name="AdDynamicTextPerformanceReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName"/>
    <xs:enumeration value="AccountNumber"/>
    <xs:enumeration value="TimePeriod"/>
    <xs:enumeration value="LanguageAndRegion"/>
    <xs:enumeration value="AdGroupName"/>
    <xs:enumeration value="AdGroupId"/>
    <xs:enumeration value="Keyword"/>
    <xs:enumeration value="AdId"/>
    <xs:enumeration value="AdTitle"/>
    <xs:enumeration value="AdType"/>
    <xs:enumeration value="DestinationUrl"/>
    <xs:enumeration value="Param1"/>
    <xs:enumeration value="Param2"/>
    <xs:enumeration value="Param3"/>
    <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="AdDynamicTextPerformanceReportColumn" nillable="true" type="tns:AdDynamicTextPerformanceReportColumn"/>
Values

Value Description

AccountName

The account name.

AccountNumber

The account number.

AdDistribution

The ad distribution medium.

AdGroupName

The ad group name.

AdGroupId

The ad group identifier.

AdTitle

The ad title.

AdType

The ad type.

AverageCpc

The average cost-per-click.

AverageCpm

The cost-per-thousand-impressions.

Bb671878.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.

Clicks

The number of times 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.

DestinationUrl

The destination URL.

Impressions

The number of impressions.

Keyword

The keyword.

LanguageAndRegion

The language and country/region.

Param1

The first dynamic parameter.

Param2

The second dynamic parameter.

Param3

The third dynamic parameter.

PricingModel

The pricing model of the ad.

Spend

The total amount spent for the time period.

TimePeriod

The time period of each report row.

Bb671878.note(en-US,MSADS.60).gifNote:
The TimePeriod column cannot be requested if the Aggregation element of the AdDynamicTextPerformanceReportRequest object contains "Summary".

Required Columns

The columns in the following table will always be contained in an ad dynamic text performance report.

Column

AccountName

AdGroupName

AdTitle

DestinationURL

Param1

Param2

Param3

Optional Columns

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

Column

AccountNumber

AdDistribution

AdType

AverageCpc

AverageCpm

AveragePosition

Clicks

ConversionRate

Conversions

CostPerConversion

Ctr

CurrencyCode

Impressions

Keyword

LanguageAndRegion

PricingModel

Spend

TimePeriod

The ad dynamic text 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 ad dynamic text 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.

See Also

Reference

AdDynamicTextPerformanceReportRequest Data Object

Page view tracker