このページでは、 Adobe Experience Platform スキーマとデータセットを作成し、Adobe Journey Optimizer SMS API資格情報で参照することで、インバウンド SMS キーワードをプロファイル対応カスタムデータセットに保存する方法について説明します。
インバウンド SMS キーワードは、プロファイル対応のカスタムデータセットに保存できます。 この設定は、Adobe Experience Platform スキーマ、そのスキーマから作成されたデータセット、インバウンドメッセージのデータセットを参照するJourney Optimizer SMS API資格情報で構成されます。
スキーマ、フィールドグループ、データセットの背景については、次のAdobe Experience Platform ドキュメントを参照してください。
インバウンドキーワードにカスタムデータセットを使用するには、次のことが必要です。
スキーマの作成 create-schema
スキーマは、取り込んだデータに適用される構造と検証ルールを定義します。 以下に示す既存のフィールドグループを追加して、インバウンドキーワード収集用のエクスペリエンスイベントスキーマを作成します。
➡️ スキーマ作成の詳細については、Adobe Experience Platform ドキュメント を参照してください
-
Adobe Experience Platformで、Data managementから Schemas にアクセスし、Create schemaを選択します。
-
標準スキーマを選択します。
-
エクスペリエンスイベントを選択します。
-
スキーマの 表示名 を入力し、終了をクリックします。
スキーマが保存され、スキーマエディターが開きます。
-
スキーマプロパティを開き、プロファイルのスキーマを有効にします。
-
フィールドグループで、次の既存のフィールドグループを追加します。
- Adobe CJM ExperienceEvent - Message interaction details
- Adobe CJM ExperienceEvent - Message Execution Details
- Adobe CJM ExperienceEvent - Message Profile Details
-
「保存」をクリックします。
データセットの作成 create-dataset
データセットは、取り込んだデータのストレージコンテナです。 各データセットは1つのスキーマに関連付けられており、データセットに書き込まれたレコードは、そのスキーマに準拠している必要があります。
-
Adobe Experience Platformで、Data managementから データセット にアクセスし、データセットを作成を選択します。
-
「スキーマからデータセットを作成」を選択します。
-
前のセクションで作成したスキーマを選択し、次へをクリックします。
-
名前を入力し、完了をクリックします。
-
「データアクティビティ」タブで、プロファイルのデータを有効にします。
組織のガバナンス要件に適したデータ保持 ポリシーを選択します。
-
「保存」をクリックします。
API資格情報の設定 configure-api-credentials
SMS/MMS/RCS設定の基本を学ぶを使用して、SMS プロバイダーに従って資格情報を設定します。 次の手順を実行して、カスタムインバウンドデータセットを選択します。
-
左側のパネルで、管理／チャネル／
>SMS 設定を参照し、API 資格情報メニューを選択します。 「新しい API 資格情報を作成」ボタンをクリックします。 -
プロバイダーに応じて資格情報を作成または編集します。
-
「インバウンド用のカスタムデータセットを使用」オプションを有効にします。
-
前のセクションで作成した データセット を選択します。
-
残りの必須フィールドをすべて入力し、保存をクリックします。
note NOTE API資格情報を保存すると、Journey Optimizerはインバウンドキーワードデータセットが正しく設定されていることを検証します。 検証が失敗した場合は、必要な修正がエラーメッセージで示されます。
資格情報を保存すると、送信メッセージと受信メッセージの動作は変更されません。その資格情報の受信キーワードは、選択したカスタムデータセットに記録されます。
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.