パーソナライゼーションのレシピ personalization-recipes

このページ：​では、Adobe Journey Optimizer コンテンツに直接コピーできる日付、配列、文字列、条件付きロジック、およびPQL エッジ ケースの、すぐに使用できるパーソナライズのレシピを見つけることができます。

このページでは、Adobe Journey Optimizerの最も一般的なユースケース向けに、すぐに使用できるパーソナライゼーションパターンを提供します。 あらゆる例でパーソナライゼーションエディターの構文を使用しており、電子メール、SMS、プッシュコンテンツに直接コピーできます。

使用可能な関数の完全な参照については、​ ヘルパー関数、日付/時刻関数、文字列関数、および配列関数を参照してください。

日付と時刻のレシピ date-time-recipes

レシピ 1 – 現在の日付を読みやすい形式で表示する recipe-current-date

formatDateとgetCurrentZonedDateTime()を使用して、任意の形式で今日の日付をレンダリングします。

{%= formatDate(getCurrentZonedDateTime(), "MMMM dd, yyyy") %}

出力（例）: April 11, 2026

一般的な形式パターン：

レシピ 2 – 有効期限またはイベント日までのカウントダウン recipe-countdown

dateDiffを使用して、プロファイル日付属性までの残り日数を計算し、動的にレンダリングします。

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}
{%#if daysLeft > 0%}
Your reward points expire in {{daysLeft}} day{%#if daysLeft > 1%}s{%/if%}. Use them before they're gone!
{%else%}
Your reward points have expired.
{%/if%}

出力（例）: Your reward points expire in 7 days. Use them before they're gone!

レシピ 3 – 動的な終了日のX日前 recipe-days-before

プロファイル属性のX日前の日付を計算するには（例：コンテンツや件名で参照）、負のオフセットでaddDaysを使用します。

{%= formatDate(addDays(stringToDate(profile.subscription.endDate), -7), "MMMM dd, yyyy") %}

出力（例）: April 04, 2026 （4月11日の7日前）

特定の時刻（例：午前9時）も設定するには、setHoursと組み合わせます。

{%= formatDate(setHours(addDays(stringToDate(profile.subscription.endDate), -7), 9), "dd/MM/yyyy HH:mm") %}

レシピ 4 – 現在の時間をHH:MMとしてのみ表示 recipe-time-only

extractHoursとextractMinutesを使用して、時間の部分のみを表示し、先頭にゼロのガードを数分だけ表示します。

{% let h = extractHours(getCurrentZonedDateTime()) %}
{% let m = extractMinutes(getCurrentZonedDateTime()) %}
Your appointment is at {{h}}:{%#if m < 10%}0{%/if%}{{m}}.

出力（例）: Your appointment is at 14:05.

レシピ 5 – 週末と平日の区別 recipe-weekend

dayOfWeekを使用して、日に基づいてコンテンツを適応させます。 関数は、1 （月曜日）から7 （日曜日）を返します。 1つの=演算子を使用します（==ではなくPQL構文）。

{%#if dayOfWeek(getCurrentZonedDateTime()) = 6 or dayOfWeek(getCurrentZonedDateTime()) = 7%}
We're closed on weekends — our team will follow up on the next business day.
{%else%}
Our team will get back to you within 24 hours.
{%/if%}

配列とループのレシピ array-recipes

レシピ 6 — プロファイル配列からのすべての項目をリストする recipe-list-items

{{#each}}を使用してプロファイル配列を繰り返し処理し、各項目をレンダリングします。 これは、パーソナライゼーションエディター（電子メール、SMS、プッシュ通知）でのみ使用できます。

{{#each profile.purchases.recentItems}}
  - {{this.name}}: {{this.price}}€
{{/each}}

出力（例）:

- Running shoes: 89€
- Water bottle: 15€
- Gym bag: 45€

レシピ 7 – 価格で配列から上位N個の項目を表示します recipe-first-n

topNを使用して、上位N個の項目を数値フィールドで並べ替えて取得します。 topNはPQL関数であるため、最初に{% let %}を使用して変数に割り当て、次に{{#each}}を使用してループします。

{% let topOrders = topN(profile.orders, price, 3) %}
{{#each topOrders}}
  {{this.name}} — {{this.price}}€
{{/each}}

または、headを使用して、1つの最上位アイテムのみを取得します。

{%= head(profile.purchases.recentItems).name %}

レシピ 8 – 配列項目ごとにコンテンツを条件付きでレンダリングする recipe-conditional-loop

{{#each}}内の{%#if%}を使用して、一致する項目に対してのみ出力をレンダリングします。 PQL エバリュエーターが条件で属性参照を解決できるように、as |order|を使用してループエイリアスを定義します。

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Order {{order.id}} is pending — we'll notify you when it ships.
  {%/if%}
{{/each}}

文字列と書式設定のレシピ string-recipes

レシピ 9 - replaceAllを使用して文字列をクリーニングし、再利用する recipe-replaceall-reuse

replaceAllは新しい値を返します。元の値は変更されません。 {% let %}を使用して結果を保存し、関数呼び出しを繰り返さずに複数回参照します。

{% let cleanName = replaceAll(profile.person.name.firstName, "[^a-zA-Z]", "") %}
Hi {{cleanName}},
Your exclusive code is: WELCOME-{%= upperCase(cleanName) %}

出力（例）:

Hi John,
Your exclusive code is: WELCOME-JOHN

レシピ 10 — JSON出力で値を二重引用符で囲む recipe-json-quotes

文字列内にリテラル二重引用符を含めるには（例：カスタムペイロード用のJSONの生成）、バックスラッシュ（\"）でエスケープします。

{ "greeting": "Hello \"{{profile.person.name.firstName}}\"" }

出力：{ "greeting": "Hello \"John\"" }

レシピ 11 – 日付コンポーネントを大文字で書式設定する recipe-uppercase-date

formatDateをupperCaseと組み合わせて、月または日の名前を大文字でレンダリングします。

{%= upperCase(formatDate(getCurrentZonedDateTime(), "MMMM")) %}

出力（例）: APRIL

大文字の日付文字列の場合：

{%= upperCase(formatDate(profile.person.birthDateTime, "EEEE MMMM dd yyyy")) %}

出力（例）: WEDNESDAY JANUARY 01 2020

条件付きロジックのレシピ conditional-recipes

レシピ 12 — パーソナライズされたコンテンツのIF/ELSEIF/ELSE recipe-if-elseif

マルチブランチの条件付きロジックには、{%#if%}、{%else if%}および{%else%}を使用します。 このパターンは、メールコンテンツとフラグメントで機能します。

{%#if profile.loyalty.tier = "gold"%}
As a Gold member, enjoy free shipping on all orders.
{%else if profile.loyalty.tier = "silver"%}
As a Silver member, enjoy free shipping on orders over €50.
{%else%}
Join our loyalty program to unlock exclusive benefits.
{%/if%}

レシピ 13 — ヌルセーフ属性表示 recipe-null-safe

プロファイル属性がnullまたは欠落している可能性がある場合に、空の値のレンダリングを避けるために、条件付きフォールバックを使用します。

{%#if profile.person.name.firstName%}
Hi {{profile.person.name.firstName}},
{%else%}
Hi there,
{%/if%}

または、isEmptyを使用して三項スタイルのパターンを持つインライン：

Hi {%#if isEmpty(profile.person.name.firstName)%}valued customer{%else%}{{profile.person.name.firstName}}{%/if%},

PQL edgeのケースレシピ pql-edge-cases

レシピ 14 — ハイフン付きの属性キーを参照する recipe-hyphenated-key

XDM スキーマフィールド名にハイフン（order-total、event-typeなど）が含まれる場合は、PQL式の内部でハイフンをバックティックにラップして、ハイフンが減算演算子として解釈されないようにします。

{%= profile.events.`order-total` > 100 %}

レシピ 15 — コンテキスト属性で数値イベント IDを参照する recipe-numeric-event-id

IDが数値文字列（例：1697323153）であるジャーニーコンテキストイベントを使用する場合、IDをバックティックでラップし、{% let %}をtoDateTime()とformatDate()で使用します。

{% let appointmentDate = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy HH:mm") %}
Your appointment: {{appointmentDate}}

出力（例）: Your appointment: 18/03/2026 14:30

レシピ 16 – 型強制：文字列フィールドと数値を比較する recipe-type-coercion

PQLは強く型付けされています。 プロファイルフィールドが文字列として保存されていて、数値で比較する必要がある場合は、最初にstringToNumber()で変換します。

{%= stringToNumber(profile.loyalty.pointsBalance) > 500 %}

文字列として保存されたブール型フィールドの場合：

{%= toBool(profile.consents.email.val) = true %}

クイックリファレンス quick-reference

このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。

理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。