Campaign Record - Bulk

Defines a campaign that can be uploaded and downloaded in a bulk file.

Important

The accelerated budget type is deprecated. Please see Deprecating Accelerated Budget Delivery for more information.

You can download all Campaign records in the account by including the DownloadEntity value of Campaigns in the DownloadCampaignsByAccountIds or DownloadCampaignsByCampaignIds service request. Additionally the download request must include the EntityData scope. To include the Keyword Relevance, Landing Page Relevance, Landing Page User Experience, and Quality Score fields within the downloaded Campaign records, you must also include the QualityScoreData scope. For more details about the Bulk service including best practices, see Bulk Download and Upload.

The following Bulk CSV example would add one Search campaign.

Type,Status,Id,Parent Id,Campaign,Website,Client Id,Modified Time,Time Zone,Budget Id,Budget Name,Budget,Budget Type,Bid Adjustment,Name,Country Code,Store Id,Campaign Type,Language,Target Setting,Priority,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type,Domain Language,Source
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,,
Campaign,Active,-111,0,Women's Shoes,,ClientIdGoesHere,,PacificTimeUSCanadaTijuana,,,50,DailyBudgetStandard,10,,,,Search,All,Audience,,,,{_promoCode}=PROMO1; {_season}=summer,EnhancedCpc,,

If you are using the Bing Ads SDKs for .NET, Java, or Python, you can save time using the BulkServiceManager to upload and download the BulkCampaign object, instead of calling the service operations directly and writing custom code to parse each field in the bulk file.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaign
var bulkCampaign = new BulkCampaign
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Campaign object of the Campaign Management service.
    Campaign = new Campaign
    {
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new EnhancedCpcBiddingScheme { },
        // 'Budget Id' column header in the Bulk file
        BudgetId = null,
        // 'Budget Type' column header in the Bulk file
        BudgetType = BudgetLimitType.DailyBudgetStandard,
        // 'Campaign Type' column header in the Bulk file
        CampaignType = CampaignType.Search,
        // 'Budget' column header in the Bulk file
        DailyBudget = 50,
        // 'Experiment Id' column header in the Bulk file
        ExperimentId = null,
        // 'Id' column header in the Bulk file
        Id = campaignIdKey,
        // 'Language' column header in the Bulk file
        Languages = new string[] { "All" },
        // 'Campaign' column header in the Bulk file
        Name = "Women's Shoes",
        // 'Bid Adjustment' column header in the Bulk file
        AudienceAdsBidAdjustment = 10,
        Settings = new Setting[] 
        {
            // 'Target Setting' column header in the Bulk file
            new TargetSetting
            {
                // Each target setting detail is delimited by a semicolon (;) in the Bulk file
                Details = new TargetSettingDetail[]
                {
                    new TargetSettingDetail
                    {
                        CriterionTypeGroup = CriterionTypeGroup.Audience,
                        TargetAndBid = false
                    }
                }
            }
        },
        // 'Status' column header in the Bulk file
        Status = CampaignStatus.Active,
        // 'Sub Type' column header in the Bulk file
        SubType = null,
        // 'Time Zone' column header in the Bulk file
        TimeZone = "PacificTimeUSCanadaTijuana",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] 
            {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            },
        },
    },
};

uploadEntities.Add(bulkCampaign);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

For a Campaign record, the following attribute fields are available in the Bulk File Schema.

Column Header Supported Campaign Types
Bid Adjustment All
Bid Strategy MaxCpc Search
DynamicSearchAds
Bid Strategy TargetCpa Search
DynamicSearchAds
Bid Strategy Type All
Budget All
Budget Id All
Budget Name All
Budget Type All
Campaign All
Campaign Type All
Client Id All
Country Code Shopping
Domain Language DynamicSearchAds
Experiment Id Search
Final Url Suffix All
Id All
Keyword Relevance All
Landing Page Relevance All
Landing Page User Experience All
Language All
LocalInventoryAdsEnabled Shopping
Modified Time All
Page Feed Ids DynamicSearchAds
Parent Id All
Priority Shopping
Quality Score All
Source DynamicSearchAds
Status All
Store Id Audience
Shopping
Sub Type Shopping
Target Setting All
Time Zone All
Tracking Template All
Website DynamicSearchAds

