Managing ad campaigns

Creation and review

Create campaigns: the Campaigns.add method.

For information about campaign types, see the section Campaign type.
Create ad groups: the AdGroups.add method.

The group type must match the campaign type.
For a group of Text & Image ads or app promotion ads, add keywords and set up autotargeting using the Keywords.add method.

You can set bids and priorities immediately when creating keywords, or later using the KeywordBids.set or KeywordBids.setAuto method.
For a group of dynamic ads, add dynamic ad targets: the DynamicTextAdTargets.add method.
Create ads: use the Ads.add method.

You can enhance your ad with add-ons. See Add-ons to ads.
Submit ads for review: the Ads.moderate method.

Once your ads are approved, you need to top up your shared account. Your ads will start running after your account is funded, but no earlier than the start date of the campaign.

Stopping and restarting

Use the Campaigns.suspend method to stop serving ads at the campaign level.

You can re-enable impressions of previously stopped campaigns using the Campaigns.resume.
Use the Ads.suspend method to stop serving individual ads.

Use the Ads.resume method to resume displays for previously suspended ads.
Use the Keywords.suspend method to stop displays for individual keywords.

Use the Keywords.resume method to resume displays of previously suspended keywords.
Use the DynamicTextAdTargets.suspend method to stop displays for individual dynamic ad targets.

Use the DynamicTextAdTargets.resume method to resume displays for previously suspended dynamic ad targets.

Ad extensions

Depending on the type of ad, you can add a vСard, business profile ID, image, set of sitelinks, callouts, video extension, or Turbo page.

You can include add-ons when creating an ad, or assign the add-ons later after creating the ad.

Ad extension	Creating	Assigned to ad	Unassigned from ad
Business profile	You can add a business profile or verify your rights to it in the Yandex Business Directory.	Once an ad extension is created, you can specify its ID in the Ads.add and Ads.update methods.	To unassign an extension, the Ads.update method should pass the `nil (null)` value instead of the ID.
Image	The AdImages.add method, or an Upload method's operation in the Live 4 version of the API
Set of sitelinks	Sitelinks.add method
Turbo page	You can create a Turbo page in the Turbo Page Builder.
A callout	AdExtensions.add method	Once an ad extension is created, you can specify its ID in the Ads.add and Ads.update methods.	You can unassign all the callouts from an ad at once, or selectively. To unassign all the callouts, the Ads.update method should pass the `nil (null)` value in the `CalloutSetting` parameter. To unassign a particular callout, specify the callout ID in the `CalloutSetting` parameter and set the action type to `REMOVE`.
Video extension	Create a video extension in the Ad Builder. To synchronously upload videos by their URL links, use the Add operation from the AdVideos method.	After creating the video extension in Ad Builder, specify its ID in the Ads.add and Ads.update methods, in the `CreativeId` parameter in the `VideoExtension` structure.	To unassign the video extension, pass `nil (null)` in the `CreativeId` parameter of the `VideoExtension` structure in the . method.

Note

When an add-on is unassigned from an ad, it is not deleted. To delete an add-on that isn't assigned to any ad, use the delete method for the appropriate service.

Was the article helpful?

null (nil) value

Negative keywords