このページ：では、「同意と環境設定の詳細」フィールドグループを使用して、リストの購読者にメッセージを送信するジャーニーを構築する方法を説明します。
このユースケースの目的は、ジャーニーを作成してリスト上の購読者にメッセージを送信することです。
この例では、Adobe Experience Platform の「同意と環境設定の詳細」フィールドグループを使用します。 このフィールドグループを見つけるには、 データ管理メニューから「スキーマ」を選択します。 「フィールドグループ」タブで、検索フィールドにフィールドグループの名前を入力します。
このジャーニーを設定するには、次の手順に従います。
-
読み取りアクティビティで始まるジャーニーを作成します。 詳しくは、初めてのジャーニーの作成を参照してください。
-
メールアクションアクティビティをジャーニーに追加します。 詳しくは、チャネルアクションの操作を参照してください。
-
メールアクティビティ設定の「メールパラメーター」セクションで、デフォルトのメールアドレス（
PersonalEmail.adress）をリスト上の購読者のメールアドレスに置き換えます。-
「アドレス」フィールドの右側にある「 パラメーターの上書きを有効にする」アイコンをクリックしたあと、編集アイコンをクリックします。
-
式エディターで、購読者のメールアドレスを取得する式を入力します。 詳細情報
この例では、マップフィールドへの参照を含む式を示しています。
code language-json #{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-email').subscribers.firstEntryKey()}この例では、次の関数が使用されています。
table 0-row-3 1-row-3 2-row-3 関数 説明 例 entry選択した名前空間に従ってマップ要素を参照します 特定のサブスクリプションリストを参照します firstEntryKeyマップの最初のエントリキーを取得します 購読者の最初のメールアドレスを取得します この例では、サブスクリプションリストの名前は
daily-emailです。 メールアドレスは、subscribersマップでキーとして定義されています。このマップはサブスクリプションリストマップにリンクされています。式におけるフィールドへの参照について詳しくは、こちらを参照してください。
-
式を追加ダイアログボックスで「OK」をクリックします。
-
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページでは、同意マップフィールドから購読者アドレスを読み取る式を使用して、デフォルトの電子メールアドレス パラメーターを上書きして、リストの購読者に電子メールを送信するジャーニーを構築する方法を示します。
インテント：
- 「オーディエンスを読み込む」アクティビティを使用して、特定のリストの購読者をターゲットとするジャーニーを構築します
- 式エディターを使用して、メールアクションアクティビティでデフォルトのメールアドレスを上書きする
entry関数とfirstEntryKey関数を使用して、同意マップから購読者のメールアドレスを取得します- 購読リストデータにアクセスするには、「同意と環境設定の詳細」フィールドグループを参照します
用語集：
- 電子メールアドレスの上書き（パラメーターの上書き）：購読リストのターゲティングなどの特殊なケースに使用される、デフォルトのプロファイル電子メールアドレスをカスタム式に置き換えるジャーニーメールアクティビティ設定。 （製品固有）
- 同意と環境設定の詳細フィールドグループ：購読と同意に関するデータを含むAdobe Experience Platform スキーマフィールドグループ。これには、購読者のメールアドレスを保存するために使用される
subscriptionsマップが含まれます。 （製品固有） entry関数：名前空間キーでマップ要素を参照する式の関数。ここでは、特定の購読リスト （例：daily-email）を参照するために使用します。 （製品固有）firstEntryKey関数: マップの最初のキーを取得する式の関数。ここでは、購読リストの購読者マップから最初の電子メールアドレスを取得するために使用します。 （製品固有）
ガードレール：
- メールアドレスの上書きは、サブスクリプションリストのターゲティングなどの特定のユースケースにのみ使用してください。ほとんどの場合、実行フィールドで定義されたプライマリアドレスを使用する必要があります
- このユースケースを機能させるには、同意と環境設定の詳細フィールドグループがスキーマに存在している必要があります
- 式で使用されるサブスクリプションリスト名（例：
daily-email）は、データで設定された名前と完全に一致する必要があります
用語：
- 正規名：電子メールアドレスの上書き – Acronym: none — バリアント：パラメーターの上書き、電子メールパラメーターの上書き
- 同義語：「購読リスト」 = 「購読者リスト」
- 「メールアドレスの上書き」≠「プライマリメールアドレス」 – プライマリメールアドレスは、すべてのジャーニーで使用されるデフォルトのアドレスです。上書きは、購読リストの送信などの特殊なケースにのみ使用されるアクティビティごとの式です
FAQ:
- Q: プロファイルの電子メールアドレスではなく、購読リストの購読者に電子メールを送信するにはどうすればよいですか？ — メールアクティビティの「アドレス」フィールドでパラメーターの上書きを有効にし、
entry関数とfirstEntryKey関数を使用して式を入力し、ターゲット購読リストの購読者マップからアドレスを取得します。 - Q：この使用例に必要なフィールドグループは何ですか？ — Adobe Experience Platformの「同意と環境設定の詳細」フィールドグループ。これには、購読者のメールアドレスを保存するために使用される
subscriptionsマップ構造が含まれます。 - Q：購読者をターゲティングする場合、メールアドレスを常に上書きする必要がありますか？ – いいえ。メールアドレスの上書きは、特定のユースケースにのみ適用されます。 ほとんどのジャーニーでは、「実行」フィールドで定義されたプライマリアドレスを使用する必要があります。
- Q:
firstEntryKey関数は、このコンテキストでどのような処理を行いますか？ – 特定の購読リストに関連付けられたsubscribersマップから最初の電子メールアドレス キーを取得し、ジャーニーで個々の購読者に対応できるようにします。