Bid Adjustment

The percent amount by which to adjust your bid for audience ads above or below the base ad group or keyword bid.

Note

This property is available in Search campaigns if the customer is enabled for the Microsoft Audience Network.

Supported values are negative one hundred (-100) through positive nine hundred (900). Setting the bid adjustment to -100 percent will prevent audience ads from showing for this campaign.

Set this field to zero (0) if you do not want any bid adjustment for audience ads.

Add: Optional. If you do not set this field the system default bid adjustment will be used. The system default bid adjustment is currently zero (0), and is subject to change.
Update: Optional. If no value is set for the update, this setting is not changed. If you set this field to the delete_value string, the prior setting is removed. If you set this field to delete_value then effectively the system default bid adjustment will be used. The system default bid adjustment is currently zero (0), and is subject to change.
Delete: Read-only

Bid Strategy MaxCpc

The maximum cost per click that you want to spend with the corresponding bid strategy type.

This field is only used if the Bid Strategy Type field is set to MaxClicks, MaxConversions, or TargetCpa, and otherwise this field is ignored.

Note

The MaxClicks bid strategy is available for Dynamic Search Ads and Search campaigns.

The MaxConversions bid strategy is available for Dynamic Search Ads and Search campaigns. All of your target locations must be within Australia, Canada, France, Germany, United Kingdom, and/or United States. For some customers, available target locations also include Italy, Netherlands, Spain, Sweden, and Switzerland. If you are unable to target these locations at this time, try again later.

The TargetCpa bid strategy is available for Dynamic Search Ads and Search campaigns. All of your target locations must be within Australia, Canada, France, Germany, United Kingdom, and/or United States. For some customers, available target locations also include Italy, Netherlands, Spain, Sweden, and Switzerland. If you are unable to target these locations at this time, try again later.

For more details, see Budget and Bid Strategies.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed. If you set this field to the delete_value string, the prior setting is removed.
Delete: Read-only

Bid Strategy TargetCpa

The target cost per acquisition (CPA) that you want used by Microsoft Advertising to maximize conversions.

This field is only used if the Bid Strategy Type field is set to TargetCpa, and otherwise this field is ignored.

Note

The TargetCpa bid strategy is available for Dynamic Search Ads and Search campaigns. All of your target locations must be within Australia, Canada, France, Germany, United Kingdom, and/or United States. For some customers, available target locations also include Italy, Netherlands, Spain, Sweden, and Switzerland. If you are unable to target these locations at this time, try again later.

For more details, see Budget and Bid Strategies.

Add: Required if the Bid Strategy Type field is set to TargetCpa, and otherwise this field is ignored.
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only

Bid Strategy Type

The bid strategy type for how you want to manage your bids. A bid strategy type set at the Ad Group or Keyword level will take precedence over the campaign level bid strategy type.

For details about supported bid strategies per campaign type, see Budget and Bid Strategies.

  • EnhancedCpc - Use the enhanced CPC bid strategy type to set your ad group and keyword bids, and Microsoft Advertising will automatically adjust your bids in real time to increase your chances for a conversion. Your bid will go higher on searches that are more likely to convert and lower on searches less likely to convert (up or down, this change will be made after we apply any bid adjustments you have set). Over the long haul, though, we will try to make sure that your average CPC is not higher than your bid. If you haven't optimized your campaign yet, Enhanced CPC should reduce your cost per conversion and increase your total conversion count while respecting your current budget. Differing from the MaxClicks, MaxConversions, and TargetCpa bid strategies, with the EnhancedCpc bid strategy, Microsoft Advertising will not actually change your stored ad group or keyword bid settings. You can continue to set new bids, and we will use the new values as a starting point next opportunity.
  • ManualCpc - Use the manual CPC bid strategy type if you will set your Ad Group or Keyword bids, and Microsoft Advertising will use these bids every time.
  • MaxClicks - Defines an automated bidding strategy to maximize clicks given your maximum allowed budget.
  • MaxConversions - Defines an automated bidding strategy to maximize conversions given your maximum allowed budget.
  • TargetCpa - Defines an automated bidding strategy to maximize conversions at the target cost per acquisition (CPA). If you use this strategy type then you must also include the Bid Strategy TargetCpa field.

