Skip to main content

​
Что вам поможет эта страница

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

​
Почему это важно

Вы можете отправлять своевременные и релевантные электронные письма без повторного создания и запуска кампаний. Серверная часть контролирует, когда происходит событие, в то время как Nudgen хранит содержимое электронной почты, доставку, отслеживание и настройки контактов в одном месте.

​
Когда использовать пожизненную кампанию

Используйте пожизненную кампанию для электронной почты, управляемой событиями, например:
  • Подтверждения заказов
  • Напоминания о платежах
  • Регистрация на основе событий
  • Обновления учетной записи или подписки
В отличие от разовых и капельных кампаний, пожизненная кампания не отправляется сразу сохраненной аудитории. Его аудитория всегда — Триггер.

​
Создайте и активируйте кампанию

1

Create a Lifetime campaign

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

Define runtime parameters

Добавьте все значения, которые ваша система предоставит во время отправки. Параметр создает переменную data.*: например, order_id в электронном письме становится {{data.order_id}}.
3

Create the email

Сгенерируйте или напишите тему и HTML, а затем добавьте переменные времени выполнения туда, где они должны быть. Просмотрите электронное письмо и отправьте тестовое письмо, прежде чем активировать его.
4

Activate the campaign

Сохраните его как черновик и нажмите Активировать. Nudgen проверяет, представлены ли необходимые параметры в электронном письме и что контракт параметров не изменился с момента создания.
5

Create a trigger key

Перейдите в Настройки → Ключи API и создайте Ключ API группового триггера. Сохраните секрет ndg_team_* в своем бэкэнде или диспетчере секретов; никогда не размещайте его в коде браузера или мобильного приложения.

​
Параметры времени выполнения и переменные шаблона

Ваш variableManifest представляет собой контракт между шаблоном электронной почты и объектом data каждого триггера. В кампании можно определить до 100 переменных. Например, используйте в шаблоне {{data.order_id}}, {{data.total}} и {{data.order_url}}. Вы также можете использовать contact.*, event.*, brand.* и устаревшие переменные, такие как {{firstName}} и {{brandName}}. Nudgen экранирует значения переменных, вставленные в HTML. Шаблоны не поддерживают JavaScript, выражения и циклы. Любая переменная, используемая в href, должна быть переменной data.*, объявленной с типом url.

​
Управление жизненным циклом

Действительными переходами являются draft → active → paused → active и active|paused → archived.
Приостановка или архивирование отменяет выполнения, которые все еще находятся в ожидании или в очереди. Выполнение, которое уже обрабатывается, все еще может отправляться.
Каждое выполнение делает снимки содержимого кампании и отправляет настройки, когда Nudgen получает триггер. Изменение активной кампании влияет только на последующие триггеры, а не на уже существующие исполнения.

​
Триггер из вашего серверного интерфейса

Вызовите конечную точку триггера с доверенного сервера после проверки исходного события. Используйте ключ API триггера группы, а не токен личного доступа (PAT).
Сохраняйте тот же eventId при повторной попытке события. Nudgen возвращает существующее выполнение с помощью 200 и duplicate: true вместо отправки еще одного подталкивания. Новое выполнение возвращает 201.

​
Безопасная интеграция

  • Запуск от потребителя веб-перехватчика или серверной части и проверка входящего веб-перехватчика перед вызовом Nudgen.
  • Повторить ошибки сети, 429 и 503 с экспоненциальной задержкой и тем же самым eventId. – Не регистрируйте заголовки Authorization или полезные данные, содержащие конфиденциальные контактные данные. – Регулярно меняйте триггерные ключи и немедленно отзывайте ключ, если вы подозреваете, что он раскрыт. – Создайте одну кампанию для каждого типа события и переменного контракта, чтобы шаблоны и аудит выполнения оставались ясными.

​
Отслеживайте исполнения

Откройте кампанию на панели управления, чтобы просмотреть последние выполнения и их статусы. Исполнение может быть pending, queued, processing, sent, skipped, cancelled, failed или delivery_unknown. skipped означает, что контакт был отписан от подписки или отклонен, поэтому Nudgen записывает событие, но не отправляет и не использует квоту. delivery_unknown означает, что поставщик, возможно, принял электронное письмо, но окончательный результат доставки был неопределенным; Nudgen не повторяет попытку автоматически, чтобы избежать повторной отправки. Информацию о программной настройке, запуске и выполнении запросов см. в Developer API.

​
Связанные документы

Campaigns overview

Сравните разовые, капельные и пожизненные кампании.

Developer API

Управляйте пожизненными кампаниями и триггерами с помощью API.