Renta / Документация / Источники / Meta Ads / System user token

Meta Ads system user token

Системный токен Meta позволяет Renta подключаться к рекламным аккаунтам Meta Ads через отдельного системного пользователя Business-портфолио, а не через личный вход в Meta. Он полезен, когда нужен полный контроль над выданными правами или когда метод OAuth сложно использовать в вашей конфигурации.

Это продвинутая альтернатива стандартной аутентификации OAuth. Мы рекомендуем её только тогда, когда нужен полный контроль над правами, выданными подключению, или когда процесс OAuth сложно использовать. В большинстве случаев OAuth — более простой вариант.

Предварительные требования

Перед началом убедитесь, что у вас есть всё необходимое.

  1. Доступ уровня Admin к Business-портфолио Meta в Business settings.
  2. Доступ уровня Admin к рекламным аккаунтам, которые вы хотите синхронизировать.
  3. Аккаунт Meta for Developers для создания приложения, под которое выпускается системный токен.

Создание приложения Meta для системного токена

Создайте приложение Meta с доступом к Marketing API и подключите его к Business-портфолио.

Откройте раздел AppsStep 1

В Business settings Meta перейдите в Accounts > Apps и нажмите + Add в правом верхнем углу.

Раздел Apps в Business settings Meta с кнопкой Add
Создайте новый app IDStep 2

В диалоге What do you want to do? выберите Create a new app ID. Откроется процесс создания приложения в Meta for Developers.

Диалог What do you want to do с пунктом Create a new app ID
Укажите данные приложенияStep 3

Заполните данные приложения и нажмите Next:

  1. App name.
    Введите понятное имя, например Renta - Demo.
  2. App contact email.
    Укажите адрес электронной почты, который вы регулярно проверяете.
Шаг App details с именем и контактным email
Выберите сценарий Marketing APIStep 4

Отфильтруйте по Ads and monetization и выберите Measure ad performance data with Marketing API, затем нажмите Next.

Шаг Add use cases с выбранным Measure ad performance data with Marketing API
Подключите Business-портфолиоStep 5

Выберите подтверждённое Business-портфолио, к которому хотите подключить это приложение, и нажмите Next.

Шаг Business с выбором Business-портфолио для подключения
Ознакомьтесь с требованиями к публикацииStep 6

Ознакомьтесь с требованиями к публикации (Business verification, Access verification и App Review), необходимыми для доступа к бизнес-данным, затем нажмите Next.

Шаг Publishing requirements со списком Business verification, Access verification и App Review
Создайте приложениеStep 7

Проверьте сводку на шаге Overview и нажмите Create app.

Для доступа к актуальным данным рекламы ваш бизнес и приложение должны пройти Business verification и App Review для Marketing API. Эти шаги можно выполнить позже из панели приложения.

Шаг Overview с кнопкой Create app

Создание системного токена Meta Ads

Создайте системного пользователя, назначьте приложение и рекламные аккаунты, затем создайте бессрочный токен доступа.

Откройте System users и добавьте новогоStep 1

Перейдите в Users > System users и нажмите + Add в правом верхнем углу.

Раздел System users с кнопкой Add
Создайте системного пользователяStep 2

Заполните поля и создайте пользователя:

  1. System user name.
    Введите понятное имя, например Renta - system user.
  2. System user role.
    Выберите Admin, чтобы пользователь мог управлять назначенными ресурсами.
  3. Нажмите Create system user.
Диалог Create system user с именем и ролью
Подключите приложение к Business-портфолиоStep 3

Перейдите в Accounts > Apps, нажмите + Add и выберите Connect an app ID в диалоге What do you want to do?.

Диалог What do you want to do с пунктом Connect an app ID
Добавьте App IDStep 4

Введите App ID приложения, созданного в предыдущем разделе (его можно найти в My Apps на Meta for Developers), и нажмите Add app.

Диалог Add an app с полем App ID
Назначьте приложение системному пользователюStep 5

Откройте системного пользователя и назначьте приложение:

  1. Выберите Apps в разделе Select asset type.
  2. Выберите своё приложение и включите Manage app в разделе Full control.
  3. Нажмите Assign assets.
Диалог Select assets с Apps и разрешением Manage app
Назначьте рекламные аккаунты системному пользователюStep 6

Повторите назначение для рекламных аккаунтов, которые хотите синхронизировать:

  1. Выберите Ad accounts в разделе Select asset type.
  2. Выберите рекламные аккаунты для синхронизации и включите Manage ad accounts в разделе Full control.
  3. Нажмите Assign assets.
Диалог Select assets с Ad accounts и разрешением Manage ad accounts
Начните создание токенаStep 7

Выберите системного пользователя в списке и нажмите Generate token в правом верхнем углу.

Профиль системного пользователя с кнопкой Generate token
Выберите приложениеStep 8

В выпадающем списке Select app выберите подключённое ранее приложение и нажмите Next.

Диалог Generate token с выпадающим списком Select app
Сделайте токен бессрочнымStep 9

В разделе Token expiration выберите Never, чтобы токен оставался действительным для долгих пайплайнов, затем нажмите Next.

Шаг Token expiration с выбранным вариантом Never
Выберите разрешения и создайте токенStep 10

В разделе Select permissions включите следующие разрешения и нажмите Generate token:

  1. ads_management
  2. ads_read
  3. business_management
  4. pages_read_engagement
  5. pages_show_list
Шаг Assign permissions с выбранными разрешениями
Скопируйте токенStep 11

Нажмите Copy, чтобы сохранить токен, затем нажмите Done.

Скопируйте токен сразу и сохраните его в надёжном месте. Meta показывает полный токен только один раз.

Диалог Token created с кнопкой Copy

Добавление токена в источник Facebook Ads в Renta

Создайте источник Facebook Ads в Renta и авторизуйте его с помощью системного токена Meta.

Добавьте новый источникStep 1

В левом боковом меню откройте Connections > Sources и нажмите + Add source в правом верхнем углу.

Выберите Facebook AdsStep 2

В каталоге выберите карточку Facebook Ads в категории Advertising.

Авторизуйтесь методом Custom tokenStep 3

Заполните данные подключения и нажмите Save:

  1. Select authorization method.
    Выберите Custom token, чтобы использовать сгенерированный системный токен Meta.
  2. Source name.
    Введите имя подключения. Оно используется исключительно в интерфейсе Renta.
  3. Access token.
    Вставьте токен, скопированный из Meta.

Остальные настройки пайплайна, типы отчётов и параметры синхронизации описаны на странице источника Meta Ads.

Часто задаваемые вопросы

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.