Running an advertising campaign
Creation and review
Create campaigns: use the Campaigns.add method.
For information about campaign types, see the section Campaign types.
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.
For a group of dynamic ads, add dynamic ad targets: use the DynamicTextAdTargets.add method.
Create ads: use the Ads.add method.
You can add extensions to ads. See Ad extensions.
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 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. |