Export (0) Print
Expand All

Campaign Management Service Operations

The Campaign Management service defines the following service operations.

Service Operation

Description

Request Limits

AddAdExtensions

Adds one or more ad extensions to an account’s ad extension library.

1 AccountId

100 AdExtensions

AddAdGroupCriterions

Adds one or more ad group criterions that determine whether ads in the ad group get served.

1 AccountId

1,000 AdGroupCriterions

AddAdGroups

Adds one or more ad groups to a specified campaign.

1,000 AdGroups

1 CampaignId

AddAds

Adds one or more ads to an ad group.

1 AdGroupId

50 Ads

AddBusinesses

Adds a business location to a customer.

1 Business

AddCampaigns

Adds one or more campaigns to an account.

1 AccountId

100 Campaigns

AddGoals

Adds one or more Campaign Analytics goals that campaign in the account can use to track user activity and conversions.

1 AccountId

6 Goals

AddImage

Adds an image or icon to an account’s media library.

1 AccountId

AddKeywords

Adds one or more keywords to an ad group.

1 AdGroupId

1,000 Keywords

AddMedia

Adds the specified media to an account’s media library.

1 AccountId

10 Media

AddSitePlacements

Adds one or more website placement bids to an ad group.

1 AdGroupId

1,000 SitePlacementIds

AddTarget

Adds target information to the specified ad group.

1 AdGroupId

1 Target

AddTargetsToLibrary

Adds targets to your target library.

1 Target

AppealEditorialRejections

Appeals the editorial rejections of one or more ads or keywords that failed editorial review.

1,000 EntityIds

DeleteAdExtensions

Delete one or more ad extensions from the account’s ad extension library.

1 AccountId

100 AdExtensionIds

DeleteAdExtensionsFromCampaigns

Disassociates one or more ad extensions from one or more campaigns.

1 AccountId

100 AdExtensionIdToCampaignIdAssociations

DeleteAdGroupCriterions

Deletes the specified ad group criterions.

1 AccountId

1,000 AdGroupCriterionIds

DeleteAdGroups

Deletes one or more ad groups in a specified campaign.

1,000 AdGroupIds

1 CampaignId

DeleteAds

Deletes one or more ads in a specified ad group.

1 AdGroupId

50 AdIds

DeleteBusinesses

Deletes one or more businesses from an account.

1 BusinessId

DeleteCampaigns

Deletes one or more campaigns in a specified account.

1 AccountId

100 CampaignIds

DeleteGoals

Deletes the specified goals from the specified account.

1 AccountId

DeleteKeywords

Deletes one or more keywords in a specified ad group.

1 AdGroupId

1,000 KeywordIds

DeleteSitePlacements

Deletes one or more website-placement bids from an ad group.

1 AdGroupId

2,000 SitePlacementIds

DeleteTarget

Deletes the target within the specified ad group.

1 AdGroupId

DeleteTargetFromAdGroup

Removes the target association for the specified ad group.

1 AdGroupId

DeleteTargetFromCampaign

Removes the target association for the specified campaign.

1 CampaignId

DeleteTargetsFromLibrary

Removes targets from your target library.

1 TargetId

GetAccountMigrationStatuses

Gets the status of one or more data migration processes being run for the specified accounts.

1,000 AccountIds

GetAdEditorialReasonsByIds

Gets the reasons why the specified ads failed editorial review.

1 AccountId

1,000 AdIds

GetAdExtensionIdsByAccountId

Gets the ad extensions from the account’s ad extension library.

1 AccountId

GetAdExtensionsByCampaignIds

Gets the specified types of ad extensions associated with the specified campaigns.

1 AccountId

100 CampaignIds

GetAdExtensionsByIds

Gets the specified ad extensions from the account’s ad extension library.

1 AccountId

100 AdExtensionIds

GetAdExtensionsEditorialReasonsByCampaignIds

Gets the reasons why the specified ad extensions failed editorial review.

1 AccountId

100 AdExtensionIdToCampaignIdAssociations

GetAdGroupCriterionsByAdGroupId

Gets the specified types of criterions from the specified ad group.

1 AccountId

1 AdGroupId

GetAdGroupCriterionsByIds

Gets the specified criterions.

1 AccountId

1,000 AdGroupCriterionIds

