rvkstat (version 2.6.3)

vkGetAds: List of Ads From 'Vkontakte'.

Description

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

Usage

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)

Arguments

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.

Value

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.

Details

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.

Examples

Run this code
# 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)
# }

Run the code above in your browser using DataCamp Workspace