Usar um conjunto de dados personalizado para palavras-chave de entrada custom-dataset-inbound-keywords
Nesta página: saiba como armazenar palavras-chave SMS de entrada em um conjunto de dados personalizado habilitado para perfil, criando um esquema e um conjunto de dados do Adobe Experience Platform e, em seguida, fazendo referência a eles nas credenciais da API de SMS do Adobe Journey Optimizer.
As palavras-chave de SMS de entrada podem ser armazenadas em um conjunto de dados personalizado habilitado para perfil. A configuração consiste em um esquema do Adobe Experience Platform, um conjunto de dados criado a partir desse esquema e credenciais da API de SMS do Journey Optimizer que fazem referência ao conjunto de dados para mensagens de entrada.
Para obter informações sobre esquemas, grupos de campos e conjuntos de dados, consulte a seguinte documentação do Adobe Experience Platform:
Para usar um conjunto de dados personalizado para palavras-chave de entrada, é necessário:
Criar um esquema create-schema
Um esquema define a estrutura e as regras de validação que se aplicam aos dados assimilados. Componha um esquema de Evento de experiência para a coleção de palavras-chave de entrada adicionando os grupos de campos existentes listados abaixo.
➡️ Saiba mais sobre a criação de esquema na documentação do Adobe Experience Platform
-
No Adobe Experience Platform, em Gerenciamento de dados, acesse Esquemas e selecione Criar esquema.
-
Escolha Esquema padrão.
-
Selecione Evento de experiência.
-
Insira um Nome de exibição para o esquema e clique em Concluir.
O esquema é salvo e o editor de esquema é aberto.
-
Abra Propriedades do esquema e habilite o esquema para Perfil.
-
Em Grupos de campos, adicione estes grupos de campos existentes:
- Adobe CJM ExperienceEvent - Message interaction details
- Adobe CJM ExperienceEvent - Message Execution Details
- Adobe CJM ExperienceEvent - Message Profile Details
-
Clique em Save.
Criar um conjunto de dados create-dataset
Um conjunto de dados é o container de armazenamento para dados assimilados. Cada conjunto de dados está associado a exatamente um esquema e os registros gravados no conjunto de dados devem estar em conformidade com esse esquema.
-
No Adobe Experience Platform, em Gerenciamento de dados, acesse Conjuntos de dados e selecione Criar conjunto de dados.
-
Escolha Criar conjunto de dados do esquema.
-
Selecione o esquema criado na seção anterior e clique em Avançar.
-
Insira um Nome e clique em Concluir.
-
Na guia Atividade de dados, habilite os dados para Perfil.
Selecione a política de retenção de dados apropriada aos requisitos de governança organizacional.
-
Clique em Save.
Configurar credenciais da API configure-api-credentials
Configure credenciais de acordo com seu provedor de SMS usando a Introdução à configuração de SMS/MMS/RCS. Em seguida, conclua as etapas abaixo para selecionar o conjunto de dados de entrada personalizado.
-
No painel à esquerda, vá para Administração > Canais
>Configurações de SMS e selecione o menu Credenciais de API. Clique no botão Criar novas credenciais de API. -
Crie ou edite credenciais dependendo do seu provedor.
-
Habilite a opção Usar conjunto de dados personalizado para entrada.
-
Selecione o Conjunto de Dados criado na seção anterior.
-
Preencha os campos obrigatórios restantes e clique em Salvar.
note NOTE Ao salvar as credenciais da API, o Journey Optimizer valida se o conjunto de dados de palavra-chave de entrada está configurado corretamente. Se a validação falhar, uma mensagem de erro indicará a correção necessária.
Depois que as credenciais são salvas, o comportamento de mensagens de entrada e saída permanece inalterado; as palavras-chave de entrada para essa credencial são registradas no conjunto de dados personalizado selecionado.
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.