GetAdGroupsByCampaignId

Gets the ad groups that exist within a specified campaign.

1 CampaignId

GetAdGroupsByIds

Gets the specified ad groups that exist within a specified campaign.

1,000 AdGroupIds

1 CampaignId

GetAdRotationByAdGroupIds

Gets the ad rotation type applied to the specified ad groups.

1,000 AdGroupIds

1 CampaignId

GetAdsByAdGroupId

Retrieves the ads that are associated with an ad group.

1 AdGroupId

GetAdsByEditorialStatus

Retrieves the ads that belong to the specified ad group and have the specified editorial review status.

1 AdGroupId

GetAdsByIds

Retrieves the specified ads from the specified ad group.

1 AdGroupId

20 AdIds

GetAnalyticsType

Gets the type of analytics that is set for the specified accounts.

1 AccountId

GetBMCStoresByCustomerId

Gets the Bing Merchant Center stores for the specified customer.

Not applicable.

GetBusinessesByIds

Gets the business location objects of the specified businesses.

Not applicable.

GetBusinessesInfo

Retrieves information about all the businesses in your account.

Not applicable.

GetCampaignAdExtensions

Gets the campaign’s preference for whether to include the business’ address and phone number in its text ads.

1 AccountId

100 CampaignIds

GetCampaignsByAccountId

Retrieves all the campaigns that exist within a specified account.

1 AccountId

GetCampaignsByIds

Retrieves the specified campaigns from the specified account.

1 AccountId

100 CampaignIds

GetDestinationUrlByKeywordIds

Gets the destination URL of one or more keywords.

1 AdGroupId

1,000 KeywordIds

GetDeviceOSTargetsByIds

Get the devices that the specified targets target.

Not applicable.

GetEditorialReasonsByIds

Gets the reasons why the specified entities failed editorial review and whether the rejection is appealable.

1 AccountId

1,000 EntityIds

GetExclusionsByAssociatedEntityIds

Gets the specified exclusions from the specified list of entities.

255 Entities

GetGoals

Gets the Campaign Analytics goals that are defined for the specified account.

1 AccountId

GetImageById

Gets the specified image or icon from an account’s media library.

1 AccountId

1 MediaId

GetKeywordEditorialReasonsByIds

Gets the reasons why the specified keywords failed editorial review.

1 AccountId

1,000 KeywordIds

GetKeywordsByAdGroupId

Retrieves the keywords for an ad group.

1 AdGroupId

GetKeywordsByEditorialStatus

Retrieves the keywords with the specified editorial review status.

1 AdGroupId

GetKeywordsByIds

Retrieves the specified keywords.

1 AdGroupId

1,000 KeywordIds

GetMediaByIds

Gets the specified media from an account’s media library.

1 AccountId

10 MediaIds

GetNegativeKeywordsByAdGroupIds

Retrieves the negative keywords of the specified ad groups.

25 AdGroupIds

1 CampaignId

GetNegativeKeywordsByCampaignIds

Retrieves the negative keywords of the specified campaigns.

1 AccountId

25 CampaignIds

GetNegativeSitesByAdGroupIds

Gets the negative site URLs of the specified ad groups.

15 AdGroupIds

1 CampaignId

GetNegativeSitesByCampaignIds

Gets the negative site URLs of the specified campaigns.

1 AccountId

15 CampaignIds

GetNormalizedStrings

Normalizes a list of keyword or negative keyword strings.

1,000 Strings

GetPlacementDetailsForUrls

Retrieves placement information for the specified URLs.

10 Urls

GetSitePlacementsByAdGroupId

Retrieves all the website-placement bids from the specified ad group.

1 AdGroupId

GetSitePlacementsByIds

Retrieves the specified website-placement bids from the specified ad group.

1 AdGroupId

1,000 SitePlacementIds

GetTargetByAdGroupId

Gets target information for an ad group.

1 AdGroupId

GetTargetsByAdGroupIds

Retrieves detailed information about the targets that are associated with the specified ad groups.

100 AdGroupIds

GetTargetsByCampaignIds

Retrieves detailed information about the targets that are associated with the specified campaigns.

100 CampaignIds

GetTargetsByIds

Retrieves detailed information about the specified targets.

100 TargetIds

