Подключение Meta

Чтобы Blukit мог получать данные рекламных аккаунтов, публиковать кампании и управлять рекламными объектами, необходимо подключить Meta.

Основной способ подключения — токен системного пользователя (System User token). Это токен Meta, выпущенный для системного пользователя вашего бизнес-портфолио.

Как устроено подключение

Подключение состоит из двух частей:

1. в Meta создаётся приложение и токен системного пользователя с доступом к необходимым рекламным ресурсам;
2. полученный токен добавляется в Blukit.

После проверки токена Blukit получает список доступных рекламных аккаунтов, страниц и пикселей.

---

1. Рекомендуемая схема

Перед началом настройки рекомендуем использовать отдельный надёжный профиль Meta с чистым бизнес-портфолио. Это бизнес-портфолио будет использоваться как центральное хранилище будущих приложений.

Не запускайте рекламу с этого профиля и не используйте его бизнес-портфолио для рабочих рекламных кампаний.

Все последующие шаги выполняйте именно в этом профиле и бизнес-портфолио.

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

---

2. Создайте приложение Meta

Откройте Meta for Developers. Если на вашем профиле ещё нет профиля разработчика, пройдите регистрацию или приобретите профиль с пройденной регистрацией. Затем перейдите в раздел «Мои приложения» и нажмите «Создать приложение».

1. Введите название приложения и адрес электронной почты.
2. В качестве сценария использования выберите «Создание и настройка рекламы с помощью Marketing API».
3. Выберите рабочее бизнес-портфолио, в котором находятся необходимые рекламные ресурсы. Если вы используете рекомендуемую схему, выберите бизнес-портфолио, в котором будут храниться будущие приложения. Этот шаг также можно пропустить и выполнить позже.
4. Перейдите к последнему шагу и нажмите «Создать приложение».

---

3. Настройте приложение

После создания приложения выполните следующие действия:

1. Откройте «Настройки приложения» → «Основные».
2. Добавьте URL политики конфиденциальности. Вы можете создать собственную политику с помощью бесплатного инструмента freeprivacypolicy.com или использовать готовый шаблон.
3. Выберите категорию приложения.
4. Сохраните настройки.

Если при создании приложения вы не выбрали бизнес-портфолио, добавьте его сейчас:

1. Перейдите в «Сценарии использования» → «Создание и настройка рекламы с помощью Marketing API».
2. Нажмите «Настроить».
3. Откройте раздел «Настройки».
4. Нажмите «+ Бизнес-портфолио» и выберите нужное бизнес-портфолио.
5. Нажмите «Select & verify later».

После настройки приложения и выбора бизнес-портфолио откройте в боковом меню раздел «Опубликовать» и нажмите «Опубликовать».

---

4. Предоставьте рабочему бизнес-портфолио доступ к приложению

Этот шаг нужен, если вы используете рекомендуемую схему с отдельным бизнес-портфолио для хранения приложений. Если нет, перейдите к пятому шагу.

1. Откройте «Настройки приложения» → «Основные».
2. Скопируйте ID приложения.
3. Откройте настройки рабочего бизнес-портфолио, в котором находятся нужные рекламные ресурсы.
4. Перейдите в «Аккаунты» → «Приложения» и нажмите «Добавить».
5. Выберите «Запросить доступ к ID приложения».
6. Вставьте скопированный ID приложения и нажмите «Запросить доступ к приложению».
7. Откройте настройки бизнес-портфолио хранителя.
8. Перейдите в раздел «Запросы» и подтвердите запрос от рабочего бизнес-портфолио.
   
   Таким образом, вы сможете создавать и хранить приложения в одном месте, предоставляя к ним доступ рабочим бизнес-портфолио через расшаривание. Это гораздо удобнее, чем каждый раз повторять процедуру для новых профилей.

---

5. Создайте системного пользователя

Откройте настройки рабочего бизнес-портфолио.

1. Перейдите в «Пользователи» → «Системные пользователи».

2. Нажмите «Добавить».

3. Укажите название системного пользователя. Например, можно использовать название бизнес-портфолио.

4. Выберите роль «Администратор» или «Сотрудник».

   Роль администратора может быть недоступна, если ваш профиль недостаточно долго находится в бизнес-портфолио.

5. Нажмите «Создать системного пользователя».

---

6. Назначьте ресурсы и создайте токен

Теперь предоставьте системному пользователю доступ ко всем ресурсам, которые будут использоваться в Blukit.

1. Откройте созданного системного пользователя.
2. Нажмите меню с тремя точками и выберите «Назначить ресурсы» (Assign assets).
3. По очереди назначьте системному пользователю необходимые ресурсы:
   • страницы;
   • рекламные аккаунты;
   • приложение;
   • пиксели.