Important

If the campaign bid strategy type is set to MaxClicks, MaxConversions, or TargetCpa, the behavior of existing features will change unless you set an individual ad group's or keyword's bid strategy to ManualCpc.

  • You can continue to set the ad group and keyword bids; however they will not be used by Microsoft Advertising.
  • Microsoft Advertising will periodically change your stored ad group or keyword bid settings. You can continue to set new bids, however Microsoft Advertising may change them at any time using this bid strategy type.
  • You can continue to set bid adjustments e.g. for age, gender, or location; however, the multiplier will inform rather than directly modify or override the automated bid. For auto bidding the multiplier is used as a weighted percentage to inform Microsoft Advertising about how much you value the criterion relative to other criteria. For example, a -50% bid multiplier for a mobile device criterion with the Max Conversions bid strategy to indicate that you value conversions from mobile traffic half as much as other device types. The same bid multiplier with the Max Clicks bid strategy would indicate that you value clicks on mobile half as much as other device types. The valid range of values that you can use to inform auto bidding is -100.00 through 30.00.

Also note that you must have conversion tracking (via Universal Event Tracking tag and a conversion goal) set up for the MaxConversions and TargetCpa bid strategy types to work. To set the MaxConversions or TargetCpa bid strategy types, the campaign must have at least 15 conversions in the last 30 days. If you try to add or update a campaign to use one of these strategy types, the requested operation will fail if there is not enough conversion history. If an active campaign uses one of these bid strategy types, and then ceases to meet the minimum conversion history requirement at any time, Microsoft Advertising will stop auto bidding but will continue to use the DailyBudgetStandard budget type. For a new campaign we recommend that you start with EnhancedCpc and then when the campaign has enough conversion history, you can update it to use either the MaxConversions or TargetCpa bid strategy.

Tip

You can set your campaign's bid strategy to EnhancedCpc, MaxClicks, MaxConversions, or TargetCpa and then, at any time, set an individual ad group's or keyword's bid strategy to ManualCpc.

Add: Optional. The default value for Search and DynamicSearchAds campaigns is EnhancedCpc. The default value for Shopping campaigns is ManualCpc. The only supported value for Audience campaigns is ManualCpc.
Update: Optional. If no value is set for the update, this setting is not changed. If you update the bid strategy type, then any existing values in the Bid Strategy MaxCpc and Bid Strategy TargetCpa fields will be deleted.
Delete: Read-only

Budget

The campaign's budget amount.

Warning

Your budget is a target; your actual spend might be higher or lower. Variations are caused by a number of factors, such as different traffic volumes in different days of the week, or automatic detection and refunding of fraud clicks that can give money back to a campaign within a few hours of the click. Microsoft Advertising anticipates and automatically compensates for the fluctuations, and usually keeps overspend to less than 100% above your daily limit.

Also note that Microsoft Advertising does not require your campaign budget to be higher than the ad group and keyword bids. In other words ad group and keyword bids are validated independently of the campaign budget.

In the context of shared budgets, the budget amount is a read-only property that is always returned regardless of whether or not the campaign uses a shared budget. When a campaign is associated to a shared budget the amount returned is that of the shared budget. To determine whether the campaign uses a shared budget, check the value of the Budget Id field.

With experiment campaigns you cannot update the Budget, Budget Type, Status, or Time Zone. The budget, status, and time zone of an experiment campaign are always inherited from the base campaign settings.

Add: Required if the Budget Id is not set. Read-only if the campaign uses a shared budget.
Update: Optional if the BudgetId is not set. If no value is set for the update, this setting is not changed. Not allowed if the campaign uses a shared budget. If you try to update the budget amount of a campaign that has a shared budget, the service will return the CampaignServiceCannotUpdateSharedBudget error code.
Delete: Read-only