GetTargetsInfoFromLibrary

Retrieves detailed information about all the targets in your target library.

Not applicable.

PauseAdGroups

Pauses one or more ad groups.

1,000 AdGroupIds

1 CampaignId

PauseAds

Pauses one or more ads.

1 AdGroupId

1,000 AdIds

PauseCampaigns

Pauses one or more campaigns.

1 AccountId

100 CampaignIds

PauseKeywords

Pauses one or more keywords.

1 AdGroupId

2,000 KeywordIds

PauseSitePlacements

Pauses one or more website-placement bids in the specified ad group.

1 AdGroupId

2,000 SitePlacementIds

ResumeAdGroups

Resumes one or more ad groups.

1,000 AdGroupIds

1 CampaignId

ResumeAds

Resumes one or more ads.

1 AdGroupId

1,000 AdIds

ResumeCampaigns

Resumes one or more campaigns.

1 AccountId

100 CampaignIds

ResumeKeywords

Resumes one or more keywords.

1 AdGroupId

2,000 KeywordIds

ResumeSitePlacements

Resumes one or more website placements in the specified ad group.

1 AdGroupId

2,000 SitePlacementIds

SetAdExtensionsToCampaigns

Associates one or more ad extensions with one or more campaigns.

1 AccountId

100 AdExtensionIdToCampaignIdAssociations

SetAdRotationToAdGroups

Sets the type of ad rotation to apply to the specified ad groups.

1,000 AdGroupAdRotations

1 CampaignId

SetAnalyticsType

Sets the type of analytics that campaigns in the specified accounts use.

1 AccountAnalyticsType

SetCampaignAdExtensions

Sets the campaign’s preferences for whether to include the business’ address and phone number in its text ads.

1 AccountId

100 AdExtensions

SetDestinationUrlToKeywords

Sets the destination URL that an ad uses if the specified keyword matches the user’s search query.

1 AdGroupId

1,000 KeywordDestinationUrls

SetExclusionsToAssociatedEntities

Applies the specified exclusions to the specified list of entities.

1 ExclusionToEntityAssociation

SetNegativeKeywordsToAdGroups

Sets the negative keywords of the specified ad groups.

25 AdGroupNegativeKeywords

1 CampaignId

SetNegativeKeywordsToCampaigns

Sets the negative keywords of the specified campaigns.

1 AccountId

25 CampaignNegativeKeywords

SetNegativeSitesToAdGroups

Sets the negative site URLs of the specified ad groups.

5,000 AdGroupNegativeSites

1 CampaignId

SetNegativeSitesToCampaigns

Sets the negative site URLs of the specified campaigns.

1 AccountId

5,000 CampaignNegativeSites

SetTargetToAdGroup

Associates the specified target with the specified ad group.

1 AdGroupId

1 TargetId

SetTargetToCampaign

Associates the specified target with the specified campaign.

1 CampaignId

1 TargetId

SubmitAdGroupForApproval

Submits an ad group for editorial review.

1 AdGroupId

UpdateAdExtensions

Updates one or more ad extensions within an account’s ad extension library.

1 AccountId

100 AdExtensions

UpdateAdGroupCriterions

Updates one or more ad group criterions.

1 AccountId

1,000 AdGroupCriterions

UpdateAdGroups

Updates the specified ad groups in a specified campaign.

1,000 AdGroups

1 CampaignId

UpdateAds

Updates the specified ads within a particular ad group.

1 AdGroupId

50 Ads

UpdateBusinesses

Updates one or more businesses in an account.

1 Business

UpdateCampaigns

Updates specified campaigns in a specified account.

1 AccountId

100 Campaigns

UpdateDeviceOSTargets

Updates the devices that the specified targets target.

1 TargetAssociation

UpdateGoals

Updates the specified goals in the specified account.

1 AccountId

UpdateKeywords

Updates the keywords within a specified ad group.

1 AdGroupId

1,000 Keywords

UpdateSitePlacements

Updates one or more website-placement bids in an ad group.

1 AdGroupId

1,000 SitePlacements

UpdateTarget

Updates the target information for the specified ad group.

1 AdGroupId

1 Target

UpdateTargetsInLibrary

Updates targets in your target library.

1 Target

Community Additions

Show:
© 2014 Microsoft