Добавьте GA4 в карточку приложения AdBid
- Откройте список Apps в админке AdBid. Найдите веб-приложение по названию или ID и откройте его карточку. Для сохранения настроек нужен доступ на изменение приложения в админке.
- Найдите раздел Google Analytics (Measurement Protocol).
- В поле Ga measurement id вставьте Measurement ID веб-потока, например
G-XXXXXXXXXX. В поле Ga api secret вставьте Measurement Protocol API Secret из того же потока. Нажмите Сохранить. - В разделе Web SDK проверьте, что адрес сайта указан в Allowed origins. Скопируйте Web public key с префиксом
pw_live_для запросов с сайта.
В GA4 обе настройки находятся в Администратор → Потоки данных → ваш веб-поток. Секрет создаётся в разделе Секретные ключи API Measurement Protocol. Храните его в серверных настройках AdBid. Инструкция Google
Включите событие в AdBid
- В Event send rules откройте существующее правило для этого App или добавьте новое. Выберите нужное приложение в поле App, задайте Alias и отметьте Enabled. Для нового правила заполните обязательное поле Fb event name и сохраните.
- Скопируйте Code из сохранённого правила. Лендинг передаёт этот код в поле
code. В GA4 событие отображается под значением Alias, напримерemail_sent. Если новое правило должно отправлять только в GA4, снимите Web meta enabledи оставьте его без маппингов рекламных кабинетов. - Запросите
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 не требуется.
Проверьте приём и отправку
- Проверьте ответ POST.
HTTP 200иqueued_idозначают, что AdBid принял запрос. - Найдите
queued_idв очереди событий AdBid. В результате доставки GA4найдите связанныйSentEvent. Проверьте имя события,client_idи ответHTTP 204. - Откройте Отчёты → В реальном времени в том же ресурсе GA4 и найдите точное имя события.
HTTP 204подтверждает приём HTTP-запроса. Появление события в отчёте проверяется отдельно.
Если email_sent пропущено, проверьте, заполнены ли оба поля GA4 в настройках App, дошёл ли ga_client_id и не отклонил ли посетитель аналитику. Для отчётов GA4 используется браузерный client_id. Офлайн-конверсии Google Ads через Data Manager используют другой набор идентификаторов.
Проверка Measurement ProtocolИдентификаторы Google Ads Data Manager