Budget Id

The system generated identifier of the Budget that this campaign shares with other campaigns in the account.

If the field is empty, then the campaign is not using a shared budget. If the field is not empty and the value is greater than zero, then the campaign is using a shared budget. If the campaign is using a shared budget, and you prefer that it use its own budget amount, set this field to '0' (zero) and set the Budget field to a valid budget amount.

Note

This value corresponds to the Id field of the Budget record.

Add: Optional. You can either specify an existing campaign identifier, or specify a negative identifier that is equal to the Id field of a Budget record. This is recommended if you are applying a new shared budget to a new campaign in the same Bulk file. For more information, see Bulk File Schema Reference Keys.
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only

Budget Name

The name of the shared budget.

This value corresponds to the Budget Name field of the Budget record. You can only set this value using the Budget record.

Add: Read-only
Update: Read-only
Delete: Read-only

Budget Type

The budget type determines how the budget is spent. The possible values are DailyBudgetAccelerated and DailyBudgetStandard.

Important

The accelerated budget type is deprecated. Please see Deprecating Accelerated Budget Delivery for more information.

In the context of shared budgets, the budget type is a read-only property that is always returned regardless of whether or not the campaign uses a shared budget. To determine whether the campaign uses a shared budget, check the value of the Budget Id field.

With experiment campaigns you cannot update the Budget, Budget Type, Status, or Time Zone. The budget, status, and time zone of an experiment campaign are always inherited from the base campaign settings.

Add: Required if the Budget Id is not set. Read-only if the campaign uses a shared budget.
Update: Optional if the BudgetId is not set. If no value is set for the update, this setting is not changed. Not allowed if the campaign uses a shared budget. If you try to update the budget type of a campaign that has a shared budget, the service will return the CampaignServiceCannotUpdateSharedBudget error code.
Delete: Read-only

Campaign

The name of the campaign.

Add: Required
Update: Read-only and Required
Delete: Read-only and Required

Note

For update and delete, you must specify either the Id or Campaign field.

Campaign Type

The type of the campaign.

The campaign type determines whether the campaign is a Microsoft Shopping campaign, Dynamic Search Ads campaign, or Search campaign. Possible values include Audience, DynamicSearchAds, Shopping, and Search.

Add: Required for Audience campaigns, and otherwise this field is optional. If not specified, then default value of Search is used and you cannot set Audience, Dynamic Search Ads, or Shopping campaign settings. If the campaign type is Shopping then you must also include the Country Code, Priority, and Store Id fields. If the campaign type is DynamicSearchAds then you must also include the Domain Language and Website fields.
Update: Read-only
Delete: Read-only

Client Id

Used to associate records in the bulk upload file with records in the results file. The value of this field is not used or stored by the server; it is simply copied from the uploaded record to the corresponding result record. It may be any valid string to up 100 in length.

Add: Optional
Update: Optional
Delete: Read-only

Country Code

The country code for the Microsoft Merchant Center store.

The Microsoft Merchant Center store catalog will be filtered to only include products for the specified country.

For example, the following country code values are supported.

  • AU - Australia
  • GB - United Kingdom
  • DE - Germany
  • FR - France
  • US - United States

To get the current list of supported country codes use the GetBSCCountries operation via the Campaign Management service.

Add: Required if the Campaign Type field is set to Shopping. You cannot include this column for other campaign types.
Update: Read-only
Delete: Read-only

Custom Parameter

Your custom collection of key and value parameters for URL tracking.

