Vk bi: Вакансия BI-разработчик в Москве, работа в компании VK, Delivery (вакансия в архиве c 7 января 2022)

Содержание

Вконтакте Ads API > Power BI & Excel

Функция 7+ в 1:wink: Неофициальная обёртка для методов рекламного API Вконтакте. Выгружайте статистику рекламных кампаний Вконтакте напрямую в Power BI или Excel.

В отчётах перевел все (или большинство) англоязычных названий колонок и значений на великий и могучий (поменяйте пару строк в коде, если перевод не нужен). Старался документировать код, поэтому найдёте где это делается:wink:

Функция тестировалась в работе с API Вконтакте https://vk.com/dev/ads, но, вероятно, будет работать и с другими методами (об этом ниже)

Инструкция по работе

Создайте в редакторе Power Query, встроенном в Power BI или Excel новую функцию и вставьте в неё исходный код. Переименуйте свой запрос, например, в VK
Получите токен по этой инструкции или используйте имеющийся, например, от rvkstat
Создайте текстовый параметр в Power BI или Excel и запишите в него токен, или просто подставьте его первым аргументом в вызове фукнции

Описание параметров

Все параметры необязательные, но токен всё равно нужно получить 😉

Параметр	Тип	Значение по умолчанию	Описание
access_token	text	—	Токен доступа. Получите по этой инструкции или используйте имеющийся
account_id	number	—	Идентификатор рекламного аккаунта
client_id	number	—	Идентификатор клиента агентского рекламного аккаунта или null, если аккаунт не агентский
level	text	—	Уровень детализации статистики. Если не указать параметр, то будут возвращаться списки: рекламных кабинетов, клиентов, кампаний. Для получения списка объявлений используйте “adlist”. Другие допустимые значения: “office” — статистика по всему аккаунту, “client” — по клиентам, “campaign” — по кампаниям и “ad” — по объявлениям
period	text	“overall”	Детализация периода. По-умолчанию данные суммируются за весь выбранный период статистики. Возможна детализация по месяцам “month” или по дням “day”
date_from	date	0	Дата начала периода. По-умолчанию автоматически берется дата создания объекта статистики
date_to	date	0	Дата окончания периода. По-умолчанию подставляется сегодняшнее число или месяц, в зависимости от значения period
method	text	—	Методы. есть 2 встроенных значения: “demographics” — для получения демографических данных с дополнительной обработкой ответов и “postsreach” — для получения характеристик поста. Вообще сюда можно указать любую функцию API, например, ads.getFloodStats (см. примеры ниже). По сути меняет url (relative path)
ids	list	—	Список идентификаторов. Если не указано, то в зависимости от level автоматически запрашивается список всех кампаний или объявлений для выбранного client_id. Можно подставить свои идентификаторы, соответствующие level и получить статистику выборочно
q	record	—	Query. Можно передать список любых параметров запроса (GET-параметры запроса), что в сочетании с method позволяет обращаться к другим методам API

Примеры работы

Список рекламных кабинетов

VK(access_token)

Вызывает метод ads.getAccounts

access_token можно получить по этой инструкции или по инструкции Алексея Селезнева к функции rvkstat

Список клиентов агентства

VK(access_token,account_id)

Вызывает метод ads.getClients Обязательный параметр:

account_id — идентификатор рекламного кабинета

Список кампаний

VK(access_token,account_id,client_id)

Вызывает метод ads.getCampaigns Обязательные параметры:

account_id — идентификатор рекламного кабинета
client_id — идентификатор клиента

Список рекламных объявлений

VK(access_token,account_id,client_id,"adlist")

Вызывает метод ads.getAds Обязательные параметры:

account_id — идентификатор рекламного кабинета

client_id — идентификатор клиента
level = “adlist”

Статистика эффективности кабинета, клиентов, кампаний или объявлений

VK(access_token,account_id,client_id,"office")

Вызывает метод ads. getStatistics Обязательные параметры:

account_id — идентификатор рекламного кабинета
client_id — идентификатор клиента
level — уровень детализации статистики:
- “office” — по всему аккаунту
- “client” — по клиентам
- “campaign” — по кампаниям
- “ad” — по объявлениям

Чтобы указать детализацию статистики по датам, укажите параметр period. Например, для получения статистики по всем кампаниям с детализацией по месяцам (статистика помесячно):

