この例では、メールメッセージの本文をパーソナライズします。このメッセージは、ショッピングカートに商品が残っているが購入を完了していない顧客をターゲットにします。
次のタイプのヘルパー関数を使用します。
upperCase
文字列関数:顧客の名を大文字で挿入します。詳細情報。each
ヘルパー:カートに入っている商品をリストします。詳細情報。if
ヘルパー:関連製品がカートに入っている場合に製品固有のメモを挿入します。詳細情報。➡️ ヘルパー関数の使用方法については、このビデオをご覧ください
開始する前に、次の要素の設定方法を理解しておく必要があります。
次の手順に従います。
カートの内容は、ジャーニーからのコンテキスト情報です。したがって、カート固有の情報をメールに追加する前に、最初のイベントとメールをジャーニーに追加する必要があります。
スキーマに productListItems
配列が含まれるイベントを作成します。
この配列のすべてのフィールドを、このイベントのペイロードフィールドとして定義します。
製品リスト項目のデータタイプについて詳しくは、 Adobe Experience Platform のドキュメントを参照してください。
このイベントで開始されるジャーニーを作成します。
ジャーニーにメールアクティビティを追加します。
メールアクティビティで、「コンテンツを編集」をクリックしたあと、「電子メールデザイナー」をクリックします。
E メールデザイナーホームページの左側のパレットから、3 つの構造コンポーネントをメッセージの本文にドラッグ&ドロップします。
HTML コンテンツコンポーネントを、それぞれの新規構造コンポーネントにドラッグ&ドロップします。
E メールデザイナーのホームページで、顧客の名を追加する HTML コンポーネントをクリックします。
コンテキストツールバーで、「ソースコードを表示」をクリックします。
HTML を編集ウィンドウで、upperCase
文字列関数を追加します。
左側のメニューで、「ヘルパー関数」を選択します。
検索フィールドを使用して、「uppercase」を検索します。
検索結果から、upperCase
関数を追加します。それには、{%= upperCase(string) %}: string
の横のプラス記号(+)をクリックします。
式エディターには、次の式が表示されます。
{%= upperCase(string) %}
式から「string」プレースホルダーを削除します。
名トークンを追加します。
左側のメニューで、「プロファイル属性」を選択します。
ユーザー/姓名を選択します。
式に名トークンを追加します。
式エディターには、次の式が表示されます。
{%= upperCase(profile.person.name.firstName) %}
ユーザー名データタイプについて詳しくは、Adobe Experience Platform のドキュメントを参照してください。
「 検証」をクリックしてから、「保存」をクリックします。
メッセージを保存します。
メッセージコンテンツを再度開きます。
E メールデザイナーのホームページで、カートの内容を一覧表示する HTML コンポーネントをクリックします。
コンテキストツールバーで、「ソースコードを表示」をクリックします。
HTML を編集ウィンドウで、each
ヘルパーを追加します。
左側のメニューで、「ヘルパー関数」を選択します。
検索フィールドを使用して、「each」を検索します。
検索結果から、each
ヘルパーを追加します。
式エディターには、次の式が表示されます。
{{#each someArray as |variable|}} {{/each}}
式に productListItems
配列を追加します。
式から「someArray」プレースホルダーを削除します。
左側のメニューで、「コンテキスト属性」を選択します。
コンテキスト属性は、ジャーニーコンテキストがメッセージに渡された後でのみ使用できます。
Journey Optimizer/イベント/event_name を選択し、productListItems ノードを展開します。
この例では、event_name はイベントの名前を表します。
式に製品トークンを追加します。
式エディターには、次の式が表示されます。
{{#each context.journey.events.event_ID.productListItems.product as |variable|}} {{/each}}
この例では、event_ID はイベントの ID を表します。
式を次のように変更します。
次の例は、変更された式を示しています。
{{#each context.journey.events.event_ID.productListItems as |product|}}
次のコードを、{{#each}}
開始タグと {/each}}
終了タグの間に貼り付けます。
<table>
<tbody>
<tr>
<td><b>#name</b></td>
<td><b>#quantity</b></td>
<td><b>$#priceTotal</b></td>
</tr>
</tbody>
</table>
商品名、数量および価格のパーソナライゼーショントークンを追加します。
次の手順を 2 回繰り返します。
次の例は、変更された式を示しています。
{{#each context.journey.events.event_ID.productListItems as |product|}}
<table>
<tbody>
<tr>
<td><b>{{context.journey.events.event_ID.productListItems.name}}</b></td>
<td><b>{{context.journey.events.event_ID.productListItems.quantity}}</b></td>
<td><b>${{context.journey.events.event_ID.productListItems.priceTotal}}</b></td>
</tr>
</tbody>
</table>
{{/each}}
「検証」をクリックしてから、「保存」をクリックします。
E メールデザイナーのホームページで、メモを挿入する HTML コンポーネントをクリックします。
コンテキストツールバーで、「ソースコードを表示」をクリックします。
HTML を編集ウィンドウで、if
ヘルパーを追加します。
左側のメニューで、「ヘルパー関数」を選択します。
検索フィールドを使用して、「if」を検索します。
検索結果から、if
ヘルパーを追加します。
式エディターには、次の式が表示されます。
{%#if condition1%} render_1
{%else if condition2%} render_2
{%else%} default_render
{%/if%}
式から次の条件を削除します。
{%else if condition2%} render_2
次の例は、変更された式を示しています。
{%#if condition1%} render_1
{%else%} default_render
{%/if%}
製品名トークンを条件に追加します。
式から「condition1」プレースホルダーを削除します。
左側のメニューで、「コンテキスト属性」を選択します。
Journey Orchestration/イベント/event_name を選択し、productListItems ノードを展開します。
この例では、event_name はイベントの名前を表します。
式に名前トークンを追加します。
式エディターには、次の式が表示されます。
{%#if context.journey.events.`event_ID`.productListItems.name%}
render_1
{%else%} default_render
{%/if%}
式を次のように変更します。
式エディターで、name
トークンの後に製品名を指定します。
次の構文を使用します。ここで、product_name は製品の名前を表します。
= "product_name"
この例では、製品名は「Juno Jacket」です。
{%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
render_1
{%else%} default_render
{%/if%}
「render_1」プレースホルダーをメモのテキストに置き換えます。
例:
{%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
Due to longer than usual lead times on the Juno Jacket, please expect item to ship two weeks after purchase.
{%else%} default_render
{%/if%}
式から「default_render」プレースホルダーを削除します。
「 検証」をクリックしてから、「保存」をクリックします。
メッセージを保存します。
「テスト」トグルをオンにしてから、「イベントをトリガー」をクリックします。
イベント設定ウィンドウで、入力値を入力し、「送信」をクリックします。
テストモードは、テストプロファイルでのみ機能します。
メールがテストプロファイルのアドレスに送信されます。
この例では、Juno Jacket に関するメモがメールに含まれています。これは、この製品がカートに入っているからです。
エラーがないことを確認し、ジャーニーを公開します。
ヘルパー関数の使用方法を説明します。