パーソナライゼーション構文 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 ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~ -
構文では大文字と小文字が区別されます。
-
true、false、null および undefinedという語は、パス式の最初の部分でのみ使用できます。
-
Handlebars では、{{expression}} から返される値は HTML エスケープされています。式に「
&」が含まれている場合、返される HTML エスケープ出力は「&」として生成されます。Handlebars の値をエスケープしない場合は、「トリプルスタッシュ」を使用します。フィールド
profile.person.nameの値が「Mark & Mary」であるとします。 構文{{profile.person.name}}にはMark & Maryが表示され、{{{profile.person.name}}}にはMark & Maryが表示されます。 -
リテラル関数の引数に関して、テンプレート言語パーサーはエスケープされない単一のバックスラッシュ(
\)記号をサポートしていません。この文字は、バックスラッシュ(\)記号を追加してエスケープする必要があります。例:{%= 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はオファー表示域のタイプを決定します。image、htmlおよびtextなどの値が使用されます。Placement IdとActivity 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"例:
-201、0、412注意:配列内の項目のプロパティに直接アクセスすることはできません。
例:
[1, 4, 7]、["US", "FR"]