Utilizzare un set di dati personalizzato per le parole chiave in entrata custom-dataset-inbound-keywords
In questa pagina: scopri come memorizzare le parole chiave SMS in entrata in un set di dati personalizzato abilitato per il profilo creando uno schema e un set di dati di Adobe Experience Platform, quindi facendo riferimento a esse nelle credenziali API SMS di Adobe Journey Optimizer.
Le parole chiave SMS in entrata possono essere memorizzate in un set di dati personalizzato abilitato per il profilo. La configurazione è costituita da uno schema Adobe Experience Platform, un set di dati creato da tale schema e dalle credenziali API SMS di Journey Optimizer che fanno riferimento al set di dati per i messaggi in entrata.
Per informazioni generali su schemi, gruppi di campi e set di dati, consulta la seguente documentazione di Adobe Experience Platform:
Per utilizzare un set di dati personalizzato per una parola chiave in entrata, è necessario:
Creare uno schema create-schema
Uno schema definisce la struttura e le regole di convalida che si applicano ai dati acquisiti. Componi uno schema Experience Event per la raccolta di parole chiave in entrata aggiungendo i gruppi di campi esistenti elencati di seguito.
➡️ Ulteriori informazioni sulla creazione di schemi nella documentazione di Adobe Experience Platform
-
In Adobe Experience Platform, da Gestione dati, accedere a Schemi e selezionare Crea schema.
-
Scegliere Schema standard.
-
Seleziona Evento esperienza.
-
Immetti un Nome visualizzato per lo schema e fai clic su Fine.
Lo schema viene salvato e viene aperto l’editor schema.
-
Apri Proprietà schema e abilita lo schema per Profilo.
-
In Gruppi di campi, aggiungi i seguenti gruppi di campi esistenti:
- Adobe CJM ExperienceEvent - Message interaction details
- Adobe CJM ExperienceEvent - Message Execution Details
- Adobe CJM ExperienceEvent - Message Profile Details
-
Fai clic su Salva.
Creare un set di dati create-dataset
Un set di dati è il contenitore di archiviazione per i dati acquisiti. Ogni set di dati è associato esattamente a uno schema e i record scritti nel set di dati devono essere conformi a tale schema.
-
In Adobe Experience Platform, da Gestione dati, accedere a Set di dati e selezionare Crea set di dati.
-
Scegli Crea set di dati dallo schema.
-
Seleziona lo schema creato nella sezione precedente e fai clic su Avanti.
-
Immetti un Nome e fai clic su Fine.
-
Dalla scheda Attività dati, abilita i dati per Profilo.
Selezionare il criterio Conservazione dati appropriato per i requisiti di governance organizzativa.
-
Fai clic su Salva.
Configurare le credenziali API configure-api-credentials
Configurare le credenziali in base al provider SMS utilizzando Introduzione alla configurazione di SMS/MMS/RCS. Quindi completa i passaggi seguenti per selezionare il set di dati in entrata personalizzato.
-
Nella barra a sinistra, passa a Amministrazione > Canali
>Impostazioni SMS e seleziona il menu Credenziali API. Fare clic sul pulsante Crea nuove credenziali API. -
Crea o modifica le credenziali in base al provider.
-
Abilita l’opzione Usa set di dati personalizzato per in entrata.
-
Seleziona il Set di dati creato nella sezione precedente.
-
Completare i campi obbligatori rimanenti e fare clic su Salva.
note NOTE Al momento del salvataggio delle credenziali API, Journey Optimizer verifica che il set di dati della parola chiave in entrata sia configurato correttamente. Se la convalida non riesce, viene visualizzato un messaggio di errore per indicare la correzione richiesta.
Dopo il salvataggio delle credenziali, il comportamento dei messaggi in uscita e in entrata rimane invariato; le parole chiave in entrata per tali credenziali vengono registrate nel set di dati personalizzato selezionato.
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.