Разработка на C# — удалённая работа в Москве

back. Доработка существующего продукта. Техническое задание на исследование API VK Рекламы (Promoos) 1. Цель исследования Определить технические возможности API VK Рекламы (база https://ads.vk.ru/api/v2/, наследник myTarget API) для интеграции с SaaS-платформой Promoos. Исследование должно дать ответы на ключевые вопросы по четырём направлениям: 1. Получение статистики и её структура. 2. Создание рекламных объектов (кампаний, групп, объявлений). 3. Мониторинг баланса и лимитов. 4. Общая архитектура OAuth-авторизации и ограничения API. Результат — документированные выводы с примерами запросов/ответов, позволяющие принять решение о реализации интеграционного модуля. 2. Объект исследования • Базовый URL: https://ads.vk.ru/api/v2/ • Документация: ads.vk.ru/doc/api (открыта) 3. Задачи исследования 3.1. Статистика () Что исследовать: 1. Получение статистики через GET /statistics/{object_type}/{period}.json (). o object_type — ad_plans (кампании), ad_groups (группы), banners (объявления). o period — day (по дням), summary (суммарно за период), overall (по документации). o Параметры: date_from, date_to (формат YYYY-MM-DD), ids (список ID), metrics (группа метрик) (). o Ограничения: не более 92 дней и 200 объектов в одном запросе (). 2. Доступные метрики (): o Базовые (base): shows, clicks, amount (расход), ctr, cpm. o Уникальные пользователи (uniques): total (уникальные за всё время), increment (новые за период), frequency. o Видео (video): started, viewed_10_seconds, viewed_25_percent, viewed_50_percent, viewed_75_percent, viewed_100_percent, depth_of_view (средняя глубина просмотра), view_10_seconds_cost и другие стоимости просмотров (). o Карусель: slide_N_shows, slide_N_clicks, slide_N_ctr (по каждому слайду) (). o Видимость (Moat): in_view (видимые показы), never_visible, active_in_view_time (среднее время в зоне видимости), attention_quality (). o ROMI: value (ценность события), romi (возврат инвестиций) (). o Дополнительные списания (tps): tps (за Moat), tpd (за сторонние данные) (). o Playable Ads: playable_game_open, playable_game_close, playable_call_to_action (). 3. Статистика по партнёрским площадкам: GET /statistics/partner/pads/day.json — выяснить структуру данных для аналитики по площадкам и группам площадок (). 4. Формат ответа: Получить примеры реальных JSON-ответов для каждого типа статистики, чтобы оценить сложность парсинга. 5. Частота обновления статистики: Проверить, с какой задержкой данные становятся доступными после показа рекламы. 3.2. Управление рекламными объектами () Что исследовать (): 1. Жизненный цикл создания кампании: o Загрузка креатива: vk_upload_image (или соответствующий эндпоинт) — как загружать изображения и видео, получать Content.id для использования в баннере. o Получение пакетов размещения: vk_get_packages — получить package_id, его objective и banner_fields (слоты для content, textblocks, urls), чтобы понимать, какие поля доступны для конкретного формата рекламы (). o Создание кампании (ad_plan): POST /ad_plans.json — обязательные параметры (name), опциональные (budget_limit, date_start). o Создание группы (ad_group): POST /ad_groups.json — требует ad_plan_id, name, package_id, структуру targetings (таргетинг). Также поддерживается создание с вложенными banners[] в одном транзакционном запросе (). o Создание баннера (banner): POST /banners.json — требует заполнения трёх карт слотов: content (с id загруженного креатива), textblocks, urls. Формат этих карт зависит от package_id (). 2. Статусы объектов (): o status (изменяемый): active, blocked (остановлен), deleted. o moderation_status (только чтение): allowed, banned, pending. Для отправки/повторной отправки на модерацию используется отдельный вызов vk_remoderate_banners (). 3. Обновление объектов (): При обновлении баннера через vk_update_banner секции (content, textblocks, urls) полностью заменяются, а не дополняются. 4. Массовые операции: vk_mass_action_ad_plans, vk_mass_action_ad_groups, vk_mass_action_banners — массовый запуск/остановка/удаление (). 5. Черновики: Проверить, существует ли возможность создать объект в статусе, отличном от blocked (например, draft). По документации полноценных черновиков нет — объект создаётся в состоянии blocked, заполняется, затем активируется (active) и отправляется на модерацию (). 3.3. Мониторинг баланса и лимитов Что исследовать: 1. Баланс кабинета: GET /user.json (поле account.balance) — доступные средства и валюта. Требуется scope read_payments (). 2. Лимиты запросов: GET /throttling.json — текущие лимиты API и остаток, чтобы избежать превышения (). 3. Push-уведомления о балансе: Проверить, поддерживает ли API вебхуки или другие механизмы пуш-уведомлений для событий (например, низкий баланс). Судя по архитектуре, уведомлений нет — необходим polling. 3.4. OAuth-авторизация и ограничения () Что исследовать: 1. OAuth-флоу: Для доступа к кабинетам пользователей используется поток authorization_code (). o Перенаправление пользователя на https://ads.vk.com/api/v2/oauth2/authorize с параметрами response_type=code, client_id, scope, redirect_uri. o Получение code (живёт 1 час) на redirect_uri. o Обмен code на access_token и refresh_token через POST /api/v2/oauth2/token.json с grant_type=authorization_code (). 2. Scopes (права доступа) (): o read_ads — чтение статистики и кампаний. o read_payments — чтение баланса и транзакций. o create_ads — создание и редактирование кампаний, групп, баннеров (). 3. Срок жизни токенов: access_token живёт 86400 секунд (24 часа), обновляется refresh_token (). 4. Лимиты (): o Количество токенов: не более 5 токенов на пару clientId и пользователь (). o Частота запросов: 2 RPS (запроса в секунду), 5000 запросов в час (по данным документации). o Ретри: Рекомендуется реализовать повторные попытки с бэкоффом при ошибках 429 (слишком много запросов) и 5xx (). 5. Обработка гонки обновления токена: Продумать механизм блокировок для общего хранилища токенов, чтобы избежать одновременного обновления одного refresh_token из разных потоков. ________________________________________ 4. Требования к результату исследования Результат должен быть оформлен в виде документа, содержащего: 1. Список всех доступных метрик статистики с примерами значений и группировками (). 2. Примеры создания рекламных объектов (ad_plan, ad_group, banner) с обязательными и опциональными полями, включая структуру targetings, content, textblocks, urls (). 3. Описание процесса загрузки креативов — эндпоинты, формат запроса, получение Content.id. 4. Схема работы с балансом и лимитами — эндпоинты, примеры ответов (). 5. Документация по OAuth-потоку — полная последовательность шагов с примерами запросов, получения токенов, используемых scopes (). 6. Описание ограничений API (по периоду, количеству объектов, частоте запросов, количеству токенов) и рекомендации по их обходу (пагинация, чанкинг ID) (). 7. Практические выводы: o Поддерживается ли мониторинг баланса через polling и с какой частотой это делать безопасно. o Можно ли работать с черновиками (через blocked статус). o Сложность интеграции и потенциальные риски. 5. Дополнительные рекомендации • Тестовый доступ: Для исследования запросить у клиента доступ к тестовому рекламному кабинету или создать собственный тестовый кабинет с минимальным бюджетом. • Инструменты: Для тестирования использовать curl или Postman. Для упрощения работы с API можно изучить существующие библиотеки (например, vk-ads-mcp), но финальная интеграция должна быть реализована самостоятельно (). • Сроки: Ожидаемый срок исследования — 3–5 рабочих дней (с учётом получения доступа к API).

Разработка приложений для ПК. Разработка с нуля. Оказание услуг по разработке информационной системы "Личный кабинет абонента-собственника нежилого помещения".

Веб-разработка. Доработка существующего продукта. Пожелания и особенности: В поисках амбициозного разработчика на существующий проект по развитию web-приложения в сфере автоматизации финансовых процессов.

Разработка чат-ботов. Задачи чат-бота: информирование клиентов, сбор информации, интерактивное меню или каталог, приём текстовых заказов, ответы на типовые вопросы, финансовые операции, автоматическое бронирование. Платформа: веб-сайт. Продукт: -. Техзадание есть.

Веб-разработка. Разработка с нуля. Пожелания и особенности: Ищем системного архитектора / Solution Architect для консультации и дальнейшего проектирования web-платформы для проведения массовых спортивных мероприятий.

Веб-разработка. Разработка с нуля.