# 使用动态内容

Dynamic Content (动态内容) 允许您通过使用从用户那里收集的相应 Tag 值来修改消息内容，从而个性化您的推送消息。这使您可以用用户的名字称呼他们，并在消息中使用他们的任何偏好设置，使消息对每一位用户都具有相关性。

### 使用动态内容个性化通过 API 发送的消息

要使用动态内容个性化通过 API 发送的消息，请确保您为动态内容占位符使用正确的语法。

**1.** 要向未设置 Tag 的用户发送包含某个默认 Tag 值的消息，请使用以下动态内容语法：`{Tag_name|format_modifier|default_value}`。

> 例如，消息 "Hello `{Alias|CapitalizeFirst|friend}`!" 将会发送给未指定别名的用户，显示为 "Hello friend!"。

<Aside type="caution" title="重要提示">
请注意，选项 2 和 3 仅相差一个 "|" 字符，但它们的行为方式完全相反。
</Aside>

**2.** 要忽略未设置 Tag 的用户，请添加如下格式的动态内容：`{Tag_name|format_modifier}`。当没有末尾的 "|" 字符时，系统会认为已勾选_忽略未设置 Tag 的用户_。

> 例如，消息 "Get a -20% coupon in `{Restaurant|CapitalizeFirst}` now!" 将仅发送给那些在其设备上设置了任何 Tag 值或在 API 请求的 `dynamic_content_placeholders` 参数中指定了 Tag 值的用户。未设置 Tag 的用户将不会收到任何消息。

**3.** 要向未设置 Tag 的用户发送消息，请按如下格式设置动态内容：`{Tag_name|format_modifier|}`。当有末尾的 "|" 字符时，系统会认为未勾选_忽略未设置 Tag 的用户_。

> 例如，消息 "Get a -20% coupon in `{Restaurant|CapitalizeFirst|}` now!" 将发送给所有目标受众，包括未指定 Tag 值的用户。由于用户没有 Tag 值，也未指定默认值，未设置 Tag 的用户将收到原始消息——"Get a -20% coupon in `{Restaurant|CapitalizeFirst|}` now!"。

## 结果

最终，假设用户 Klaus 和 Annie 将会收到来自同一营销活动但根据其姓名和偏好个性化的推送消息：

<img src="/personalization-dynamic-content-1.webp" alt="示例推送通知，展示了为 Klaus 和 Annie 个性化定制的包含其姓名和偏好的消息"/>