In a bulk file, the list of custom parameters are formatted as follows.

  • Format each custom parameter pair as Key=Value, for example {_promoCode}=PROMO1.

  • Microsoft Advertising will accept the first 8 custom parameter key and value pairs that you include, and if you include more than 8 custom parameters an error will be returned. Each key and value pair are delimited by a semicolon and space ("; "), for example {_promoCode}=PROMO1; {_season}=summer.

  • A Key cannot contain a semicolon. If a Value contains a semicolon it must be escaped as ';'. Additionally if the Value contains a backslash it must also be escaped as '\'.

  • The Key cannot exceed 16 UTF-8 bytes, and the Value cannot exceed 250 UTF-8 bytes. The Key is required and the Value is optional. The maximum size of the Key does not include the braces and underscore i.e., '{', '_', and '}'.

    Note

    With the Bulk service the Key must be formatted with surrounding braces and a leading underscore, for example if the Key is promoCode, it must be formatted as {_promoCode}. With the Campaign Management service you cannot specify the surrounding braces and underscore.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed. To remove all custom parameters, set this field to delete_value. The delete_value keyword removes the previous setting. To remove a subset of custom parameters, specify the custom parameters that you want to keep and omit any that you do not want to keep. The new set of custom parameters will replace any previous custom parameter set.
Delete: Read-only

Domain Language

The language of the website pages that you want to target for dynamic search ads.

Your website language determines where your ads are eligible to appear. For example, a German-language ad can appear in Germany, Austria, and Switzerland, but not in Spain. The supported languages are English, French, and German. If your website contains pages in multiple languages and you want to advertise all of these pages, you should create a separate campaign for each language.

Note, if you set the campaign Language or ad group Language, they will be ignored.

Add: Required if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types.
Update: Read-only. You cannot update the domain language.
Delete: Read-only

Experiment Id

The system generated identifier of the Experiment.

This field is only set for experiment campaigns i.e., campaigns that have been created for A/B testing based on another Search campaign. Base campaigns will not contain an experiment ID. Likewise, after an experiment has been Graduated to an independent campaign, this field will be empty, even though the campaign was previously an experiment campaign.

With experiment campaigns you cannot update the Budget, Budget Type, Status, or Time Zone. The budget, status, and time zone of an experiment campaign are always inherited from the base campaign settings. If you want to change an experiment's budget, you will need to change the base campaign's budget. The change in value will then be split based on your experiment TrafficSplitPercent setting.

Add: Read-only
Update: Read-only
Delete: Read-only

Final Url Suffix

The final URL suffix can include tracking parameters that will be appended to the end of your landing page URL. We recommend placing tracking parameters that your landing page requires in a final URL suffix so that your customers are always sent to your landing page. For more details and validation rules see Final URL Suffix in the technical guides.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed. If you set this field to the delete_value string, the prior setting is removed.
Delete: Read-only

Id

The system generated identifier of the campaign.

Add: Optional. You must either leave this field empty, or specify a negative identifier. A negative identifier set for the campaign can then be referenced in the Parent Id field of dependent record types such as ad groups or criterion. This is recommended if you are adding new campaigns and new dependent records in the same Bulk file. For more information, see Bulk File Schema Reference Keys.
Update: Read-only and Required
Delete: Read-only and Required

Note

For update and delete, you must specify either the Id or Campaign field.

Keyword Relevance

A numeric score that indicates how likely your ads will be clicked and how well your keyword competes against other keywords targeting the same traffic. This score predicts whether your keyword is likely to lead to a click on your ads, taking into account how well your keyword has performed in the past relative to your ad's position.

Note

Keyword Relevance is equivalent to the Expected Click-Through Rate label used in the Microsoft Advertising web application.

A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average.

If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score.

Data for this column is typically updated 14-18 hours after the UTC day ends.

Add: Read-only
Update: Read-only
Delete: Read-only

Landing Page Relevance

A numeric score that indicates how relevant your ad and landing page are to the customer's search query or other input.

Note

Landing Page Relevance is equivalent to the Ad Relevance label used in the Microsoft Advertising web application.

A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average.

If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score.

Data for this column is typically updated 14-18 hours after the UTC day ends.

Add: Read-only
Update: Read-only
Delete: Read-only

Landing Page User Experience

A numeric score that indicates whether your landing page is likely to provide a good experience to customers who click your ad and land on your website.

Note

Landing Page User Experience is equivalent to the Landing Page Experience label used in the Microsoft Advertising web application.

