Microsoft Advertising APIs
MetroAreaDemographicReportColumn Value Set

Specifies the data columns to include in a metropolitan-area demographic report.

Syntax

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

<xs:simpleType name="MetroAreaDemographicReportColumn">
  <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="AdGroupName"/>
    <xs:enumeration value="Country"/>
    <xs:enumeration value="State"/>
    <xs:enumeration value="MetroArea"/>
    <xs:enumeration value="CurrencyCode"/>
    <xs:enumeration value="Hour"/>
    <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="AverageCpm"/>
  </xs:restriction>
</xs:simpleType>
<xs:element name="MetroAreaDemographicReportColumn" nillable="true" type="tns:MetroAreaDemographicReportColumn"/>
Values

Value Description

AccountName

The account name.

AccountNumber

The account number.

AdDistribution

The name of the ad distribution medium.

AdGroupName

The name of the ad group.

AverageCpc

The average cost-per-click (CPC).

AverageCpm

The cost-per-thousand-impressions.

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

CampaignName

The campaign name.

Clicks

The number of times the ad was clicked.

Country

The country/region that an item applies to.

Ctr

The click-through rate (CTR).

CurrencyCode

The currency code.

Impressions

The number of impressions.

Hour

The hour that an item applies to.

LanguageAndRegion

The language and country/region.

MetroArea

The metropolitan area that an item applies to.

Spend

The total amount spent for the time period.

State

The state that an item applies to.

TimePeriod

The time period of each report row.

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

Required Columns

The columns in the following table will always be contained in a metropolitan area demographic report.

Column

AccountName

AdGroupName

Optional Columns

The columns in the following table can optionally be contained in a metropolitan area demographic report.

Column

AccountNumber

AdDistribution

AverageCpc

AverageCpm

AveragePosition

CampaignName

Clicks

Country

Ctr

CurrencyCode

Impressions

Hour

LanguageAndRegion

MetroArea

Spend

State

TimePeriod

A metropolitan area demographic 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, a metropolitan area demographic 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

MetroAreaDemographicReportRequest Data Object

Page view tracker