Adset.ProAdset.ProKnowledge base
Home/Интеграции/Синхронизация расходов Facebook через антидетект-агент (Spend Agent)
This article is currently available in Russian only.View in Russian

Синхронизация расходов Facebook через антидетект-агент (Spend Agent)

Руководство пользователя: как подключить Facebook через антидетект-агент (метод подключения «Антидетект-агент»), чтобы рекламные расходы автоматически попадали в Adset.pro из профилей антидетект-браузера — AdsPower или Vision.

Это отдельный способ подтягивания костов. Общая подготовка (соц-профиль, маппинг макросов, привязка объявлений к кампаниям) описана в статье «Подтягивание расходов (костов) с Facebook» — она нужна и здесь. Ниже — только то, что специфично для агента.


Что это и когда выбирать

Агент — это расширение, которое устанавливается внутрь профиля антидетект-браузера. Он передаёт в Adset.pro данные, необходимые для доступа к статистике рекламных кабинетов, вместе с прокси профиля. Дальше расходы тянет сервер Adset.pro, обращаясь к Facebook через прокси профиля — с того же IP, что и сам байер.

Ключевое отличие от обычного плагина «Adset.pro Cost Sync» (Chrome Web Store): там синхронизацию выполняет сам браузер и нужна открытая вкладка Ads Manager на каждый синк. Здесь синк идёт на сервере по расписанию, а браузер профиля нужен лишь для того, чтобы агент периодически обновлял доступ.

Плагин «Cost Sync» (Web Store)

Антидетект-агент (эта статья)

Где ставится

Обычный Chrome, из Chrome Web Store

Профиль антидетект-браузера (AdsPower / Vision), сайдлоадом

Кто тянет данные

Браузер (нужна открытая вкладка Ads Manager)

Сервер Adset.pro через прокси профиля

Прокси

Не требуется (запросы из браузера)

Обязателен — прокси профиля; без него синк не идёт

Когда выбирать

Работа из обычного Chrome, вкладка Ads Manager открыта

Работа из антидетект-профилей, синк с IP профиля


Что понадобится

  • Антидетект-браузер AdsPower или Vision с настроенным профилем Facebook (залогинен, с рабочим прокси).

  • Прокси у профиля обязателен. Сервер обращается к Facebook только через прокси профиля — без него синхронизация не выполняется.

  • Выполненная общая настройка из основной статьи по костам: соц-профиль Facebook, маппинг FB-макросов ({{campaign.id}}/{{adset.id}}/{{ad.id}}) в источнике и track-ссылка в креативе — иначе расход появится в разделе Meta, но не привяжется к кампаниям.

  • Правило привязки: 1 профиль = 1 соц-профиль = 1 токен агента. Один токен нельзя использовать для нескольких профилей.


Шаг 1. Подключение в Adset.pro и выпуск токена

  1. Откройте Meta → Социальные профили и создайте либо отредактируйте профиль Facebook.

  2. Способ подключения — «Антидетект-агент».

  3. Сохраните профиль — токен генерируется для уже сохранённого профиля.

  4. В блоке агента нажмите «Сгенерировать токен» и скопируйте его.

Токен показывается один раз. Перевыпуск делает прежний токен недействительным. Храните его как секрет.


Шаг 2. Установка агента в профиль антидетект-браузера

Агент распространяется не через Chrome Web Store — это сайдлоад-расширение. Архив агента получите у своего менеджера.

  1. Получите архив агента и распакуйте его в отдельную папку.

  2. Установите распакованное расширение в нужный профиль антидетект-браузера (загрузка «unpacked»-расширения). Точный путь зависит от версии антидетекта:

    • AdsPower: в настройках профиля / раздел работы с расширениями добавьте локальное расширение из распакованной папки, затем запустите профиль.

    • Vision: в разделе расширений профиля добавьте распакованную папку агента и запустите профиль.

  3. Откройте профиль и запустите агент (иконка расширения на панели браузера).


Шаг 3. Ввод токена и выбор антидетекта

  1. На стартовом экране агента вставьте скопированный токен и нажмите «Применить». Агент проверит токен и покажет привязанные пользователя, команду и соц-профиль. Сохранение токена подтверждает согласие на подключение профиля к Adset.pro.

  2. Откройте Настройки (шестерёнка) → блок «Антидетект-браузер» и выберите тип браузера.

