> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Событие контакта

Узнайте больше об управлении событиями контактов в YCloud

## Определение событий

Отслеживание событий в YCloud помогает лучше понять, как клиенты используют ваш продукт. Это понимание позволяет отправлять персонализированные и актуальные сообщения, а также предоставляет весь необходимый контекст для поддержки клиентов.

События отражают действия ваших клиентов и время их совершения, например:

* Когда клиент регистрируется
* Когда клиент добавляет товар в корзину на вашем сайте
* Когда клиент переходит к оформлению заказа
* Когда клиент завершает оформление заказа
* Когда пользователь оформляет подписку или членство

События можно использовать в различных продуктах на платформе YCloud:

* **Триггер в Journey:** события могут запускать определенные действия.
* **Взаимодействие с клиентами в Inbox:** события позволяют службе поддержки просматривать недавние действия пользователей.
* **Определение результата конверсии CTWA:** события могут определять результаты конверсий.

**Сценарии использования:**

* **Journey:** как только клиент вызывает событие оплаты, он попадает в сценарий. Через 20 минут ожидания отправляется маркетинговое сообщение в WhatsApp с предложением завершить оплату. Если клиент оформляет заказ, он выходит из сценария.
* **CTWA:** когда клиент успешно оформляет заказ, событие заказа регистрируется как результат конверсии для CTWA, который затем передается на рекламную платформу.

<Info>
  Описанные здесь события — это лишь примеры; вы можете настраивать их в соответствии со своими потребностями.
</Info>

## Атрибуты события:

Каждое событие содержит следующую информацию:

* Название события
* Время события
* Идентификатор контакта: ID контакта (`objectId`), номер телефона (`contactPhoneNumber`) или имя пользователя Meta (`contactUsername`)

Используйте имя пользователя Meta, когда контакт уже существует в вашем аккаунте, но у вас нет его номера телефона. Отправляйте имя пользователя, сохраненное в контакте, без начального символа `@`. Если совпадений не найдено, событие отклоняется; имя пользователя не создает контакт автоматически.

Используется только один идентификатор. Если передано несколько идентификаторов, наивысший приоритет имеет числовой ID контакта, затем непустой номер телефона, а после него — имя пользователя Meta.

Каждое отслеживаемое событие также может содержать атрибуты, которые предоставляют дополнительную информацию о конкретном событии. Например, если вы отслеживаете событие «покупка», метаданные могут включать название и стоимость купленного товара.

* `STRING`: простая строка длиной до 255 символов.
* `NUMBER`: числовое значение с точностью до одного знака после запятой.
* `TIMESTAMP`: временная метка события.
* `URL`: строка в формате URL, начинающаяся с `http://` или `https://`.

## Создание и отправка событий

По умолчанию YCloud отслеживает только базовые события, такие как добавление новых контактов в ваш список контактов.

Для внедрения более ценных событий часто требуется помощь инженеров или разработчиков. Поделитесь этой документацией с коллегами и объясните, как именно вы планируете ее использовать.

* **Создание определения события:** [Открыть справочник по API](/api-reference/custom-events/create-an-event-definition)
* **Отправка события:** [Открыть справочник по API](/api-reference/custom-events/send-an-event)
* **Руководство по интеграции:** [Отслеживание пользовательских событий](/ru/api-reference/guides/customer-data-and-operations/track-custom-events) — правила для идентификаторов и примеры запросов с номерами телефонов или именами пользователей.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.