Google-піксель (Google Ads, Data Manager API)

Google-піксель відправляє ваші конверсії (реєстрації, депозити тощо) безпосередньо в Google Ads через офіційний Data Manager API. Google використовує їх для атрибуції та оптимізації кампаній. Підключення займає ~15 хвилин і не вимагає запуску реклами або прив'язки картки.

Як це працює

• При кліку на вашу рекламу Google додає до посилання параметр gclid (для iOS-трафіку — gbraid/wbraid). Трекер зберігає його на кліку.
• Коли партнерка надсилає постбек про конверсію, трекер відправляє подію в Google Ads з цим ідентифікатором кліка.
• «Подією» в Google Ads виступає дія-конверсія (conversion action), яку ви створюєте у себе в кабінеті. У мапінгу пікселя кожній події трекера відповідає числовий Conversion Action ID.
• Авторизація — через ваш власний service account Google Cloud: ви один раз завантажуєте його JSON-ключ у піксель. Ключ зберігається в зашифрованому вигляді і ніколи не відображається повторно.

Крок 1. Обліковий запис Google Ads (якщо ще немає)

Google нав'язує майстра «першої кампанії» з оплатою. Обійти можна двома способами:

• Рекомендуємо — через менеджерський обліковий запис (MCC): відкрийте ads.google.com/home/tools/manager-accounts → Create a manager account (без кампанії та картки). Усередині MCC: Облікові записи → + → створюється звичайний клієнтський обліковий запис. Увага: валюта облікового запису не змінюється ніколи — обирайте усвідомлено.
• Швидкий: йдіть по майстру кампанії, на етапі оплати нічого не вводьте і перейдіть у кабінет по логотипу — обліковий запис вже створено, чернетку кампанії видаліть.

Customer ID — число виду 123-456-7890 у правому верхньому куті кабінету. Воно знадобиться у формі пікселя (можна з дефісами).

Крок 2. Проект Google Cloud і service account

1. Відкрийте console.cloud.google.com → створіть новий проект (наприклад, adset-postback). Білінг не потрібен.
2. APIs & Services → Library → знайдіть Data Manager API → Enable.
3. IAM & Admin → Service Accounts → Create service account. Ім'я будь-яке (наприклад, postback), ролі в GCP призначати не потрібно. Отримаєте email виду postback@ваш-проект.iam.gserviceaccount.com.
4. Відкрийте service account → вкладка Keys → Add key → Create new key → JSON. Файл завантажиться один раз — збережіть його.

⚠️ Якщо на кроці 4 помилка «Service account key creation is disabled» — ваш обліковий запис входить в організацію Workspace з політикою iam.disableServiceAccountKeyCreation. Попросіть адміністратора вимкнути її для проекту або створіть проект з особистого Gmail поза організацією.

Крок 3. Доступ у Google Ads

1. Кабінет Google Ads → Адміністратор → Доступ і безпека → Користувачі → +.
2. Вставте email service account з кроку 2, рівень доступу — Стандартний (Read-only не дозволяє завантажувати конверсії).
3. Якщо кабінетів кілька під одним MCC — можна додати email один раз на рівні MCC і заповнити в пікселі поле Manager (MCC) Customer ID.

Крок 4. Дія-конверсія

1. Цілі → Конверсії → Зведення → + Створити дію-конверсію.
2. Джерело даних: Офлайн-конверсії (в інших версіях інтерфейсу — «Імпорт → Conversions from clicks»). Підключати CRM/файли не потрібно — обирайте варіант з API або «налаштувати пізніше».
3. Ім'я (наприклад, Deposit), облік — «Кожна» (щоб повторні депозити зараховувалися окремо), вікно конверсії — за замовчуванням.
4. Відкрийте створену конверсію зі списку — в адресному рядку браузера скопіюйте число після ctId=. Це Conversion Action ID.
5. Повторіть для кожної події, яку хочете передавати (Deposit, Registration тощо).

Крок 5. Auto-tagging і проброс gclid

• Адміністратор → Налаштування облікового запису → Автоматична помітка (auto-tagging) — повинна бути включена, інакше gclid не додається до посилань.
• Якщо трафік йде через TDS/клоаку — переконайтеся, що редирект прокидає параметри: у вихідному посиланні повинно бути &gclid={gclid}&sub9={gbraid}&sub10={wbraid} (макроси залежать від вашої TDS). При використанні нашого шаблону джерела «Google Ads» і прямому трафіку нічого налаштовувати не потрібно.
• Конвенція для iOS-трафіку: gbraid і wbraid доставляються через sub9/sub10 — ці sub-поля на Google-джерелі зайняті.

Крок 6. Піксель в Adset.pro

1. Трекер → Пікселі → Створити, тип — Google Ads.
2. Завантажте JSON-ключ файлом — з'явиться галочка «Ключ валідний» і email service account (його ж ви додавали на кроці 3).
3. Заповніть Customer ID (10 цифр, дефіси допустимі). Manager ID — тільки якщо доступ видавали на рівні MCC.
4. Вкладка Події: кожній події — свій Conversion Action ID з кроку 4.
5. Збережіть → меню пікселя → Test Google connection. Перевірка нічого не записує в кабінет, але валідує ключ, доступ і всі ID.
6. Прив'яжіть піксель до кампанії (сет кампанії → Pixels) — як звичайний піксель.

Помилки Google API — швидка орієнтація

Відповідь Google показується як є: в тесті підключення — по кліку на червоний статус, в бойових відправках — в «Логи → Пікселі» (Response data). Типові випадки:

Автодеактивація: при фатальних помилках (відкликаний ключ, знятий доступ — 401/403) піксель автоматично вимикається, а власнику приходить сповіщення «Pixel deactivated». Після усунення причини увімкніть піксель назад у формі редагування.

Часті питання

• Конверсії не видно в кабінеті одразу. Статистика в Google Ads з'являється з затримкою ~3 години — це нормально. Імпортовані конверсії видно в «Цілі → Конверсії → Зведення» і на сторінці «Завантаження».
• Вікно атрибуції. Конверсія зараховується, тільки якщо потрапляє у вікно дії-конверсії (зазвичай 30–90 днів з кліка) і gclid дійсний.
• Валюта. Валюта конверсії передається з постбека партнерки (або з налаштувань CPA-мережі); валюта самого кабінету Google Ads впливає тільки на відображення звітів.
• Дублікати. Google дедуплікує наші події за унікальним ID транзакції — повторна відправка однієї конверсії не створить дублікат.
• Безпека ключа. JSON-ключ зберігається в зашифрованому вигляді і ніколи не повертається назовні — у формі видно тільки email і project id. Не публікуйте файл ключа в чатах і тикетах; якщо ключ засвітився — перевипустіть його.