Campaign Management Service Operations

 

The Campaign Management service defines the following service operations.

Service OperationDescriptionRequest Limits
AddAdExtensionsAdds one or more ad extensions to an account’s ad extension library.1 AccountId

100 AdExtensions
AddAdGroupCriterionsAdds one or more ad group criterions.1 AccountId

1,000 AdGroupCriterions
AddAdGroupRemarketingListAssociationsAssociates the specified ad groups with the respective remarketing lists.1,000 AdGroupRemarketingListAssociations
AddAdGroupsAdds one or more ad groups to a specified campaign.1,000 AdGroups

1 CampaignId
AddAdsAdds one or more ads to an ad group.1 AdGroupId

50 Ads
AddBudgetsAdds new budgets to the account's shared budget library.1,000 Budgets
AddCampaignCriterionsAdds one or more campaign criterions.100 CampaignCriterions
AddCampaignsAdds one or more campaigns to an account.1 AccountId

100 Campaigns
AddConversionGoalsAdds new conversion goals to the account's shared conversion goal library.100 ConversionGoals
AddKeywordsAdds one or more keywords to an ad group.1 AdGroupId

1,000 Keywords
AddListItemsToSharedListAdds list items such as negative keywords to the corresponding list.1 SharedList

5,000 ListItems
AddMediaAdds the specified media to an account’s media library.1 AccountId

10 Media
AddNegativeKeywordsToEntitiesAdds negative keywords to the specified campaign or ad group.1 EntityNegativeKeywords

Note: Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
AddSharedEntityAdds a shared entity such as a negative keyword list to the account's library. Items in the account's library can be associated with any campaign within the account.1 SharedEntity

5,000 ListItems
AddSitePlacementsAdds one or more website placement bids to an ad group.1 AdGroupId

1,000 SitePlacementIds
AddTargetsToLibraryAdds the specified Target to your target library.1 Target
AddUetTagsAdds new Universal Event Tracking (UET) tags that you can add to your website to allow Bing Ads to collect actions people take on your website.100 UetTags
AppealEditorialRejectionsAppeals the editorial rejections of one or more ads or keywords that failed editorial review.1,000 EntityIdToParentIdAssociations
ApplyProductPartitionActionsApplies an add, update, or delete action to each of the specified BiddableAdGroupCriterion or NegativeAdGroupCriterion, which each contain a ProductPartition.5,000 CriterionActions
DeleteAdExtensionsDelete one or more ad extensions from the account’s ad extension library.1 AccountId

100 AdExtensionIds
DeleteAdExtensionsAssociationsRemoves the specified association from the respective campaigns or ad groups.1 AccountId

100 AdExtensionIdToEntityIdAssociations
DeleteAdGroupCriterionsDeletes the specified ad group criterions.1 AccountId

100 AdGroupCriterionIds
DeleteAdGroupRemarketingListAssociationsDeletes one or more ad group remarketing list associations.1,000 AdGroupRemarketingListAssociations
DeleteAdGroupsDeletes one or more ad groups in a specified campaign.1,000 AdGroupIds

1 CampaignId
DeleteAdsDeletes one or more ads in a specified ad group.1 AdGroupId

50 AdIds
DeleteBudgetsDeletes budgets from the account's shared budget library.1,000 BudgetIds
DeleteCampaignCriterionsDeletes one or more campaign criterions.1,000 CampaignCriterionIds
DeleteCampaignsDeletes one or more campaigns in a specified account.1 AccountId

100 CampaignIds
DeleteKeywordsDeletes one or more keywords in a specified ad group.1 AdGroupId

1,000 KeywordIds
DeleteListItemsFromSharedListDeletes list items such as negative keywords from the corresponding list.1 SharedList

5,000 ListItemIds
DeleteMediaDeletes the specified media from an account’s media library.1 AccountId

100MediaIds
DeleteNegativeKeywordsFromEntitiesDeletes negative keywords from the specified campaign or ad group.1 EntityNegativeKeywords

