Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

SearchCampaignChangeHistoryReportColumn Value Set

Defines the attribute columns that you can include in the SearchCampaignChangeHistoryReportRequest.

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

<xs:simpleType name="SearchCampaignChangeHistoryReportColumn">
  <xs:restriction base="xs:string">
    <xs:enumeration value="DateTime" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="ChangedBy" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdTitle" />
    <xs:enumeration value="AdDescription" />
    <xs:enumeration value="DisplayUrl" />
    <xs:enumeration value="Keyword" />
    <xs:enumeration value="ItemChanged" />
    <xs:enumeration value="AttributeChanged" />
    <xs:enumeration value="HowChanged" />
    <xs:enumeration value="OldValue" />
    <xs:enumeration value="NewValue" />
  </xs:restriction>
</xs:simpleType>

Values

Value

Description

AccountId

The Id element of an Account.

AccountName

The Name element of an Account.

AccountNumber

The Number element of an Account.

AdDescription

The Text element of a MobileAd or TextAd.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Ad.

AdGroupId

The Id element of an AdGroup.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Ad , Ad group, or Keyword.

AdGroupName

The Name element of an AdGroup.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Ad , Ad group, or Keyword.

AdTitle

The Title element of a MobileAd or TextAd.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Ad.

AttributeChanged

Identifies the attribute or property of the entity from the ItemChanged column that changed.

For a list of elements whose change history is reported, see the Attribute Changed column within SearchCampaignChangeHistoryReportColumn Remarks.

System_CLiX_noteNote

This column is empty if a campaign, ad group, or ad entity was added or deleted.

CampaignId

The Id element of a Campaign.

CampaignName

The Name element of a Campaign.

ChangedBy

The username of the user that made the change to settings within the account. If the system made the change, the value will be Administrator.

DateTime

The date and time of the change. The date and time will be in the time zone of the campaign.

System_CLiX_noteNote

Prior to February 7, 2014, the date and time was relative to UTC.

DisplayUrl

The DisplayUrl element of a MobileAd or TextAd.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Ad.

HowChanged

The value that indicates whether the element was added, updated, or deleted. For possible values, see ChangeTypeReportFilter.

For adds, the NewValue column contains the added entity. For deletes, the OldValue column contains the deleted entity. For updates, the NewValue column contains the new value and the OldValue column contains the old value.

If an entity which has a delivery status property was added, for example a campaign, the value of HowChanged is Added. To report a deleted entity, the ItemChanged field is Status, the HowChanged field is Changed, and the NewValue field is Deleted.

Associating a target with a campaign or ad group will be reported as an add change. The AttributeChanged column will identify the target types contained in the target object. Updates to a target object will be reported as a delete change and an add change. Removing a campaign’s or ad group’s association with a target object will be reported as a delete change.

ItemChanged

The value that identifies the entity that changed. For possible entity values, see the Entity column within SearchCampaignChangeHistoryReportColumn Remarks.

If the change is an update to an element of the entity or is related to a target associated with a campaign or ad group, the AttributeChanged column contains the element of the entity that changed or the type of target that was changed.

Keyword

The Text element of a Keyword.

System_CLiX_noteNote

This column will be empty if ItemChanged is not Keyword.

NewValue

The value after the change. For more information, see the HowChanged column.

OldValue

The value before the change. For more information, see the HowChanged column.

Required Columns

The report must include the following column.

Column

DateTime

Remarks

The following are the entity types whose change history is reported.

System_CLiX_noteNote

If the AttributeChanged field is blank or empty, and the HowChanged field is Added or Deleted, then the contents of the NewValue or OldValue field represents an element of the entity that was added or deleted, respectively. For example if a keyword is added, the NewValue field contains the keyword text.

Account

When the ItemChanged field's value is Account, change history for the following attributes are available.

Attribute Changed

Description

None (blank)

Refers to the name of the account that was added.

System_CLiX_noteNote

The value of the corresponding HowChanged field is Added.

Account

Refers to the name of the account that was changed.

Agency contact

Refers to the name of the agency contact.

Sales house customer

Refers to the sales house customer.

Bill-to customer

Refers to the bill-to customer

Financial status

Refers to the financial status

Lock status

Refers to the lock status

Payment option

Refers to the payment option

Preferred bill-to payment method

Refers to the preferred bill-to payment method

Preferred language

Refers to the preferred language

Sold-to payment method

Sold-to payment method

Status

Refers to the account status.

Preferred user

Refers to the preferred user

Spend limit

Refers to the spend limit

Ad group

When the ItemChanged field's value is Ad group, change history for the following attributes are available.

Attribute Changed

Description

None (blank)

Refers to the name of the ad group that was added.

System_CLiX_noteNote

The value of the corresponding HowChanged field is Added.

Ad group

Refers to the name of the ad group that was changed.

Age

Refers to the age target

Day

Refers to the day target.

Default broad match bid

Refers to the default broad match bid

Default content match bid

Refers to the default content match bid

Default exact match bid

Refers to the default exact match bid

Default phrase match bid

Refers to the default phrase match bid

Device

Refers to the defers to the device target.

End date

Refers to the scheduled end date for the ad group.

Gender

Refers to the gender target.

Hour

Refers to the hour target.

Location

Refers to the location target.

Location exclusion

Refers to excluding locations from a location target.

