Running an advertising campaign

Creation and review

  1. Create campaigns: the Campaigns.add method.

    For information about campaign types, see the section Campaign types.

  2. Create ad groups: the AdGroups.add method.

    The group type must match the campaign type.

  3. For a group of text and image ads or a group for advertising mobile apps, add keywords and autotargetings: the Keywords.add method.

    You can set bids and priorities immediately when creating keywords, or later using the KeywordBids.set or KeywordBids.setAuto method.

  4. For a group of dynamic ads, add dynamic ad targets: the DynamicTextAdTargets.add method.

  5. Create ads: the Ads.add method.

    You can supplement an ad with add-ons. See Adding vCards, images, sitelinks, callouts, and video extensions to an ad.

  6. Submit ads for review: use the Ads.moderate method.

After ads are approved by a moderator, you must transfer funds to the advertising campaign or the shared account. Ad displays will begin after payment, but not before the start date of the advertising campaign.

Stopping and restarting

Adding vCards, images, sitelinks, callouts, and video extensions to an ad

For a text and image ad, you can add a vCard, image, sitelinks, callouts, and video extension.

For a dynamic ad, you can add a vCard, image, sitelinks, and callouts.

For a mobile app ad, you can add an image.

In an image ad, the image is required.

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

Add-onsCreatingAssigning to an adUnassigning from an ad
vCardVCards.add methodAfter an add-on has been created, you can specify its ID in the Ads.add and Ads.update methods.

To unassign an add-on, the Ads.update method should pass the nil (null) value instead of the ID.

ImageAdImages.add method or Upload operation for the AdImage (Live) method in the Live 4 version of the API
Set of sitelinksSitelinks.add method
CalloutAdExtensions.add methodAfter an add-on has been 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 (see Video extensions in the Help for Yandex.Direct)Create a video extension in the Ad Builder.

After creating the video extension in the 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 Ads.update 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.