Edit

BudgetSummaryReportColumn Value Set - Reporting

  • Article

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

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="BudgetSummaryReportColumn" 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="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="Date" />
    <xs:enumeration value="CurrencyCode" />
    <xs:enumeration value="MonthlyBudget" />
    <xs:enumeration value="DailySpend" />
    <xs:enumeration value="MonthToDateSpend" />
  </xs:restriction>
</xs:simpleType>

Values

The BudgetSummaryReportColumn value set has the following values: AccountId, AccountName, AccountNumber, CampaignId, CampaignName, CurrencyCode, DailySpend, Date, MonthlyBudget, MonthToDateSpend.

Value Description
AccountId The Microsoft Advertising assigned identifier of an account.
AccountName The account name.
AccountNumber The Microsoft Advertising assigned number of an account.
CampaignId The Microsoft Advertising assigned identifier of a campaign.
CampaignName The campaign name.
CurrencyCode The account currency type. For possible values, see Currencies.
DailySpend The average amount of campaign budget spent per day.
Date The date for the downloaded report records. The date will be in the time zone of the campaign
MonthlyBudget The anticipated maximum monthly budget amount that was calculated on the date of the most recent budget change.

The formula used to forecast the maximum budget for each calendar month is Spend-to-date + (daily budget x days remaining). For example, let's say your daily campaign budget was 100.00 at the beginning of July and then was updated to 200.00 right at the start of July 22nd. Let's also assume a month to date spend through July 21st of 500.00. In August when you run a report for the month of July, the monthly budget value for each day from July 1 through July 21 will be 3,100. The monthly budget value in the report for each day from July 22nd through July 31st will be 2,500.00. For more information see the What are my budget options? help page.
MonthToDateSpend The amount of money spent to date for the month.

Remarks

Required Columns

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

Column
AccountName
AccountNumber
CampaignName
CurrencyCode
Date

Requirements

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

Used By

BudgetSummaryReportRequest