Скрипт для экспорта статистики рекламных кампаний Одним из главных преимуществ МСС было, что можно было всю статистику с акков собирать в одном месте. Если же работать с обычных акков, то появляется небольшая проблема, что нужно заходить на каждый акк отдельно. И для этого был написан скрипт, который собирает и передает всю статку в гугл таблицы.
Для удобства работы со скриптом дам несколько советов: 1. Название кампании прописывайте не стандартное, а с нумерацией, которая будет понятная вам, что это статка именно с этого акка.
2. Статистику лучше выгружать или под конец дня, чтобы на след. день посмотреть, как акк открутил, или продублировать скрипт, чтобы он срабатывал несколько раз за день, а то если поставить, чтобы скрипт срабатывал только утром или в обед, то сложно получить объективную статистику.
3. Столбцы, которые вам не нужны, по типу названия группы объявлений и самого объявления можно сгруппировать, чтобы таблица занимала меньше места на экране.
Дальше, чтобы самому не тыкать много букв, то снова попросил чат гпт расписать суть работы скрипта:
1.
Инициализация таблицы и листа - Открывает таблицу по ID, указанному в SPREADSHEET_ID.
- Проверяет, существует ли лист с названием SHEET_NAME. Если его нет, создается новый лист с этим названием.
2.
Настройка заголовков и начальной строки - Проверяет значение ячейки Y1, которая хранит номер следующей строки для записи данных.
- Если в Y1 ничего нет (первый запуск), добавляет заголовки столбцов на первую строку и форматирует их:
- Устанавливает значение nextRow в 2, если это первая запись.
3.
Получение текущих данных аккаунта - Сохраняет текущую дату и время в формате yyyy-MM-dd HH:mm:ss (например, 2024-11-23 10:00:00).
- Получает данные аккаунта: ID клиента и валюту.
4.
Получение статистики за все время - Выполняет запрос AD_PERFORMANCE_REPORT с данными по кампаниям, группам объявлений и объявлениям (показы, клики, конверсии, стоимость) за
все время.
- Создает объект lifetimeStats, где ключом является комбинация названия кампании, группы объявлений и заголовка объявления, а значениями — данные по метрикам за все время.
5.
Получение статистики за сегодня - Выполняет запрос AD_PERFORMANCE_REPORT для получения данных
за текущий день: показы, клики, конверсии, стоимость и статусы (кампаний, групп объявлений, объявлений).
- Переходит к построчной обработке данных.
6.
Обработка данных и запись в таблицу - Для каждой строки отчета за сегодня:
1. Формирует ключ (комбинация названий кампании, группы и объявления) для сопоставления с данными за все время.
2. Определяет статусы кампании, группы объявлений и объявления. Если статус включен (enabled), но показы равны 0, статус меняется на not eligible.
3. Рассчитывает CPA (стоимость за конверсию) для данных за сегодня и за все время.
4. Записывает данные в таблицу в формате:
-
Общие данные: дата обновления, названия и статусы (кампании, группы, объявления), валюта.
-
Метрики за сегодня: показы, клики, конверсии, CPA, стоимость.
-
Метрики за все время: показы, клики, конверсии, CPA, стоимость.
- ID аккаунта.
5. Подсвечивает статусы:
-
Зеленый фон (#34a853) — если статус включен (enabled).
-
Красный фон (#ea4335) — если статус отключен или недоступен.
- Увеличивает номер строки для следующей записи.
7.
Форматирование новых данных - Если были добавлены новые строки, форматирует их:
- Добавляет границы, устанавливает выравнивание по центру.
8.
Обновление номера следующей строки - Обновляет ячейку Y1 значением номера следующей строки (currentRow).
9.
Создание или обновление фильтра - Проверяет, установлен ли фильтр в таблице. Если нет, добавляет фильтр на весь диапазон данных.
10.
Логирование результата - Записывает в лог:
- Сколько строк добавлено.
- Номер следующей строки для записи.
🔔
Подписаться на канал |
Чат канала