A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average.

If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score.

Data for this column is typically updated 14-18 hours after the UTC day ends.

Add: Read-only
Update: Read-only
Delete: Read-only

Language

Your ad language setting determines the language you will use when you write your ads and should be the language of your customers.

Important

If languages are set at both the ad group and campaign level, the ad group level language will override the campaign level language.

The supported language strings for Search and Shopping campaigns are: All, Danish, Dutch, English, Finnish, French, German, Italian, Norwegian, Portuguese, Spanish, Swedish, and TraditionalChinese. Each language in this bulk field is delimited by a semicolon (";"), for example English;French;German. You can specify multiple languages individually in the list, or only include one language string in this field set to "All" if you want to target all languages.

For Audience campaigns you must include all languages i.e., set this field to "All".

For Dynamic Search Ads campaigns, the campaign and ad group level language settings are ignored in favor of the website domain language. You should set campaign languages to "All" and leave the ad group level language empty.

Add: Required for Audience campaigns, and otherwise this field is optional. If there is no campaign language set, then the language of each ad group within the campaign will be required.
Update: Optional. If no value is set for the update, this setting is not changed. Once campaign languages are set, you cannot delete all of them. The list of languages that you specify during update replaces the previous settings i.e. does not append to the existing set of languages.
Delete: Read-only

LocalInventoryAdsEnabled

Determines whether local inventory ads are enabled for the Microsoft Merchant Center store.

Not everyone has this feature yet. If you don't, don't worry. It's coming soon.

Set this property to TRUE if you want to enable local inventory ads, and otherwise set it to FALSE.

Add: Optional. If you do not specify this field or leave it empty, the default value of FALSE will be set and local inventory ads will not be enabled.
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only

Modified Time

The date and time that the entity was last updated. The value is in Coordinated Universal Time (UTC).

Note

The date and time value reflects the date and time at the server, not the client. For information about the format of the date and time, see the dateTime entry in Primitive XML Data Types.

Add: Read-only
Update: Read-only
Delete: Read-only

Page Feed Ids

The page feed identifiers for dynamic search ads.

Each page feed identifier is delimited in the Bulk file by a semicolon (";").

The Source determines whether or not Microsoft Advertising will use the associated page feeds.

Tip

See the Page Feeds technical guide for an implementation overview.

Add: Optional if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types.
Update: Optional if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types. If no value is set for the update, this setting is not changed. If you set this field to the delete_value string, the prior setting is removed.
Delete: Read-only

Parent Id

The system generated identifier of the account that contains the campaign.

This bulk field maps to the Id field of the Account record.

Add: Read-only and Required
Update: Read-only and Required
Delete: Read-only and Required

Priority

Helps determine which Microsoft Shopping campaign serves ads, in the event that two or more campaigns use the product catalog feed from the same Microsoft Merchant Center store.

You must specify one of the supported values: 0, 1, or 2. The higher numbers are given higher priority.

If two shopping campaigns use the product catalog feed from same Microsoft Merchant Center store, then ads will be delivered for the Ad Group Product Partition with the highest bid.

Note

If you create a Microsoft Shopping campaign in the Microsoft Advertising web application, the default priority selected is "Low" which is the equivalent of '0'.

Add: Required if the Campaign Type field is set to Shopping. You cannot include this column for other campaign types.
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only

Quality Score

The numeric score shows you how competitive your ads are in the marketplace by measuring how relevant your keywords and landing pages are to customers' search terms. The quality score is calculated by Microsoft Advertising using the Keyword Relevance, Landing Page Relevance, and Landing Page User Experience sub scores. If available, the quality score can range from a low of 1 to a high of 10.

Quality score is based on the last rolling 30 days for the owned and operated search traffic. A quality score can be assigned without any impressions, in the case where a keyword bid did not win any auctions. Traffic for syndicated networks do not affect quality score. The value in the file will be "" (empty string) if the score was not computed. This can occur if there have been no impressions for the keyword for 30 days or more.

