# Использование динамического контента

Динамический контент позволяет персонализировать ваши push-уведомления, изменяя содержимое сообщения с помощью соответствующих значений тегов (Tag), которые вы собираете от ваших пользователей. Это позволяет обращаться к пользователю по имени и использовать любые его предпочтения в сообщении, чтобы сделать его релевантным для каждого отдельного пользователя.

### Персонализация сообщений, отправляемых через API, с помощью динамического контента

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

**1.** Чтобы обратиться к пользователям без тегов с сообщением, содержащим некоторое значение Tag по умолчанию, используйте следующий синтаксис динамического контента: `{Tag_name|format_modifier|default_value}`.

> Например, сообщение «Привет, `{Alias|CapitalizeFirst|friend}`!» будет отправлено пользователям без указанного псевдонима и будет выглядеть как «Привет, friend!».

<Aside type="caution" title="Важно">
Обратите внимание, что варианты 2 и 3 отличаются всего одним символом «|», но их поведение прямо противоположно.
</Aside>

**2.** Чтобы игнорировать пользователей без тегов, добавьте динамический контент в следующем формате: `{Tag_name|format_modifier}`. Когда закрывающего символа «|» нет, считается, что опция _Игнорировать пользователей без тегов_ включена.

> Например, сообщение «Получите купон на -20% в `{Restaurant|CapitalizeFirst}` прямо сейчас!» будет отправлено только тем пользователям, у которых на устройствах установлено какое-либо значение Tag или оно указано в параметре `dynamic_content_placeholders` API-запроса. Пользователи без тегов не получат никакого сообщения.

**3.** Чтобы отправить сообщение пользователям без тегов, отформатируйте динамический контент следующим образом: `{Tag_name|format_modifier|}`. Когда закрывающий символ «|» есть, считается, что опция _Игнорировать пользователей без тегов_ выключена.

> Например, сообщение «Получите купон на -20% в `{Restaurant|CapitalizeFirst|}` прямо сейчас!» будет отправлено всей целевой аудитории, включая пользователей без указанных значений Tag. Поскольку у пользователя нет значения Tag и значение по умолчанию не указано, пользователи без тегов получат сообщение как есть — «Получите купон на -20% в `{Restaurant|CapitalizeFirst|}` прямо сейчас!».

## Результаты

В результате вымышленные Клаус и Энни получат push-уведомления из одной и той же кампании, но персонализированные с их именами и предпочтениями:

<img src="/personalization-dynamic-content-1.webp" alt="Пример push-уведомлений, показывающих персонализированные сообщения для Клауса и Энни с их именами и предпочтениями"/>