Medium

Refers to the Search or Content ad distribution.

Negative keyword

Refers to a negative keyword associated with the ad group.

System_CLiX_noteNote

Updates to negative keywords are reported as a deleted and added change in two rows. The deleted record corresponds to the old value, and the added record reflects the new value.

Pause status

Refers to the any of the paused states of the ad group.

Site Exclusion

Refers to the ad group’s negative site URLs.

Status

Refers to the delivery status of the ad group.

System_CLiX_noteNote

If reporting a deleted ad group, the ItemChanged field is Status, the HowChanged field is Changed, and the NewValue field is Deleted.

Call extension

When the ItemChanged field's value is Call extension, change history for the following attributes are available.

Attribute Changed

Description

Association

Refers to the association of a call extension with an entity.

For example if the extension is associated with a campaign, CampaignName field's value is the name of the associated campaign, the ItemChanged field's value is Call extension, the AttributeChanged field's value is Association, and the HowChanged field's value is Added.

Country/region

Refers to the country/region of the call extension.

Phone Number

Refers to the phone number of the call extension.

Show website or phone

Refers to whether the website should be displayed with the phone number of the call extension. Possible values in the OldValueNewValue columns are Phone and Website and phone.

Use forward number

Refers to whether forwarding is set up for the call extension. Possible values in the OldValueNewValue columns are No and Yes.

Campaign

When the ItemChanged field's value is Campaign, change history for the following attributes are available.

Attribute Changed

Description

None (blank)

Refers to the name of the campaign that was added.

System_CLiX_noteNote

The value of the corresponding HowChanged field is Added.

Age

Refers to the age target.

Budget type

Refers to the campaign budget type.

Possible values in the OldValueNewValue columns are as follows:

  • Value of Daily target (accelerated) corresponds to the Bing Ads web application Daily Accelerated setting.

  • Value of Daily target (standard) corresponds to the Bing Ads web application Daily Standard setting.

  • Value of Monthly (open) corresponds to the Bing Ads web application Monthly setting.

Daily budget

Refers to the campaign daily budget amount.

Day

Refers to the day target.

Device

Refers to the device target.

End date

For internal use.

Gender

Refers to the gender target.

Hour

Refers to the hour target.

IP exclusion

Refers to the IP exclusions created via the Bing Ads web application.

Location

Refers to the location target.

Location exclusion

Refers to excluding locations from a location target.

Monthly budget

Refers to the campaign monthly budget amount.

Name

Refers to the name of the campaign that was changed.

Negative keyword

Refers to a negative keyword associated with the campaign.

System_CLiX_noteNote

Updates to negative keywords are reported as a deleted and added change in two rows. The deleted record corresponds to the old value, and the added record reflects the new value.

Pause status

Refers to the any of the paused states of the campaign.

Possible values in the OldValueNewValue columns are as follows:

  • Budget Paused

  • Not paused

Site Exclusion

Refers to the campaign’s negative site URLs.

Start date

For internal use.

Status

Refers to the delivery status of the campaign.

System_CLiX_noteNote

If reporting a deleted campaign, the ItemChanged field is Status, the HowChanged field is Changed, and the NewValue field is Deleted.

Keyword

When the ItemChanged field's value is Keyword, change history for the following attributes are available.

Attribute Changed

Description

None (blank)

Refers to the text of the keyword that was added.

System_CLiX_noteNote

The value of the corresponding HowChanged field is Added.

Broad match bid

Refers to the broad match bid amount for the keyword.

Content match bid

Refers to the content match bid amount for the keyword.

Editorial status

System_CLiX_noteNote

If the keyword is pending offline editorial review, then within a downloaded change history report the editorial status is represented as either Pending – Active or Pending – Inactive. For more information, see Entities and Delivery Status.

Exact match bid

Refers to the exact match bid amount for the keyword.

Match type

Refers to the bid match type for the keyword.

System_CLiX_noteNote

The bid match type cannot be updated using Bing Ads API; however, it is possible to change the bid match type using the Bing Ads web application.

Phrase match bid

Refers to the phrase match bid amount for the keyword.

Status

Refers to the delivery status of the keyword.

System_CLiX_noteNote

If reporting a deleted keyword, the ItemChanged field is Status, the HowChanged field is Changed, and the NewValue field is Deleted.

Sitelink extension

When the ItemChanged field's value is Sitelink extension, change history for the following attributes are available.

Attribute Changed

Description

Association

Refers to the association of a sitelink extension with an entity.

For example if the extension is associated with a campaign, CampaignName field's value is the name of the associated campaign, the ItemChanged field's value is Sitelink extension, the AttributeChanged field's value is Association, and the HowChanged field's value is Added.

Destination URL

Refers to the destination URL of the sitelink extension.

Display Text

Refers to the display text of the sitelink extension.

User

When the ItemChanged field's value is User, change history for the following attributes are available.

Attribute Changed

Description

None (blank)

Refers to the user name of the user that was added.

System_CLiX_noteNote

The value of the corresponding HowChanged field is Added.

Code

For internal use.

Email

Refers to the contact email address of the user.

First name

Refers to the first name of the user.

Last name

Refers to the last name of the user.

Status

Refers to the status of the user.

Requirements

ReportingService.svc v9

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

Community Additions

ADD
Show:
© 2015 Microsoft