Amplitude: установка свойств пользователя

Используйте элемент Amplitude: set user properties (установка свойств пользователя), чтобы обновить профиль пользователя Amplitude для участника Journey на определенном шаге. Обновление происходит через операцию $identify HTTP API V2, благодаря чему сегментация и когорты в Amplitude будут содержать те же данные, что и в Pushwoosh.

Pushwoosh устанавливает insert_id для Amplitude на основе данных об участнике и этом шаге. Это означает, что если один и тот же участник проходит через эту точку дважды (например, на втором круге зацикленного Journey), его профиль в Amplitude будет обновлен, а не продублирован.

Типичные сценарии использования:

• Синхронизация тегов с сегментами Amplitude: передавайте тарифный план, статус пробного периода или другой тег в профиль Amplitude, чтобы когорты Amplitude соответствовали аудиториям Pushwoosh.
• Поддержание актуальности профилей без отдельной задачи синхронизации: обновляйте профиль на том же шаге Journey, где изменился тег.
• Предотвращение дублирующих вызовов identify в цикле: встроенная дедупликация гарантирует, что повторное прохождение через эту точку обновит тот же профиль, а не создаст дубликат.

Настройка элемента

1. Перетащите элемент Amplitude: set user properties из раздела Интеграции на холст.
2. Дважды щелкните по элементу и введите Название шага.
3. В поле API key введите ключ API проекта из Amplitude: Settings > Projects > ваш проект > General. Он хранится в замаскированном виде, как секретный заголовок вебхука. Pushwoosh никогда не отображает и не возвращает его после сохранения, и он никогда не появляется в сохраненном запросе элемента или в журнале вызовов.

4. В поле Amplitude endpoint выберите регион, в котором был создан проект Amplitude: api2.amplitude.com для проекта в США, api.eu.amplitude.com для проекта в ЕС. Ключ из одного региона будет отклонен другим.

5. В разделе User properties добавьте по одной строке для каждого свойства, которое нужно установить в профиле Amplitude. Введите имя и значение свойства. Имена не должны быть пустыми и должны быть уникальными. Значение, представляющее собой один макрос участника, сохраняет свой тип в Amplitude ({{tag:Age}} передается как число, {{tag:Trial Ends}} — как дата). Любой другой текст отправляется как строка. Макросы используют тот же синтаксис, что и тело вебхука. Или нажмите Вставить динамическое значение, чтобы выбрать атрибут, созданный на предыдущем шаге этого Journey, например, ответ LLM или сопоставленное значение вебхука.

Пример

Установка в User properties свойства user_id со значением ID участника ({{device:user_id}}) и свойства plan с его тарифным планом ({{tag:Plan}}) установит эти два свойства в его профиле Amplitude.

6. Нажмите Сохранить.

Ответ

Участник переходит к следующему шагу, который вы подключите на холсте.

Атрибуты после выполнения шага

Атрибут	Содержимое
amplitude_events_ingested	Количество событий, полученных Amplitude

Как использовать на последующих шагах

Участник уже перешел к следующему шагу независимо от этого атрибута. Сохраните его в тег с помощью элемента Обновить профиль пользователя, если вам нужно подтвердить, что обновление было получено, или создать ветвление на его основе с помощью Разделения по условию.

Сбои и непредвиденные ответы

Неудачный запрос удаляет участника из Journey. См. Ошибки и неудачные запросы.

Пример: синхронизация профиля подписчика в Amplitude

Команда хочет, чтобы тарифный план участника обновлялся в его профиле Amplitude сразу после изменения в Pushwoosh.

1. Добавьте элемент Amplitude: set user properties сразу после шага, на котором меняется тарифный план. В разделе User properties установите для plan значение {{tag:Plan}}.
2. Нажмите Сохранить.

После выполнения этого шага профиль Amplitude будет отражать изменение тарифного плана без необходимости отдельной задачи синхронизации.