AdBid

Как подключить GA4 Measurement Protocol к AdBid

Добавьте Measurement ID и API Secret в карточку веб-приложения AdBid. Затем выберите событие, которое хотите видеть в GA4.

Добавьте GA4 в карточку приложения AdBid

  1. Откройте список Apps в админке AdBid. Найдите веб-приложение по названию или ID и откройте его карточку. Для сохранения настроек нужен доступ на изменение приложения в админке.
  2. Найдите раздел Google Analytics (Measurement Protocol).
  3. В поле Ga measurement id вставьте Measurement ID веб-потока, например G-XXXXXXXXXX. В поле Ga api secret вставьте Measurement Protocol API Secret из того же потока. Нажмите Сохранить.
  4. В разделе Web SDK проверьте, что адрес сайта указан в Allowed origins. Скопируйте Web public key с префиксом pw_live_ для запросов с сайта.

В GA4 обе настройки находятся в Администратор → Потоки данных → ваш веб-поток. Секрет создаётся в разделе Секретные ключи API Measurement Protocol. Храните его в серверных настройках AdBid. Инструкция Google

Включите событие в AdBid

  1. В Event send rules откройте существующее правило для этого App или добавьте новое. Выберите нужное приложение в поле App, задайте Alias и отметьте Enabled. Для нового правила заполните обязательное поле Fb event name и сохраните.
  2. Скопируйте Code из сохранённого правила. Лендинг передаёт этот код в поле code. В GA4 событие отображается под значением Alias, например email_sent. Если новое правило должно отправлять только в GA4, снимите Web meta enabledи оставьте его без маппингов рекламных кабинетов.
  3. Запросите GET /api/web/events/ с X-Public-Key и Origin сайта. Проверьте, что в destinations появился type: "ga" с вашим Measurement ID, а в events есть сохранённый код.

Отправьте событие с браузерным ID

Установите Google Tag на лендинге с тем же Measurement ID. После согласия посетителя на аналитику получите client_id текущего браузера из Google Tag.

gtag('get', 'G-XXXXXXXXXX', 'client_id', (clientId) => {
  // Передайте clientId как ga_client_id в запросе к AdBid.
})

Передайте его как ga_client_id на верхнем уровне POST. Подставьте публичный код из AdBid, ID посетителя Web SDK и фактический выбор посетителя. Для каждой новой отправки формы создавайте новый event_id. При повторе того же запроса используйте тот же event_id.

curl -i 'https://api.adbid.me/api/web/event/' \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://example.com' \
  -H 'X-Public-Key: pw_live_REPLACE_ME' \
  --data '{
    "code": "REPLACE_WITH_ADBID_EVENT_CODE",
    "external_id": "REPLACE_WITH_SDK_VISITOR_ID",
    "event_id": "REPLACE_WITH_UNIQUE_EVENT_ID",
    "landing": "https://example.com/signup",
    "ga_client_id": "REPLACE_WITH_GOOGLE_TAG_CLIENT_ID",
    "consent_state": {"analytics": true, "ads": false}
  }'

Для веб-события email_sent AdBid также читает custom_data.ga_client_idи может отправить событие до создания профиля. Передавайте технический ID браузера. Значение email из формы в этот запрос для GA4 не требуется.

Проверьте приём и отправку

  1. Проверьте ответ POST. HTTP 200 и queued_id означают, что AdBid принял запрос.
  2. Найдите queued_id в очереди событий AdBid. В результате доставки GA4найдите связанный SentEvent. Проверьте имя события, client_id и ответ HTTP 204.
  3. Откройте Отчёты → В реальном времени в том же ресурсе GA4 и найдите точное имя события. HTTP 204 подтверждает приём HTTP-запроса. Появление события в отчёте проверяется отдельно.

Если email_sent пропущено, проверьте, заполнены ли оба поля GA4 в настройках App, дошёл ли ga_client_id и не отклонил ли посетитель аналитику. Для отчётов GA4 используется браузерный client_id. Офлайн-конверсии Google Ads через Data Manager используют другой набор идентификаторов.

Проверка Measurement ProtocolИдентификаторы Google Ads Data Manager