Синхронізація витрат 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 і випуск токена
Відкрийте Meta → Соціальні профілі і створіть або відредагуйте профіль Facebook.
Спосіб підключення — «Антидетект-агент».
Збережіть профіль — токен генерується для вже збереженого профілю.
У блоці агента натисніть «Згенерувати токен» і скопіюйте його.
Токен показується один раз. Перевипуск робить попередній токен недійсним. Зберігайте його як секрет.
Крок 2. Встановлення агента в профіль антидетект-браузера
Агент поширюється не через Chrome Web Store — це сайдлоад-розширення. Архів агента отримайте у свого менеджера.
Отримайте архів агента і розпакуйте його в окрему папку.
Встановіть розпаковане розширення в потрібний профіль антидетект-браузера (завантаження «unpacked»-розширення). Точний шлях залежить від версії антидетекта:
AdsPower: в налаштуваннях профілю / розділ роботи з розширеннями додайте локальне розширення з розпакованої папки, потім запустіть профіль.
Vision: в розділі розширень профілю додайте розпаковану папку агента і запустіть профіль.
Відкрийте профіль і запустіть агента (іконка розширення на панелі браузера).
Крок 3. Введення токена і вибір антидетекта
На стартовому екрані агента вставте скопійований токен і натисніть «Застосувати». Агент перевірить токен і покаже прив'язані користувача, команду і соц-профіль. Збереження токена підтверджує згоду на підключення профілю до Adset.pro.
Відкрийте Налаштування (шестерня) → блок «Антидетект-браузер» і виберіть тип браузера.
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 уточнює нещодавні цифри заднім числом, а синк йде з перекриттям. Суми сходяться по мірі «дозрівання» даних.
Безпека токена
Токен агента прив'язаний до конкретного соц-профілю і користувача. Перевипуск інвалідовує попередній.
Зберігайте токен як секрет: не публікуйте його в відкритих чатах і репозиторіях.
При зміні власника профілю або деактивації користувача токен перестає працювати.