Running an advertising campaign

Creation and review

  1. Create campaigns: use the Campaigns.add method.

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

  2. Create ad groups: use 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: use 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: use the DynamicTextAdTargets.add method.

  5. Create ads: use the Ads.add method.

    You can add extensions to ads. See Ad extensions.

  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. Ads will start being served after payment, but not before the start date of the advertising 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 serving previously suspended ads.

  • Use the Keywords.suspend method to stop serving ads for individual keywords.

    Use the Keywords.resume method to resume serving ads for previously suspended keywords.

  • Use the DynamicTextAdTargets.suspend method to stop displays for individual dynamic ad targets.

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

Ad extensions

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

You can include ad extensions when creating an ad, or assign the extensions later after creating the ad.

Ad extension Creating Assigned to ad Unassigned from ad
vCard VCards.add method After an ad extension has been 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.

Business profile You can add a business profile or confirm your rights to it in the Yandex Business Directory.
Image AdImages.add method or Upload operation for the AdImage (Live) method in the Live 4 version of the API
Set of sitelinks Sitelinks.add method
Turbo page (see Turbo pages in the Help for Yandex Direct) You can create a Turbo page in the Turbo Page Builder.
Callout AdExtensions.add method After an ad extension 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 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 Ads.update method.
Ad extension Creating Assigned to ad Unassigned from ad
vCard VCards.add method After an ad extension has been 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.

Business profile You can add a business profile or confirm your rights to it in the Yandex Business Directory.
Image AdImages.add method or Upload operation for the AdImage (Live) method in the Live 4 version of the API
Set of sitelinks Sitelinks.add method
Turbo page (see Turbo pages in the Help for Yandex Direct) You can create a Turbo page in the Turbo Page Builder.
Callout AdExtensions.add method After an ad extension 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 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 Ads.update method.
Note. When an extension is unassigned from an ad, it is not deleted. To delete an extension that isn't assigned to any ad, use the delete method for the appropriate service.