Note: Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
DeleteSharedEntitiesDeletes shared entities such as negative keyword lists from the account's library.20 SharedEntities
DeleteSharedEntityAssociationsRemoves the association between a shared entity such as a negative keyword list and an entity such as a campaign.10,000 Associations
DeleteSitePlacementsDeletes one or more website-placement bids from an ad group.1 AdGroupId

2,000 SitePlacementIds
DeleteTargetFromAdGroupRemoves the target association for the specified ad group.1 AdGroupId
DeleteTargetFromCampaignRemoves the target association for the specified campaign.1 CampaignId
DeleteTargetsFromLibraryRemoves targets from your target library.1 TargetId
GetAccountMigrationStatusesGets the migration status info for the specified accounts.

Note: This service operation is reserved for future use.
1,000 AccountIds
GetAdExtensionIdsByAccountIdGets the ad extensions from the account’s ad extension library.1 AccountId
GetAdExtensionsAssociationsGets the respective ad extension associations by the specified campaign and ad group identifiers.1 AccountId

100 EntityIds
GetAdExtensionsByIdsGets the specified ad extensions from the account’s ad extension library.1 AccountId

100 AdExtensionIds
GetAdExtensionsEditorialReasonsGets editorial rejection reasons for the respective ad extension and entity associations.1 AccountId

100 AdExtensionIdToEntityIdAssociations
GetAdGroupCriterionsByIdsGets the specified ad group criterions.1 AccountId

1,000 AdGroupCriterionIds
GetAdGroupRemarketingListAssociationsGets the ad group remarketing list associations.10 AdGroupIds
GetAdGroupsByCampaignIdGets the ad groups that exist within a specified campaign.1 CampaignId
GetAdGroupsByIdsGets the specified ad groups that exist within a specified campaign.1,000 AdGroupIds

1 CampaignId
GetAdsByAdGroupIdRetrieves the ads that are associated with an ad group.1 AdGroupId
GetAdsByEditorialStatusRetrieves the ads that belong to the specified ad group and have the specified editorial review status.1 AdGroupId
GetAdsByIdsRetrieves the specified ads from the specified ad group.1 AdGroupId

20 AdIds
GetBMCStoresByCustomerIdGets the Bing Merchant Center stores for the specified customer.Not applicable.
GetBSCCountriesGets the list of supported sales country codes for Bing Shopping campaigns.Not applicable.
GetBudgetsByIdsGets the specified budgets from the account's shared budget library.1,000 BudgetIds
GetCampaignCriterionsByIdsGets the specified campaign criterions.100 CampaignCriterionIds

1 CampaignId
GetCampaignIdsByBudgetIdsGets the campaign identifiers that share each specified budget.1,000 BudgetIds
GetCampaignsByAccountIdRetrieves all the campaigns that exist within a specified account.1 AccountId
GetCampaignsByIdsRetrieves the specified campaigns from the specified account.1 AccountId

100 CampaignIds
GetConversionGoalsByIdsGets the specified conversion goals.100 ConversionGoalIds
GetConversionGoalsByTagIdsGets the conversion goals that use the specified UET tags.100 TagIds
GetEditorialReasonsByIdsGets the reasons why the specified entities failed editorial review and whether the rejection is appealable.1 AccountId

1,000 EntityIdToParentIdAssociations
GetKeywordsByAdGroupIdRetrieves the keywords for an ad group.1 AdGroupId
GetKeywordsByEditorialStatusRetrieves the keywords with the specified editorial review status.1 AdGroupId
GetKeywordsByIdsRetrieves the specified keywords.1 AdGroupId

1,000 KeywordIds
GetListItemsBySharedListGets the list items such as the negative keywords of a negative keyword list.1 SharedList
GetMediaAssociationsGets the media associations of the specified entity type from an account’s media library.1 AccountId

10 MediaIds
GetMediaByIdsGets the specified media from an account’s media library.1 AccountId

10 MediaIds
GetMediaMetaDataByAccountIdGets the media meta data of the specified entity type from an account’s media library.Not applicable.
GetMediaMetaDataByIdsGets the specified media meta data from an account’s media library.100 MediaIds
GetNegativeKeywordsByEntityIdsGets the negative keywords that are only associated with the specified campaigns or ad groups.1 ParentEntityId

