RichAdComponentPerformanceReportColumn Value Set

 

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

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 Reporting Data Retention Time Periods.

<xs:simpleType name="RichAdComponentPerformanceReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="AdId" />
    <xs:enumeration value="AdTitle" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="RichAdSubType" />
    <xs:enumeration value="ComponentType" />
    <xs:enumeration value="ComponentTitle" />
    <xs:enumeration value="ComponentDestinationURL" />
    <xs:enumeration value="ComponentClicks" />
    <xs:enumeration value="ComponentNonBillableClicks" />
    <xs:enumeration value="ComponentTotalClicks" />
    <xs:enumeration value="ComponentCTR" />
    <xs:enumeration value="AccountStatus"/>
    <xs:enumeration value="CampaignStatus"/>
    <xs:enumeration value="AdGroupStatus"/>
    <xs:enumeration value="AdStatus"/>
  </xs:restriction>
</xs:simpleType>

ValueDescription
AccountIdThe Bing Ads assigned identifier of an account.
AccountNameThe account name.
AccountNumberThe Bing Ads assigned number of an account.
AccountStatusThe account status.
AdGroupIdThe Bing Ads assigned identifier of an ad group.
AdGroupNameThe ad group name.
AdGroupStatusThe ad group status.
AdIdThe Bing Ads assigned identifier of an ad.
AdStatusThe ad status.
AdTitleThe ad title.
CampaignIdThe Bing Ads assigned identifier of a campaign.
CampaignNameThe campaign name.
CampaignStatusThe campaign status.
ComponentClicks

The number of billable clicks of a rich ad. The count includes the first click of a component of the ad and subsequent clicks on the impression if the user waits a short, system-defined interval between clicks. If a subsequent click occurs within the interval, the click may be included in the ComponentNonBillableClicks column.

If you include the ComponentType column, the click count is broken down by the components of the ad that were clicked.

ComponentCTR

The click-through rate of all components of the ad that were clicked.

The formula for calculating the click-through rate is ((ComponentTotalClicks / Impressions) * 100.

ComponentDestinationURLThe destination URL of the rich ad component.
ComponentNonBillableClicksThe number of clicks that occur on different components of the ad after the first click but within the short, system-defined interval. Successive clicks on the same component within the system-defined interval are not counted.
ComponentTitleThe title of the rich ad component. The ComponentType column identifies the component.
ComponentTotalClicksThe number of times that all components of the ad were clicked. This is the sum of the ComponentClicks and ComponentNonBillableClicks columns.
ComponentTypeThe component type of the rich ad that was clicked. For possible values, see ComponentTypeFilter Value Set.
RichAdSubTypeThe rich ad component type.
TimePeriod

The time period of each report row.

Note: 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.

The report must include the following column.

Column
AdTitle
TimePeriod

Note: This column is required for all aggregation types except Summary.

The report must also include one or more of the performance statistics columns available with this value set. For more information, see Report Attributes and Performance Statistics.

ReportingService.svc v9

Namespace: https://bingads.microsoft.com/Reporting/v9

RichAdComponentPerformanceReportRequest

Show: