View source: R/vkGetAdGenderAgeStats.R
vkGetAdGenderAgeStats | R Documentation |
Returns statistics on the reach of advertising campaigns and ads by age and sex.
vkGetAdGenderAgeStats( account_id = vkCurrentAdAccount(), ids_type = c("campaign", "ad"), ids = NULL, period = c("day", "month", "overall"), date_from = Sys.Date() - 30, date_to = Sys.Date(), username = getOption("rvkstat.username"), api_version = getOption("rvkstat.api_version"), token_path = vkTokenPath(), access_token = getOption("rvkstat.access_token") )
account_id |
The ID of the advertising account, a list of all available advertising offices can be obtained using the function vkGetAdAccounts. |
ids_type |
The type of objects requested that are listed in the ids parameter. Valid ad values are ads, campaign campaigns, client clients, office office. |
ids |
Vector id of the requested ads, campaigns, clients or account, depending on what is specified in the ids_type parameter. |
period |
The method of grouping data by date. day - statistics by days, month - statistics by months, overall - statistics for all time. Temporary restrictions are given by the arguments date_from and date_to. |
date_from |
The starting date of the displayed statistics in the format YYYY-MM-DD. |
date_to |
The end date of the displayed statistics in the format YYYY-MM-DD. |
username |
Your vkontakte login. |
api_version |
Vkontakte API version. |
token_path |
Path to dir with credentials |
access_token |
API access tokens obtained using vkAuth or vkGetToken functions |
Date frame with community statistics with the following values:
1. id |
id of the object from the ids argument. |
2. day |
(if the period is equal to day) day in the format YYYY-MM-DD. |
3. month |
(if period is equal to month) - day in the format YYYY-MM. |
4. day_from |
(if period is overall) the start date of the reporting period. |
5. day_to |
(if period is overall) end date of the reporting period. |
6. type |
object type from the ids_type parameter. |
7. gender |
gender. |
8. age |
age. |
9. impressions_rate |
part of the audience that viewed the ad, from 0 to 1. |
10. clicks_rate |
(the part of the audience that clicked on the ad, from 0 to 1. |
Alexey Seleznev
Documentation for API method ads.getStatistics: https://vk.com/dev/ads.getStatistics
## Not run: # 1.Get a static message on audience coverage by sex, # advertising campaigns in the context of days ## 1.1. We get a list of advertising campaigns camp <- vkGetAdCampaigns(account_id = 1) ## 1.2. We get statistics on advertising campaigns vk_ad_gender_age_stat_day <- vkGetAdGenderAgeStats(account_id = 1, ids_type = "campaign", ids = camp$id , period = "day", date_from = "2010-01-01", date_to = "2017-09-10") # 2.Receive a static message on the ads in the context of months ## 2.1. We get a list of advertising campaigns ads <- vkGetAds(account_id = account_id) ## 2.2. Get ad statistics vk_ad_gender_age_stat_month <- vkGetAdGenderAgeStats(account_id = 1, ids_type = "ad", ids = ads$id , period = "month", date_from = "2010-01-01", date_to = "2017-09-10") # 3.Get a static message on reaching the audience # for advertising campaigns without a temporary breakdown ## 3.1. We get a list of advertising campaigns camp <- vkGetAdCampaigns(account_id = 1) ## 3.2. We get statistics on advertising campaigns vk_ad_gender_age_stat_total <- vkGetAdGenderAgeStats(account_id = 1, ids_type = "campaign", ids = camp$id , period = "overall", date_from = "2010-01-01", date_to = "2017-09-10") ## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.