Quality score is typically updated 14-18 hours after the UTC day ends. Keywords in all time zones will be assigned a quality score for the corresponding UTC day.

If you run the report multiple times in a day, the quality score values could change from report to report based on when you run the report relative to when the scores are calculated.

If you specify a time period that spans multiple days, the quality score is the current and most recently calculated score and will be reported as the same for each day in the time period. Use the historic quality score to find out how quality score may have changed over time. Historical quality score is a daily snapshot of the rolling quality score. For more information on historic quality score, see the HistoricalQualityScore column in Report Attributes and Performance Statistics.

Add: Read-only
Update: Read-only
Delete: Read-only

Source

Determines whether to use Bing's index, advertiser supplied URLs, or both for dynamic search ads.

Possible values are in the table below.

Value Description
AdvertiserSuppliedUrls Use URLs from my page feed only. Only URLs specified in the feed file will be served from this campaign. Please note that if you choose this option and Page Feeds Ids are not set, then the campaign will not serve dynamic search ads. We recommend using this option for highly specific campaigns with tailored ad copy.
All Use URLs from both Bing's index of my website and my page feed. Pages from both sources will be used but URLs within the feed file will be given priority.
SystemIndex Use Bing's index of my website. This is the default behavior of dynamic search ad campaigns on Bing.

Add: Optional if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types. By default only Bing's index is used i.e., an empty value is effectively the same as specifying SystemIndex.
Update: Optional if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types. If no value is set for the update, this setting is not changed.
Delete: Read-only

Status

The status of the campaign.

Possible values for download and upload are Active, Paused, and Deleted. In addition, the values BudgetAndManualPaused, BudgetPaused, and Suspended are read-only via bulk download.

With experiment campaigns you cannot update the Budget, Budget Type, Status, or Time Zone. The budget, status, and time zone of an experiment campaign are always inherited from the base campaign settings.

Value Description
Active The campaign is active, which indicates that the campaign's ads can be served.
BudgetAndManualPaused The campaign is paused, which indicates that the campaign's ads will not serve. This status results when a user sets the campaign status to paused after the service pauses the campaign because the budget is depleted.
BudgetPaused The campaign is paused, which indicates that the campaign's ads will not serve. The service sets this status when the budget is depleted. The service will set the status back to Active when the budget is restored.
Deleted The campaign is deleted. This status is for internal use only. Because all Get operations do not return deleted objects, you will not see an object with this status.
Paused The campaign is paused, which indicates that the campaign's ads will not serve.
Suspended Your campaign has been suspended because of suspicious activity, and no ads are eligible for delivery.
Please contact Microsoft Advertising Support.

Add: Optional. The default value is Active.
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Required. The Status must be set to Deleted.

Store Id

The unique identifier for the Microsoft Merchant Center store that contains a product catalog feed that you want to use for the campaign.

Once you choose a store for a campaign, you can't change it. If at some point you want to use a different store, you would need to create a new shopping campaign with a new shopping setting.

To get your store identifiers, call the GetBMCStoresByCustomerId operation.

Add: Required if the Campaign Type field is set to Shopping. You cannot include this column for other campaign types.
Update: Read-only
Delete: Read-only

Sub Type

The campaign sub type.

This field is only applicable for campaigns of type Shopping, and will be empty for all other campaign types.

We are introducing Cooperative campaigns during calendar year 2018 as a sub type of Microsoft Shopping Campaigns. More details about Cooperative campaigns are coming soon, and whether or not you plan to adopt Cooperative campaigns, you might need to make code changes if your application supports any Microsoft Shopping Campaigns.

When you download campaigns and if the Campaign Type field is set to Shopping, please also check the Sub Type of each campaign. If the Sub Type is not set then it is a standard Microsoft Shopping campaign. If the value is set to ShoppingCoOperative, the campaign is a Cooperative campaign with different requirements.

Add: Optional and not applicable for most campaign types. For Cooperative campaigns you must set the sub type to ShoppingCoOperative.
Update: Read-only
Delete: Read-only

Target Setting