VK(access_token,account_id,client_id,"campaign","month")

Чтобы ограничить дату начала и дату окончания статистики, укажите параметры date_from и date_to. Например, следующий код вернёт статистику по объявлениям за весь январь 2020 г с детализацией периода по дням (т.е. статистика за каждый день)

VK(access_token,account_id,client_id,"campaign","day",#date(2020,1,1),#date(2020,1,31))

Если не задан список идентификаторов (параметр ids), то в зависимости от значения level выполнится запрос списка всех кампаний или объявлений и их идентификаторы будут подставлены автоматически. Если же вы хотите получить статистику по кампаниям с идентификаторами 123 и 124, то перечислите их в параметре ids в виде списка:

VK(access_token,account_id,client_id,"campaign","overall",#date(2020,1,1),#date(2020,1,31),null,{123,124})

Убедитесь, что идентификаторы в списке соответствуют уровням level: если в level = “campaign”, то передавайте идентификаторы кампаний, а не объявлений, иначе API вернет ошибку, что идентификаторы не существуют или указаны неверно.

Демографическая статистика

Вызывает метод ads.getDemographics Метод работает аналогично получению статистики с помощью ads.getStatistics (это его дополнение), просто вместо общей статистики возвращает демографические данные (пол, возраст, город). Например, чтобы получить демографию по кампаниям с идентификаторами 123 и 124 за весь период их работы, вызовите функцию:

VK(access_token,account_id,client_id,"campaign",null,null,null,"demographics",{123,124})

Обязательные параметры:

account_id — идентификатор рекламного кабинета
client_id — идентификатор клиента
level — уровень детализации статистики:
- “office” — по всему аккаунту
- “client” — по клиентам
- “campaign” — по кампаниям
- “ad” — по объявлениям
method = “demographics”

Взаимодействия с рекламными записями

Например, взаимодействия (лайки, репосты, отписки, вступления и т.

п.) рекламных постов кампании с идентификатором 123 за всё время можно получить следующим образом:

VK(access_token,account_id,client_id,"campaign",null,null,null,"postsreach",{123})

Вызывает метод ads.getPostsReach Обязательные параметры:

account_id — идентификатор рекламного кабинета
levels — возможные значения: по кампаниям “campaigns” или по объявлениям “ad”
ids — список идентификаторов, соответствующих ids_typeв зависимости от того, какой задан ids_type вызывает метод ads.getCampaigns или ads.getAds для получения идентификаторов всех кампаний или объявлений соответственно
method = “postsreach”

Оставшиеся “баллы API”

VK(access_token,account_id,null,null,null,null,null,"ads.getFloodStats")

Вызов метода ads.getFloodStats Обязательные параметры:

account_id — идентификатор рекламного кабинета

method = “ads.getFloodStats”

Полный список тематик объявлений

VK(access_token,account_id,null,null,null,null,null,"ads. getCategories")

Вызов метода ads.getCategories Массив v1 устарел. Смотрите v2

В тех случаях, когда передаются идентификаторы кампаний или объектов, идентификаторы рекламных кабинетов или клиентов можно опустить, но такое поведение я не тестировал.

Повышение собственной производительности

Несколько советов, помогающих упростить вашу работу:

Создайте текстовый параметр, запишите в него токен, и ссылайтесь на этот параметр при вызове функции

Вопросы

С вопросами и предложениями стучитесь:

в фейсбук https://www.facebook.com/iliah.nazarov
в телеграм https://t.me/IlyaNazarov

Блог об аналитике, визуализации данных, data science и BI: vk api

При размещении рекламы некоторые площадки в настройках аудитории позволяют загрузить список конкретных людей, которые увидят рекламу. Для парсинга id по конкретным пабликам существуют специальные инструменты, но куда интереснее (и дешевле) сделать это собственноручно при помощи Python и VK API. Сегодня расскажем, как для рекламной кампании LEFTJOIN мы спарсили целевую аудиторию и загрузили её в рекламный кабинет.

В материале «Собираем данные по рекламным кампаниям ВКонтакте» подробно описан процесс получения токена пользователя для VK API

Парсинг пользователей

Для отправки запросов потребуется токен пользователя и список пабликов, чьих участников мы хотим получить. Мы собрали около 30 сообществ, посвящённых аналитике, BI-инструментам и Data Science.

import requests
import time

group_list =  ['datacampus', '185023286', 'data_mining_in_action', '223456', '187222444', 'nta_ds_ai', 'business__intelligence', 'club1981711', 'datascience', 'ozonmasters', 'businessanalysts', 'datamining.team', 'club.shad', '174278716', 'sqlex', 'sql_helper', 'odssib', 'sapbi', 'sql_learn', 'hsespbcareer', 'smartdata', 'pomoshch_s_spss', 'dwhexpert', 'k0d_ds', 'sql_ex_ru', 'datascience_ai', 'data_club', 'mashinnoe_obuchenie_ai_big_data', 'womeninbigdata', 'introstats', 'smartdata', 'data_mining_in_action', 'dlschool_mipt']

token = 'ваш_токен'

Запрос на получение участников сообщества к API ВКонтакте вернёт максимум 1000 строк — для получения последующих тысяч потребуется смещать параметр offset на единицу. Но нужно знать, до какого момента это делать — поэтому опишем функцию, которая принимает id сообщества, получает информацию о числе участников сообщества и возвращает максимальное значение для offset — отношение числа участников к 1000, ведь мы можем получить ровно тысячу человек за раз.

def get_offset(group_id):
    count = requests.get('https://api.vk.com/method/groups.getMembers', params={
            'access_token':token,
            'v':5.103,
            'group_id': group_id,
            'sort':'id_desc',
            'offset':0,
            'fields':'last_seen'
        }).json()['response']['count']
    return count // 1000

Следующим этапом опишем функцию, которая принимает id сообщества, собирает в один список id всех подписчиков и возвращает его. Для этого отправляем запросы на получение 1000 человек, пока не кончается offset, вносим данные в список и возвращаем его. Проходя по каждому человеку дополнительно проверяем дату его последнего посещения социальной сети — если он не заходил с середины ноября, добавлять его не будем.

Время указывается в формате unixtime.

def get_users(group_id):
    good_id_list = []
    offset = 0
    max_offset = get_offset(group_id)
    while offset < max_offset:
        response = requests.get('https://api.vk.com/method/groups.getMembers', params={
            'access_token':token,
            'v':5.103,
            'group_id': group_id,
            'sort':'id_desc',
            'offset':offset,
            'fields':'last_seen'
        }).json()['response']
        offset += 1
        for item in response['items']:
            try:
                if item['last_seen']['time'] >= 1605571200:
                    good_id_list.append(item['id'])
            except Exception as E:
                continue
    return good_id_list

Теперь пройдём по всем сообществам из списка и для каждого соберём участников, а затем внесём их в общий список all_users. В конце переводим сначала список в множество, а затем опять в список, чтобы избавиться от возможных дубликатов: одни и те же люди могли быть участниками разных пабликов. Лишним не будет после каждого паблика приостановить работу программы на секунду, чтобы не столкнуться с ограничениями на число запросов.

all_users = []

for group in group_list:
    print(group)
    try:
        users = get_users(group)
        all_users.extend(users)
        time.sleep(1)
    except KeyError as E:
        print(group, E)
        continue

all_users = list(set(all_users))

Последним шагом записываем каждого пользователя в файл с новой строки.

with open('users.txt', 'w') as f:
    for item in all_users:
        f.write("%s\n" % item)

Аудитория в рекламном кабинете из файла

Переходим в свой рекламный кабинет ВКонтакте и заходим во вкладку «Ретаргетинг». Там будем кнопка «Создать аудиторию»:

После нажатия на неё откроется новое окно, где можно будет выбрать в качестве источника файл и указать название для аудитории:

После загрузки пройдёт несколько секунд и аудитория будет доступна. Первые минут 10 будет указано, что аудитория слишком мала: это не так и панель вскоре обновится, если в вашей аудитории действительно более 100 человек.

Итоги

Сравним среднюю стоимость привлечённого в наше сообщество участника в объявлении с автоматической настройкой аудитории и в объявлении, аудиторию для которого мы спарсили. В первом случае получаем среднюю стоимость в 52,4 рубля, а во втором — в 33,2 рубля. Подбор качественной аудитории при помощи методов парсинга данных из ВКонтакте помог снизить среднюю стоимость на 37%.

Для рекламной кампании мы подготовили такой пост (нажмите на картинку, чтобы перейти к нему):