TikTok Ads
TikTok Ads отдаёт рекламную статистику на уровне отдельных объявлений. Отчёт вы собираете сами из измерений и метрик: расход и стоимостные метрики, показы и клики, конверсии и результаты, просмотры видео по глубине досмотра, платные события вовлечения и статистика Instant Experience. Renta выгружает этот отчёт в ваше хранилище данных.
Второй тип отчёта, Account metadata, загружает профиль каждого подключённого рекламного аккаунта: название, статус, баланс, валюту, часовой пояс и контактные данные.
Аутентификация
Renta использует OAuth для аутентификации в TikTok Ads. Вы будете перенаправлены в TikTok for Business, чтобы предоставить Renta ограниченный доступ к рекламным аккаунтам.
Подключение источника TikTok Ads
Выполните эти шаги, чтобы добавить TikTok Ads как источник в Renta через OAuth-аутентификацию.
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Advertising и нажмите карточку TikTok Ads.
Нажмите Log in to your Tiktok Ads account. Вы будете перенаправлены в TikTok for Business для предоставления доступа.
TikTok for Business показывает разрешения, которые запрашивает Renta: Ad Account Management, Reporting, Pixel Management и TikTok Accounts. Нажмите Confirm. TikTok может дополнительно попросить подтвердить личность кодом, отправленным на email вашего аккаунта TikTok. После этого вы вернётесь в Renta.
Завершите настройку:
- Source name.
Укажите название источника данных. Оно используется только в интерфейсе Renta. - Access granted.
Убедитесь, что аккаунт подключён успешно.
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы синхронизировать данные TikTok Ads с вашим назначением.
Создание пайплайна TikTok Ads
Свяжите источник TikTok Ads с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите TikTok Ads в списке Already connected и нажмите Next step.
Выберите созданное ранее подключение TikTok Ads и нажмите Next step.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На финальном шаге выберите, какие данные TikTok Ads выгружать и как Renta будет их загружать.
Настройка отчёта
Укажите рекламные аккаунты, из которых нужны данные.
- Ad accounts.
Выберите один или несколько аккаунтов TikTok Ads, из которых выгружать данные. Список показывает рекламные аккаунты, доступные авторизованному пользователю TikTok for Business. Renta загружает строки всех выбранных аккаунтов в одну таблицу назначения. - Report Types.
Выберите, что выгружает пайплайн.
| Тип отчёта | Описание |
|---|---|
| Statistics report | Рекламная статистика на уровне объявлений, которую вы собираете из измерений и метрик. Это тип отчёта по умолчанию. |
| Account metadata | Профиль каждого выбранного рекламного аккаунта: название, статус, баланс, валюта, часовой пояс и контактные данные. |
Параметры
Выберите поля TikTok Ads, которые попадут в таблицу назначения. Выбранные здесь параметры определяют схему таблицы.
На вкладке Dimensions отметьте поля, описывающие объявление за каждой строкой: Date, идентификатор и название рекламного аккаунта, идентификатор, название, бюджет и цель кампании, идентификатор, название и бюджет группы объявлений, идентификатор объявления, тип плейсмента, тип продвижения и цель оптимизации. Используйте поиск по названию или нажмите Select All.
На вкладке Metrics отметьте п оказатели для выгрузки: расход, CPC, CPM и CPA, показы и клики, охват и частоту, конверсии и результаты вместе с их real-time вариантами, просмотры видео по глубине досмотра, платных подписчиков, лайки, комментарии и репосты, визиты в профиль, клики по музыкальному диску, кнопкам Duet и Stitch, статистику Instant Experience и визиты в плейлисты. Вкладка Selected показывает всё выбранное, а список Selected Parameters под пикером позволяет убрать параметр.
Какие бы измерения вы ни выбрали, статистика остаётся на уровне отдельных объявлений. Поля вроде названия кампании или группы объявлений описывают объекты, к которым объявление относится.
Для отчёта Account metadata пикер содержит только измерения: название и статус акка унта, баланс и валюту, часовой пояс, страну, компанию и контактные данные, а также атрибуты бизнес-лицензии. В таблицу назначения попадает одна строка на каждый выбранный рекламный аккаунт.
Название таблицы
Назовите пайплайн и таблицу назначения.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Название таблицы назначения. Можно оставить автоматически сгенерированное название или задать своё.
Диапазон дат
Задайте исторический период загрузки.
- Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Оставьте Today, чтобы собирать новые данные при каждом запуске.
TikTok Ads строит каждый отчёт асинхронно. Renta создаёт задачу на отчёт, ждёт, пока TikTok её выполнит, и скачивает результат. Запросы разбиваются на окна до 30 дней на каждый рекламный аккаунт, поэтому широкий исторический диапазон загружается дольше, чем несколько дней.
Период перезаписи
Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске.
При каждом запуске Renta заново запрашивает отчёт начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не меняются. Варианты: от Without overwrite data до Overwrite all data. По умолчанию выбран Last 3 days.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Стратегия синхронизации зависит от типа отчёта и от того, включено ли в отчёт измерение Date.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Statistics report (с выбранным измерением Date) | Каждая строка соответствует одному дню, таблица назначения партиционируется по колонке stat_time_day. При каждом запуске Renta перезагружает окно от последнего успешного запуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и вставляются заново, более старые партиции не меняются. |
| Полная перезагрузка | Statistics report (без измерения Date) | В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает весь настроенный диапазон дат и заменяет данные при каждом запуске. |
| Полная перезагрузка | Account metadata | В отчёте нет колонки даты, поэтому Renta при каждом запуске перезагружает текущее состояние каждого выбранного рекламного аккаунта. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.