The target settings that are applicable for criterion types e.g., audiences that are associated with this campaign.

Note

Not everyone has this feature yet. If you don't, don't worry. It's coming soon.

Include the criterion type group name in this field if you want the "target and bid" option. In this case we will only deliver ads to people who meet at least one of your criteria, while letting you make bid adjustments for specific criteria.

Exclude the criterion type group name from this field if you want the "bid only" option. In this case we will deliver ads to everyone who meets your other targeting criteria, while letting you make bid adjustments for specific criteria.

Each criterion type group name is delimited in the Bulk file by a semicolon (";"). When you download the Bulk file, only the types that are setup to use the "target and bid" option will be included in this field.

The only criterion type value currently supported for the campaign level target setting is "Audience". The "target and bid" option for the Audience criterion type is supported with all campaign types. New values may be supported in the future so you should not depend on a fixed set of values. Having said that, any possible values for this field should also be defined in the CriterionTypeGroup value set of the Campaign Management API.

Note

Do not confuse the Audience campaign type with the Audience criterion type group name.

Criterion Type Group Supported Campaigns Description
Audience All Include the Audience criterion type group name in this field if you want to show ads only to people included in the audience, with the option to change the bid amount. Ads in this campaign will only show to people included in the audience.

Exclude the Audience criterion type group name from this field if you want to show ads to people searching for your ad, with the option to change the bid amount for people included in the audience. Ads in this campaign can show to everyone but the bid adjustment will apply to people included in the audience.

An entity such as a remarketing list can be associated with multiple campaigns, and each campaign's target settings (e.g., the Audience criterion group name for remarketing lists) are applied independently for delivery. For example the same remarketing list can be associated with Campaign A and Campaign B. The Target Setting field for each campaign are set independently, and therefore the same remarketing list might be associated via the "target and bid" option for Campaign A while associated via the "bid only" option for Campaign B.

Add: Optional. If the criterion type group name is excluded from this field, then the default setting is effectively "bid only".
Update: Optional. If no value is set for the update, this setting is not changed. To remove all criterion type group names, set this field to delete_value. The delete_value keyword removes the previous setting. To remove a subset of criterion type group names, specify the criterion type group names that you want to keep and omit any that you do not want to keep. The new set of criterion type group names will replace any previous criterion groups that were set for the campaign.
Delete: Read-only

Time Zone

The time zone where the campaign operates.

The time zone is used for reporting and applying the start and end date of an ad group.

For possible values, see Time Zones.

With experiment campaigns you cannot update the Budget, Budget Type, Status, or Time Zone. The budget, status, and time zone of an experiment campaign are always inherited from the base campaign settings.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed. You may not update the time zone if the campaign contains or has ever contained ad groups in the Active or Paused state.
Delete: Read-only

Tracking Template

The tracking template to use as a default for all URLs in your campaign.

The following validation rules apply to tracking templates. For more details about supported templates and parameters, see the Microsoft Advertising help article What tracking or URL parameters can I use?

  • Tracking templates defined for lower level entities e.g. ads override those set for higher level entities e.g. campaign. For more information, see Entity Limits.

  • The length of the tracking template is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit.

  • The tracking template must be a well-formed URL beginning with one of the following: http://, https://, {lpurl}, or {unescapedlpurl}.

  • Microsoft Advertising does not validate whether custom parameters exist. If you use custom parameters in your tracking template and they do not exist, then the landing page URL will include the key and value placeholders of your custom parameters without substitution. For example, if your tracking template is https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, and neither {_season} or {_promocode} are defined at the campaign, ad group, criterion, keyword, or ad level, then the landing page URL will be the same.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed. If you set this field to the delete_value string, the prior setting is removed.
Delete: Read-only

Website

The domain name of the website that you want to target for dynamic search ads.

The length of the string is limited to 2,048 characters. If the domain name includes www it will be trimmed and not used.

Add: Required if the Campaign Type field is set to DynamicSearchAds. You cannot include this column for other campaign types.
Update: Read-only. You cannot update the domain name.
Delete: Read-only