---
title: Google Analytics 4
slug: google-analytics-4
createdAt: 2024-05-23T10:53:42.584Z
---

Veeneo может отправлять [офлайн-конверсии](https://yandex.ru/support/metrica/data/offline-params.html#offline-params__conversion-period) в гугл аналитику, используя вебхук.

События в аналитику будут отправляться при достиженнии заданных условий в блоке "**3. Настройка целей и&#x20;стадий**". Например, можно настроить отправку конверсии в гугл аналитику на событие(добавление лида/сделки) или когда сделка приходит на определенную стадию, в конкретной воронке.

Желательно ознакомиться с документацией гугла по событиям [тут.](https://support.google.com/analytics/answer/13128484?hl=ru\&ref_topic=14710097\&sjid=5723122049102156504-EU)

## 1 - Базовые поля

![](https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/NSDlyoCLPSbzqBl2sSc0H_image.png)

### 1.1 - API SECRET

Чтобы создать новый секрет, перейдите в «**Администратор**» > «**Потоки данных**» > **выберите поток** > «**Секретный ключ API для Measurement Protocol**» > «**Создать**»

### 1.2 - Measurement ID

Копируем "**Идентификатор потока данных**".

## 2 - Идентификация

Здесь заполняются данные, по которым событие будет привязываться к пользователю.

Яндекс метрика может связывать событие с **client\_id**, user\_id и **session\_id**.

### 2.1 - Заполнение поля(ей) идетификации

![](https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/ywFmiWvR6EuR2A6SIh4cT_image.png)

1. **Кнопка для добавления поля для получения конкретного идентификатора.**
   Когда идентификатор может храниться в нескольких полях карточки, мы можем добавить эти поля в настройках связки. Тогда veeneo будет перебирать указанные поля до тех пор, пока не найдет первое заполненное.
   Найдя первое заполненное поле, veeneo будет использовать его для загрузки текущей офлайн-конверсии в метрику.
   Полей может быть сколько угодно.
    <font color="#eb144c">**Важно!**</font> Если Veeneo не сможет найти значение идентификатора, то конверсия не отправится в аналитику.

2. **Поле, в которое перетаскиваем ID поля из CRM.**
   Именно из этого поля CRM, Veeneo будет пытаться получить значение.

3. **Использование регулярного выражения**
   Подробно про регулярки написано [тут.](https://docs.veeneo.ru/otpravka-oflajn-konversij#pVojO)

4. **Поле куда нужно вставить регулярное выражение.**
   Для каждого поля регулярное выражение может быть свое уникальное.

5. **Хеширование Md5**
   Включает/отключает хеширование md5 для найденного идентификатора.

### 2.1 - Маппинг поля

Маппинг поля происходит путем перетаскивания мышкой поля из списка справа в поля из левой области.

![](https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/HcANTYwJ_Ut6tTtmL7ztE_image.png)

**Что мы делаем этой настройкой?**
Мы говорим Veeneo искать значение идентификатора пользователя в конкретном поле у сделки/лида. При этом Veeneo может использовать регулярное выражение, которое вы указали в соответствующем поле "**Regexp**".

Т.е во время работы Veeneo будет проходить по очереди по всем добавленным полям  пока не найдет значение. Если Veeneo не найдет значение или поля в сделке будут пустые, то конверсия в метрику не отправится.

## 3 - Настройка событий и стадий

Здесь настраиваются:

- События, которые нужно отправлять
- Условие, при которых нужно отправлять события

<font color="#eb144c">**Важно**</font> <font color="#eb144c">**ознакомиться с ограничениями**</font> гугл аналитику для событий [тут](https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag\&hl=ru#limitations).

### 3.1 - Событие покупки

::Image[]{src="https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/_FyR6MC9HHHpH82EMF0Ha_image.png" size="58" width="620" height="854" position="center" showCaption="false"}

- В параметр "Value" нужно перетянуть поле сделки/лида, где указывается сумма сделки/лида.

**Если нужно отредактировать событие:**

- Нажимаем на кнопку добаления события покупки.
- Заполняем новыми данными.
- Добавляем событие покупки и старые данные перезапишутся.
- После редактирования нужно обязательно нажать на кнопку "**Сохранить изменения**".

### 3.1 - Пользовательское событие

::Image[]{src="https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/iI5IdN2ZtMIXXitCQnJD9_image.png" size="56" width="625" height="1001" position="center" showCaption="false"}

1. Кнопка добавления.
2. Имена **событий&#x20;**&#x438; **параметров&#x20;**&#x434;олжны содержать не более 40 символов, могут содержать только латинский символы, цифры, знаки подчеркивания("\_") и должны начинаться с только буквенного символа.
3. Событие в CRM, при котором в аналитику будет отправляться событие.
   Может быть добавление сделки/лида или перемещение сделки/лида на конкретную сталю в конкретной воронке.
4. Кнопка добавления параметра, который будет дополнительно описывать событие.
5. Название параметра. Требования к заполнению смотрите в пункте 2.
6. Значение параметра, которое Veeneo будет брать из поля сделки. Т.е сюда нужно перетянуть из правой части поле CRM.

**Если нужно отредактировать событие:**

1. Нажимаем на кнопку добаления события.
2. В названии события указываем имя события, которое хотим отредактировать.
3. Заполняем новыми данными.
4. Нажимаем кнопку "Добавить событие" и старые данные перезапишутся.
5. После редактирования нужно обязательно нажать на кнопку "**Сохранить изменения**".

### Пример маппинга события и CRM

![](https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/CVZ6fhIZpJQnjfBS2AitU_image.png)

**Что сделано на сркиншоте?**

Настройки на скриншоте говорят Veeneo отправлять событие в гугл аналитику при добавлении новой сделки.

Это событие в отчетах гугл аналитики будет отображаться как "**add\_deal**". Так же у этого события можно будет уведить сумму и валюту.

### Проброс своих значений в событие GA4

Если нужно передавать параметр, который <u>не будет меняться и отсутствовать в теле вебхука</u>, то можно указать его начав строку со знака "**@**".

Пример:

::Image[]{src="https://api.archbee.com/api/optimize/9uMSHEm02UuyRb4W3S8nw/o7rwKschNCVrOIixZqtr7_image.png" size="62" width="579" height="539" position="center" showCaption="false"}

При отправке события, в GA4 будут загружаться параметры:

```json
{
   "client_id":111111.22222,
   "events":[
      {
         "name":"purchace",
         "params":{
            "session_id":3333333333,
            "UTM_SOURCE":"test_source",
            "currency":"USD",
            "value":"1000.00",
         }
      }
   ]
}
```

Таким образом мы в каждое событие передаем параметр "**currency**" со значением "**USD**"