AdsPower

  • Тип антидетекта — AdsPower.

  • Адрес Local API подставлен по умолчанию — менять не нужно. Если всё же меняете, указывайте 127.0.0.1, а не local.adspower.net: доменный адрес уходит в прокси профиля и отвечает «403 Access Denied».

  • Ключ Local API — нужен, только если в AdsPower включена проверка доступа к Local API (AdsPower → Settings → Local API). Если выключена — поле оставьте пустым.

Vision

  • Тип антидетекта — Vision.

  • Адрес API подставлен по умолчанию — менять не нужно.

  • X-Tokenобязателен. Скопируйте его в Vision: Settings → X-Token — и вставьте в поле ключа. Без X-Token агент не увидит профили Vision.

  • Синхронизируются только открытые профили — то есть тот, в котором запущен агент.

Если антидетект не используется (обычный Chrome), выберите «Нет (обычный Chrome)»: агент определит профиль автоматически, а прокси возьмёт из настроек браузера или из ручного ввода.


Шаг 4. Прокси профиля

Прокси обязателен. Агент подтягивает его из настроек профиля автоматически.

  • Проверить, какой прокси уедет на сервер, можно на экране профилей в агенте.

  • Если логин и пароль прокси не подтянулись автоматически, укажите их вручную в настройках агента — иначе сервер не сможет пройти прокси.


Авто-синхронизация и как идёт синк

  • В настройках включите Авто-синхронизацию и выберите интервал: 1, 5, 15, 30 минут или 1 час. Агент периодически обновляет доступ — пока профиль браузера открыт.

  • Сам сбор расходов выполняет сервер Adset.pro по расписанию, через прокси профиля. Это продолжает работать и после закрытия браузера — пока доступ остаётся действительным.

  • Окно дат выбирает Adset.pro автоматически: текущий день и несколько предыдущих, чтобы подхватывать правки данных Facebook задним числом. Сегодняшние цифры FB неокончательные и доуточняются в течение дня.


Где смотреть расход

  • Meta → Кабинеты / Кампании / Адсеты / Реклама — расход, показы, клики, CPC, CTR, CPM. Фильтр «Социальный профиль» наверху таблиц ограничивает данные одним профилем.

  • Отчёты по кампаниям трекера — расход добавляется к стоимости трафика, если выполнен маппинг FB-макросов и объявления привязаны track-ссылкой (см. общую статью по костам).


Настройки агента

  • Токен — показан замаскированным. Кнопка «Заменить» — вставить новый токен после перевыпуска в Adset.pro.

  • Авто-синхронизация и интервал (1/5/15/30/60 мин).

  • Антидетект-браузер, адрес API и ключ (см. Шаг 3), а также ручной прокси и id профиля для режима без антидетекта.

  • Язык (русский/английский/украинский) и тема (системная/светлая/тёмная).


Частые вопросы

Синхронизация не идёт: «не определён прокси профиля».

Прокси обязателен. Проверьте, что у профиля задан прокси, а если логин и пароль не подтянулись — впишите их вручную в настройках агента.

Vision не показывает профили.

Не задан X-Token либо он неверный. Скопируйте актуальный X-Token из Vision → Settings и вставьте в поле ключа. Синхронизируются только открытые профили.

Активных профилей несколько.

Один токен привязывается к одному профилю (1 профиль = 1 соц-профиль = 1 токен). Выберите нужный профиль в агенте — дальше авто-синк ходит только по нему. Для другого профиля заведите отдельный соц-профиль и токен.

Расход есть в таблицах Meta, но не в отчёте по кампании.

Не настроен маппинг FB-макросов в источнике или объявление не привязано к кампании track-ссылкой. См. раздел «Общая настройка» основной статьи по костам.

Авто-синхронизация не срабатывает.

Агент обновляет доступ, только пока профиль браузера открыт. Проверьте, что профиль не закрывается между запусками и переключатель авто-синка включён. Минимальный интервал — 1 минута.

Данные Facebook и Adset.pro не сходятся «копейка в копейку».

Это нормально: Facebook доуточняет недавние цифры задним числом, а синк идёт с нахлёстом. Суммы сходятся по мере «дозревания» данных.


Безопасность токена

  • Токен агента привязан к конкретному соц-профилю и пользователю. Перевыпуск инвалидирует прежний.

  • Храните токен как секрет: не публикуйте его в открытых чатах и репозиториях.

  • При смене владельца профиля или деактивации пользователя токен перестаёт работать.