AgeGenderAudienceReportColumn Value Set - Reporting

Defines the attributes and performance statistics columns that you can include in the AgeGenderAudienceReportRequest.

The attribute columns that you include in a report can affect how the statistics are aggregated. In other words the number of rows increase by a factor of the unique attributes. For more information, see Columns that Group the Data.

For a list of columns that you must include, please see the Required Columns section below.

To see how far back hourly, daily, weekly, monthly, yearly and summary aggregated data can be retrieved for a report, see Report Data Retention Time Periods.

Syntax

<xs:simpleType name="AgeGenderAudienceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdDistribution" />
    <xs:enumeration value="AgeGroup" />
    <xs:enumeration value="Gender" />
    <xs:enumeration value="Impressions" />
    <xs:enumeration value="Clicks" />
    <xs:enumeration value="Conversions" />
    <xs:enumeration value="Spend" />
    <xs:enumeration value="Revenue" />
    <xs:enumeration value="ExtendedCost" />
    <xs:enumeration value="Assists" />
    <xs:enumeration value="Language" />
    <xs:enumeration value="AccountStatus" />
    <xs:enumeration value="CampaignStatus" />
    <xs:enumeration value="AdGroupStatus" />
    <xs:enumeration value="BaseCampaignId" />
    <xs:enumeration value="AllConversions" />
    <xs:enumeration value="AllRevenue" />
    <xs:enumeration value="ViewThroughConversions" />
    <xs:enumeration value="Goal" />
    <xs:enumeration value="GoalType" />
  </xs:restriction>
</xs:simpleType>

Values

The AgeGenderAudienceReportColumn value set has the following values: AccountId, AccountName, AccountNumber, AccountStatus, AdDistribution, AdGroupId, AdGroupName, AdGroupStatus, AgeGroup, AllConversions, AllRevenue, Assists, BaseCampaignId, CampaignId, CampaignName, CampaignStatus, Clicks, Conversions, ExtendedCost, Gender, Goal, GoalType, Impressions, Language, Revenue, Spend, TimePeriod, ViewThroughConversions.

Value Description
AccountId The Microsoft Advertising assigned identifier of an account.
AccountName The account name.
AccountNumber The Microsoft Advertising assigned number of an account.
AccountStatus The account status.
AdDistribution The network where you want your ads to show.
AdGroupId The Microsoft Advertising assigned identifier of an ad group.
AdGroupName The ad group name.
AdGroupStatus The ad group status.
AgeGroup The age group of the audience who viewed the ad. The possible values are 13-17, 18-24, 25-34, 35-49, 50-64, and 65+.
AllConversions The number of conversions.

A conversion is the completion of an action by a customer after viewing your ad. The action could be purchasing your product, registering for your webinar, joining an organization, or whatever you consider your goal and best measure of the ad's success.

Conversions are measured by adding a small bit of code to your website pages so that a visitor's progress through your site can be tracked.

Data will be excluded from the Conversions report column for any conversion goal with the ExcludeFromBidding property set to true. The AllConversions column will include data for all conversion goals regardless of their ExcludeFromBidding setting.

Available for accounts that are setup to use analytics with Microsoft Advertising Universal Event Tracking. For more information, see the Track sales and other conversions help topic.
AllRevenue The revenue optionally reported by the advertiser as a result of conversions.

Data will be excluded from the Revenue report column for any conversion goal with the ExcludeFromBidding property set to true. The AllRevenue column will include data for all conversion goals regardless of their ExcludeFromBidding setting.

Available for accounts that are setup to use analytics with Microsoft Advertising Universal Event Tracking. For more information, see the Track sales and other conversions help topic.
Assists The number of times an entity (an account, campaign, ad group, or keyword, for example) contributed to a conversion that is associated with a different entity.
A report on this data shows you how often one keyword assists a conversion on another keyword. This helps you identify which campaigns are dependent on assists for their conversion value.
BaseCampaignId The Microsoft Advertising assigned identifier of an experiment campaign.

This will be the same value as the CampaignId if the campaign is not an experiment.
CampaignId The Microsoft Advertising assigned identifier of a campaign.
CampaignName The campaign name.
CampaignStatus The campaign status.
Clicks Clicks are what you pay for.
Clicks typically include a customer clicking an ad on a search results page or on a website on the search network. Clicks can also come from other sources (for example, spiders, robots, and test servers).
You pay for clicks on standard-quality clicks, not on low-quality or invalid clicks.
Conversions The number of conversions.

A conversion is the completion of an action by a customer after viewing your ad. The action could be purchasing your product, registering for your webinar, joining an organization, or whatever you consider your goal and best measure of the ad's success.

Conversions are measured by adding a small bit of code to your website pages so that a visitor's progress through your site can be tracked.

Data will be excluded from the Conversions report column for any conversion goal with the ExcludeFromBidding property set to true. The AllConversions column will include data for all conversion goals regardless of their ExcludeFromBidding setting.

Available for accounts that are setup to use analytics with Microsoft Advertising Universal Event Tracking. For more information, see the Track sales and other conversions help topic.
ExtendedCost Cost information that is optionally provided by advertisers, including non-advertising costs, taxes, and shipping.
Gender The gender (male or female) of the search users to whom the ad was delivered.
Goal The name of the goal you set for the conversions you want, meaning actions customers take after clicking your ad.
GoalType The type of conversion goal.
Possible values include AppInstall, Duration, Event, InStoreTransaction, OfflineConversion, PagesViewedPerVisit, and Url.
Impressions The number of times an ad has been displayed on search results pages or other sites on the Audience Network.
Regardless of whether you are driving customers to your website, tracking conversions, or just trying to get your message out, you want to track the number of times your ad is shown.
Run the share of voice report to get an estimate of how many more impressions you could be getting.
Language This is the language of the country the ad is served in.
Revenue The revenue optionally reported by the advertiser as a result of conversions.

Data will be excluded from the Revenue report column for any conversion goal with the ExcludeFromBidding property set to true. The AllRevenue column will include data for all conversion goals regardless of their ExcludeFromBidding setting.

Available for accounts that are setup to use analytics with Microsoft Advertising Universal Event Tracking. For more information, see the Track sales and other conversions help topic.
Spend The sum of your cost-per-click (CPC) charges for your ads and keywords.
Spend helps you keep track of your budget.
TimePeriod The time period of each report row. You may not include this column if the Aggregation element of the request object is set to Summary. If you include the TimePeriod column, the column label in the downloaded report depends on the aggregation level that you specify in the report request. For more information, see Time Period Column.
ViewThroughConversions View-through conversions are conversions that people make after they have seen your ad, even though they did not click the ad.

View-through conversions don't have a click associated but do have an impression associated within the advertiser defined conversion window. If the user also clicked on an ad that was delivered via the Microsoft Audience or Search network, there won't be any view-through conversion counted. Only the click-based conversion would be counted.

View-through conversions are only counted for ads in the Microsoft Audience network.

Not everyone has view-through conversions yet. If you don't, don't worry. It's coming soon.

Remarks

Required Columns

The report must include the following columns. As a general rule, each report must include at least one non-impression share attribute column and at least one performance statistics column. For more information, see Report Attributes and Performance Statistics.

Note

The TimePeriod column is expected for all aggregation types except Summary. It is important to note that if you do not include TimePeriod, the aggregation you chose will be ignored and Summary aggregation will be used regardless.

Column
AccountName
AdGroupName
AgeGroup
Gender
TimePeriod

Requirements

Service: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

Used By

AgeGenderAudienceReportRequest