4. Для назначенных ресурсов предоставьте полный доступ (Full access).
5. Сохраните назначения.
6. Нажмите «Создать токен» (Generate token).
7. В открывшемся окне выберите приложение.
8. Выберите срок действия токена. Рекомендуем использовать вариант «Никогда»
9. Выберите все доступные разрешения и нажмите «Создать токен» (Generate token).
10. Скопируйте и сохраните полученный токен в безопасном месте.

Если позже потребуется добавить новый ресурс, предоставьте системному пользователю доступ к нему по той же процедуре, затем обновите подключение в Blukit. Выпускать новый токен обычно не требуется.

---

7. Добавьте токен в Blukit

Откройте «Подключения» → «Добавить подключение».

Выберите подключение через токен системного пользователя (System User token).

Заполните форму:

Название подключения

Укажите произвольное название, по которому вы сможете отличать это подключение от других.

Токен

Вставьте токен, созданный в Meta.

При необходимости сразу укажите, кому будет доступно подключение.

Нажмите «Проверить и подключить».

После отправки токен сохраняется в защищённом виде и больше не отображается в интерфейсе.

---

8. Дождитесь проверки подключения

После добавления токена Blukit проверит его и начнёт получать назначенные ресурсы.

Успешное подключение получает статус «Подключено».

Иногда ресурсы могут появиться, но подключение при этом получит статус «Не удалось проверить». В таком случае повторно запустите проверку с помощью соответствующей кнопки.

После проверки убедитесь, что в списках отображаются нужные рекламные аккаунты, страницы и пиксели.

Если нужных ресурсов нет:

1. убедитесь, что системному пользователю назначен нужный ресурс в Meta;
2. проверьте уровень предоставленного доступа;
3. обновите список в Blukit.

Blukit может показать только те ресурсы, которые фактически доступны через подключённый токен.

---

Состояния подключения

В зависимости от результата проверки подключение может иметь одно из следующих состояний.

Подключено

Токен действителен, и Blukit может обращаться к Meta.

Частичный доступ

Подключение работает, но часть ожидаемых ресурсов или разрешений недоступна.

Проверьте назначения системного пользователя и разрешения в Meta.

Токен скоро истечёт

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

До истечения срока создайте новый токен и замените его в настройках подключения.

Токен истёк

Blukit больше не может использовать подключение для запросов к Meta.

Замените токен на новый.

Токен недействителен

Meta отклоняет токен.

Проверьте, не был ли он отозван или заменён. При необходимости создайте новый токен.

Не удалось проверить

Во время проверки произошла ошибка.

Повторите проверку. Если проблема сохраняется, проверьте состояние Meta и доступ системного пользователя к необходимым ресурсам.

---

Как добавить новые ресурсы

Если после первоначальной настройки в бизнес-портфолио появился новый рекламный ресурс, создавать новое подключение обычно не требуется.

1. Откройте системного пользователя в Meta.
2. Назначьте ему новый ресурс со всеми правами.
3. Новые пиксели обязательно назначьте на рекламные аккаунты.
4. Откройте раздел «Подключения» в Blukit.
5. Обновите подключение.

Если токен и разрешения остаются действительными, новые ресурсы появятся в существующем подключении.

---

Как заменить токен

Для подключения через токен системного пользователя можно заменить сохранённый токен без создания нового подключения.

Используйте эту функцию, если:

• старый токен истёк;
• токен был отозван;
• вы создали новый токен;
• изменился необходимый набор разрешений.

Откройте карточку подключения и выберите замену токена.

После сохранения Blukit повторно проверит доступ.

---

Доступ для команды

Подключение принадлежит пользователю, который его добавил.

В настройках подключения можно определить, кто ещё сможет его использовать:

• Все — подключение доступно участникам с соответствующим доступом к продукту;
• Выбранные участники — доступ получают только указанные пользователи.

Пользователь, которому предоставлен доступ к подключению, может использовать его в доступных функциях Blukit, но не получает автоматически права изменять или удалять само подключение.

Подробнее:

[Команда и права доступа →]

---

Если подключение не работает

В первую очередь проверьте четыре пункта:

1. Токен действителен.
2. Системному пользователю предоставлен доступ к нужным ресурсам.
3. Приложение назначено системному пользователю и имеет необходимые разрешения.
4. У текущего пользователя Blukit есть право использовать это подключение.

Если токен работает, но отсутствует только часть рекламных аккаунтов, страниц или пикселей, проблема обычно связана с доступом к конкретным ресурсам, а не со всем подключением.

Напишите в поддержку

---

Что дальше

После подключения Meta можно:

[Загрузить креативы →]

Перейти к существующим рекламным кампаниям:

[Управление кампаниями →]

Создать новые кампании:

[Создание и публикация кампаний →]