パーソナライゼーション構文 personalization-syntax

Journey Optimizer のパーソナライゼーションは、Handlebars と呼ばれるテンプレート構文に基づいています。Handlebars 構文の詳細については、HandlebarsJS ドキュメント を参照してください。

テンプレートと入力オブジェクトを使用して、HTML やその他のテキスト形式を生成します。Handlebars テンプレートは、Handlebars 式が埋め込まれた標準のテキストのように見えます。

簡単な式のサンプル:

{{profile.person.name}}

各パラメーターの意味は次のとおりです。

  • profile は名前空間です。
  • person.name は、属性で構成されるトークンです。属性の構造は、Adobe Experience Platform XDM スキーマで定義されます。詳細情報

構文の一般的なルール general-rules

  • 識別子には、以下を除く任意の Unicode 文字を使用できます。

    code language-none
    Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~
    
  • 構文では大文字と小文字が区別されます。

  • truefalsenull および undefined ​という語は、パス式の最初の部分でのみ使用できます。

  • Handlebars では、{{expression}} から返される値は HTML エスケープ ​されています。式に「&」が含まれている場合、返される HTML エスケープ出力は「&amp;」として生成されます。Handlebars の値をエスケープしない場合は、「トリプルスタッシュ」を使用します

  • リテラル関数の引数に関して、テンプレート言語パーサーはエスケープされない単一のバックスラッシュ(\)記号をサポートしていません。この文字は、バックスラッシュ(\)記号を追加してエスケープする必要があります。例:

    {%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

使用可能な名前空間 namespaces

  • プロファイル

    この名前空間を使用すると、プロファイルスキーマで定義されているすべての属性を参照できます。このスキーマについては、Adobe Experience Platform データモデル(XDM)ドキュメントに記載されています。

    属性は、Journey Optimizer のパーソナライゼーションブロックで参照する前に、スキーマで定義しておく必要があります。

    条件でプロファイル属性を活用する方法について詳しくは、この節を参照してください。

    accordion
    参照の例
    • {{profile.person.name.fullName}}
    • {{profile.person.name.firstName}}
    • {{profile.person.gender}}
    • {{profile.personalEmail.address}}
    • {{profile.mobilePhone.number}}
    • {{profile.homeAddress.city}}
    • {{profile.faxPhone.number}}

+++

  • オーディエンス

    セグメント化サービスについて詳しくは、このドキュメントを参照してください。

  • オファー

    この名前空間では、既存のオファー決定を参照できます。

    オファーを参照するには、オファーを定義する様々な情報を使用してパスを宣言する必要があります。このパスの構造は次のようになります。

    offers.Type.[Placement Id].[Activity Id].Attribute

    ここで:

    • offers はオファー名前空間に属するパス式を識別します。
    • Type はオファー表示域のタイプを決定します。imagehtml および text などの値が使用されます。
    • Placement IdActivity Id は配置とアクティビティの識別子です。
    • Attributes は、オファータイプに依存するオファー固有の属性です。例:deliveryUrl(画像の場合)

    決定 API とオファー表示域について詳しくは、このページを参照してください。

    すべての参照は、このページで説明されている検証メカニズムを使用して、オファースキーマに対して検証されます

    accordion
    参照の例
    • 画像がホストされる場所:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl

    • 画像をクリックしたときのターゲット URL:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl

    • 決定エンジンから得られるオファーのテキストコンテンツ:

      offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

    • 決定エンジンから得られるオファーの HTML コンテンツ:

      offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

+++

ヘルパー helpers-all

Handlebars ヘルパーは、パラメーターの後に付けられる単純な識別子です。各パラメーターは、Handlebars 式です。これらのヘルパーは、テンプレート内の任意のコンテキストからアクセスできます。

これらのブロックヘルパーは、ヘルパー名の先頭にある # で識別され、対となる同じ名前の / タグで閉じる必要があります。

ブロックは、ブロック開始タグ({{# }})と終了タグ({{/}})を持つ式です。

ヘルパー関数について詳しくは、この節を参照してください。

リテラル型 literal-types

Adobe Journey Optimizer では、次のリテラル型をサポートしています。

リテラル
定義
文字列
文字で構成され、ダブルコーテーションで囲まれたデータタイプです。
例:"prospect""jobs""articles"
ブール
true か false のいずれかであるデータタイプです。
整数
整数を表すデータタイプです。正、負、ゼロのいずれかです。
例:-2010412
配列
他のリテラル値のグループとして構成されるデータ型です。複数の値を区切る場合は、角括弧で囲んでグループ化し、カンマで区切ります。
注意:配列内の項目のプロパティに直接アクセスすることはできません。
例:[1, 4, 7]["US", "FR"]
CAUTION
xEvent 変数は、パーソナライズ式では使用できません。xEvent を参照すると、検証エラーが発生します。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76