vkGetAds: List of Ads From 'Vkontakte'.
In grkhr/rvkstat: Interface to API 'vk.com'

Description Usage Arguments Details Value Author(s) Examples

Provide to get a list of advertisements from the advertising office 'Vkontakte'.

vkGetAds(account_id = NULL, client_id = NULL, include_deleted =
         TRUE, campaign_ids = "null", ad_ids = "null",
         status_names = TRUE, api_version = NULL, access_token
         = NULL)

`account_id`	The ID of the advertising account, a list of all available advertising offices can be obtained using the function vkGetAdAccounts.
`client_id`	Client identifier from which advertisements are requested. Available and required for advertising agencies.
`include_deleted`	Boolean TRUE or FALSE, flag, specifying the need to display archived ads.
`campaign_ids`	Numeric vector, filter by advertising campaigns.
`ad_ids`	Numeric vector, ad filter.
`access_token`	API access token, obtained using the functions vkAuth or vkGetToken.
`api_version`	Vkontakte API version.
`status_names`	If TRUE you get status names, in FALSE status Ids.

If campaign_ids and ad_ids filters are enabled at the same time, the following ads will be displayed: 1. If the ad id is specified in ad_ids, then it is displayed. 2. If the ad belongs to an advertising campaign whose id is specified in campaign_ids, then it is displayed. 3. If there is an ad with the id specified in ad_ids and it belongs to a campaign whose id is specified in campaign_ids, then this ad campaign is ignored, i.e. for her, rule 2 does not work.

No more than 2000 ads are output from no more than 2000 campaigns.

Date frame with the following values:

`id`	ad id.
`campaign_id`	campaign id.
`name`	name of the announcement.
`status`	ad status.
`ad_format`	ad format.
`approved`	ad moderation status.
`all_limit`	total ad limit in rubles. 0 - no limit is set.
`create_time`	date and time of ad creation.
`9. update_time`	the date and time of the last ad change.
`10. age_restriction`	label about ad age limit.
`11. category1_id`	ID of the subject or subsection of the subject of the announcement, a list of topics can be obtained using the function vkGetAdCategories.
`12. category2_id`	Subject ID or sub topic of the ad. Additional topics, a list of topics can be obtained using the function vkGetAdCategories.
`13. cost_type`	type of payment.
`14. cpc`	price per switch in kopecks.
`15. cpm`	price per 1000 impressions in kopecks.
`16. impressions_limit`	limit the number of times this ad is shown per user.
`17. impressions_limited`	a sign that the number of ad impressions per user is limited.
`18. ad_platform`	advertising platforms where the ad will be displayed. (if ad_format is 1, 0 - VKontakte and partner sites, 1 - only VKontakte, (if ad_format is 9) all - all sites, desktop - full version of the site, mobile - mobile site and applications.)
`19. video`	1 - the ad is a video ad.

Alexey Seleznev

## Not run: 
## auth
my_tok <- vkAuth(app_id = 1,app_secret = "H2Pk8htyFD8024mZaPHm")
# ads list
my_vk_ads <- vkGetAds(account_id = 11111111, 
                      access_token = my_tok$access_token)

## End(Not run)