1 EntityIds
GetNegativeSitesByAdGroupIdsGets the negative site URLs of the specified ad groups.15 AdGroupIds

1 CampaignId
GetNegativeSitesByCampaignIdsGets the negative site URLs of the specified campaigns.1 AccountId

15 CampaignIds
GetPlacementDetailsForUrlsRetrieves placement information for the specified URLs.10 Urls
GetPlacementDetailsForUrlsRetrieves placement information for the specified URLs.10 Urls
GetRemarketingListsGets the remarketing lists that can be associated with entities in the specified account.100 RemarketingListIds
GetSharedEntitiesByAccountIdGets the shared entities such as negative keyword lists from the account's library.Not applicable.
GetSharedEntityAssociationsByEntityIdsGets associations between a campaign and a shared entity such as a negative keyword list. You can request associations by associated entity identifiers.100 EntityIds
GetSharedEntityAssociationsBySharedEntityIdsGets associations between a campaign and a shared entity such as a negative keyword list. You can request associations by shared entity identifiers.1 SharedEntityIds
GetSitePlacementsByIdsRetrieves the specified website-placement bids from the specified ad group.1 AdGroupId

1,000 SitePlacementIds
GetTargetsByAdGroupIdsRetrieves detailed information about the Target objects that are associated with the specified ad groups.100 AdGroupIds
GetTargetsByCampaignIdsRetrieves detailed information about the Target objects that are associated with the specified campaigns.100 CampaignIds
GetTargetsByIdsRetrieves detailed information about the specified Target objects.100 TargetIds
GetTargetsInfoFromLibraryRetrieves identifier information about all the targets in your target library.Not applicable.
GetUetTagsByIdsGets the specified Universal Event Tracking (UET) tags.100 TagIds
SetAdExtensionsAssociationsAssociates the specified ad extensions with the respective campaigns or ad groups.1 AccountId

100 AdExtensionIdToEntityIdAssociations
SetNegativeSitesToAdGroupsSets the negative site URLs of the specified ad groups.5,000 AdGroupNegativeSites

1 CampaignId
SetNegativeSitesToCampaignsSets the negative site URLs of the specified campaigns.1 AccountId

5,000 CampaignNegativeSites
SetSharedEntityAssociationsSets the association between a campaign and a shared entity such as a negative keyword list.10,000 Associations
SetTargetToAdGroupAssociates the specified target with the specified ad group.1 AdGroupId

1 TargetId
SetTargetToCampaignAssociates the specified target with the specified campaign.1 CampaignId

1 TargetId
UpdateAdExtensionsUpdates one or more ad extensions within an account’s ad extension library.1 AccountId

100 AdExtensions
UpdateAdGroupCriterionsUpdates one or more ad group criterions.1 AccountId

1,000 AdGroupCriterions
UpdateAdGroupRemarketingListAssociationsUpdates one or more ad group remarketing list associations.1,000 AdGroupRemarketingListAssociations
UpdateAdGroupsUpdates the specified ad groups in a specified campaign.1,000 AdGroups

1 CampaignId
UpdateAdsUpdates the specified ads within a particular ad group.1 AdGroupId

50 Ads
UpdateBudgetsUpdates budgets in the account's shared budget library.1,000 Budgets
UpdateCampaignCriterionsUpdates one or more campaign criterions.100 CampaignCriterions
UpdateCampaignsUpdates specified campaigns in a specified account.1 AccountId

100 Campaigns
UpdateConversionGoalsUpdates conversion goals within the account's shared conversion goal library.100 ConversionGoals
UpdateKeywordsUpdates the keywords within a specified ad group.1 AdGroupId

1,000 Keywords
UpdateSharedEntitiesUpdates shared entities such as negative keyword lists within the account's library.20 SharedEntities
UpdateSitePlacementsUpdates one or more website-placement bids in an ad group.1 AdGroupId

1,000 SitePlacements
UpdateTargetsInLibraryUpdates Target objects in your target library.1 Target
UpdateUetTagsUpdates the specified Universal Event Tracking (UET) tags.100 UetTags

Community Additions

ADD
Show: