使用自定义数据集处理入站关键词 custom-dataset-inbound-keywords

在此页面上:​了解如何在启用用户档案的自定义数据集中存储入站SMS关键字,方法是创建Adobe Experience Platform架构和数据集,然后在Adobe Journey Optimizer SMS API凭据中引用它们。

入站SMS关键字可以存储在启用用户档案的自定义数据集中。 该配置包含Adobe Experience Platform架构、从该架构创建的数据集,以及引用入站消息数据集的Journey Optimizer SMS API凭据。

NOTE
如果未配置自定义数据集,则默认情况下将入站关键字存储在系统​_AJO电子邮件跟踪数据集_​中。 在此数据集中捕获传入消息之前,轮廓必须至少收到过一条来自 Journey Optimizer 的消息。 了解有关系统数据集的更多信息

有关架构、字段组和数据集的背景,请参阅以下Adobe Experience Platform文档:

要将自定义数据集用于入站关键词,您需要:

创建架构 create-schema

架构定义适用于所摄取数据的结构和验证规则。 通过添加下面列出的现有字段组,为入站关键词集合构建体验事件架构。

➡️ 在Adobe Experience Platform文档中了解有关架构创建的更多信息

  1. 在Adobe Experience Platform中,从​ 数据管理 ​访问​ 架构 ​并选择​创建架构

  2. 选择​标准架构

  3. 选择​体验事件

  4. 输入架构的​显示名称,然后单击​完成

    这将保存架构并打开架构编辑器。

  5. 打开​ 架构属性 ​并启用​ 配置文件 ​的架构。

  6. 在​ 字段组 ​中,添加这些现有的字段组:

    • Adobe CJM ExperienceEvent - Message interaction details
    • Adobe CJM ExperienceEvent - Message Execution Details
    • Adobe CJM ExperienceEvent - Message Profile Details
  7. 单击​保存

创建数据集 create-dataset

数据集是所摄取数据的存储容器。 每个数据集只与一种架构关联,写入数据集的记录必须符合该架构。

  1. 在Adobe Experience Platform中,从​ 数据管理 ​访问​ 数据集 ​并选择​创建数据集

  2. 选择​ 从架构 ​创建数据集。

  3. 选择在上一部分中创建的架构,然后单击​下一步

  4. 输入​ 名称 ​并单击​完成

  5. 从​ 数据活动 ​选项卡,启用​ 配置文件 ​的数据。

    选择适合组织治理要求的​ 数据保留 ​策略。

  6. 单击​保存

配置API凭据 configure-api-credentials

使用开始使用短信/彩信/RCS配置,根据短信提供商配置凭据。 然后,完成以下步骤以选择自定义集客数据集。

  1. 在左边栏中,浏览到​管理 > 渠道 > SMS设置​并选择​ API凭据 ​菜单。 单击​ 创建新API凭据 ​按钮。

  2. 创建或编辑凭据,具体取决于您的提供商。

  3. 启用​ 为入站 ​使用自定义数据集选项。

  4. 选择在上一部分中创建的​数据集

  5. 填写所有其余必填字段,然后单击​保存

    note
    NOTE
    保存API凭据后,Journey Optimizer会验证入站关键词数据集是否已正确配置。 如果验证失败,则会显示一条错误消息,指示所需的更正。

保存凭据后,出站和入站消息传递行为保持不变;该凭据的入站关键字会记录在选定的自定义数据集中。

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to store inbound SMS keywords in a profile-enabled custom dataset by creating an Adobe Experience Platform Experience Event schema and a dataset from it, then referencing that dataset in the Journey Optimizer SMS API credentials.

Intents:

  • Create an Experience Event schema enabled for Profile with the required field groups
  • Create a dataset from that schema and enable it for Profile
  • Reference the custom dataset in the SMS API credentials so inbound keywords are recorded in it
  • Understand where inbound keywords are stored when no custom dataset is configured

Glossary:

  • Custom dataset for inbound: A profile-enabled dataset where inbound SMS keywords for a credential are recorded, selected through the Use custom dataset for inbound option in the SMS API credentials (product-specific)
  • Schema: A structure that defines the validation rules applied to ingested data; here an Experience Event schema enabled for Profile (product-specific)
  • Dataset: The storage container for ingested data, associated with exactly one schema (product-specific)
  • AJO Email Tracking Dataset: The system dataset where inbound keywords are stored by default when no custom dataset is configured (product-specific)

Guardrails:

  • The schema must be an Experience Event schema enabled for Profile and include the field groups Adobe CJM ExperienceEvent - Message interaction details, Adobe CJM ExperienceEvent - Message Execution Details, and Adobe CJM ExperienceEvent - Message Profile Details.
  • Each dataset is associated with exactly one schema, and records written must conform to that schema.
  • The dataset must be enabled for Profile.
  • If no custom dataset is configured, inbound keywords are stored in the system AJO Email Tracking Dataset, and a profile must have at least one message sent from Journey Optimizer before incoming messages are captured in it.
  • Upon saving API credentials, Journey Optimizer validates that the inbound keyword dataset is configured correctly; if validation fails, an error message indicates the required correction.

Terminology:

  • Canonical name: Use custom dataset for inbound — Acronym: n/a — variants: custom dataset for inbound keywords, custom inbound dataset
  • Do not confuse: “custom dataset for inbound” (a dataset you create and select) ≠ “AJO Email Tracking Dataset” (the default system dataset used when none is configured)

FAQ:

  • Q: Where are inbound keywords stored if I do not configure a custom dataset? — They are stored in the system AJO Email Tracking Dataset by default.
  • Q: Which field groups must the schema include? — Adobe CJM ExperienceEvent - Message interaction details, Adobe CJM ExperienceEvent - Message Execution Details, and Adobe CJM ExperienceEvent - Message Profile Details.
  • Q: How do I point a credential to the custom dataset? — In the SMS API credentials, enable the Use custom dataset for inbound option and select the dataset you created.
  • Q: What happens after the credentials are saved? — Journey Optimizer validates the inbound keyword dataset; outbound and inbound messaging behavior is unchanged and inbound keywords for that credential are recorded in the selected custom dataset.
recommendation-more-help
journey-optimizer-help