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. Не публикуйте файл ключа в чатах и тикетах; если ключ засветился — перевыпустите его.