パーソナライゼーション構文 personalization-syntax
Journey Optimizer のパーソナライゼーションは、Handlebars と呼ばれるテンプレート構文に基づいています。Handlebars 構文の詳細については、HandlebarsJS ドキュメント を参照してください。
テンプレートと入力オブジェクトを使用して、HTML やその他のテキスト形式を生成します。Handlebars テンプレートは、Handlebars 式が埋め込まれた標準のテキストのように見えます。
簡単な式のサンプル:
{{profile.person.name}}
各パラメーターの意味は次のとおりです。
profile
は名前空間です。person.name
は、属性で構成されるトークンです。属性の構造は、Adobe Experience Platform XDM スキーマで定義されます。詳細情報。
構文の一般的なルール general-rules
識別子には、以下を除く任意の Unicode 文字を使用できます。
Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~
構文では大文字と小文字が区別されます。
true、false、null および undefined という語は、パス式の最初の部分でのみ使用できます。
Handlebars では、{{expression}} から返される値は HTML エスケープ されています。式に「&
」が含まれている場合、返される HTML エスケープ出力は「&
」として生成されます。Handlebars の値をエスケープしない場合は、「トリプルスタッシュ」を使用します
リテラル関数の引数に関して、テンプレート言語パーサーはエスケープされない単一のバックスラッシュ(\
)記号をサポートしていません。この文字は、バックスラッシュ(\
)記号を追加してエスケープする必要があります。例:
{%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}
プロファイル
この名前空間を使用すると、プロファイルスキーマで定義されているすべての属性を参照できます。このスキーマについては、Adobe Experience Platform データモデル(XDM)ドキュメントに記載されています。
属性は、Journey Optimizer のパーソナライゼーションブロックで参照する前に、スキーマで定義しておく必要があります。
参照の例:
{{profile.person.name.fullName}}
{{profile.person.name.firstName}}
{{profile.person.gender}}
{{profile.personalEmail.address}}
{{profile.mobilePhone.number}}
{{profile.homeAddress.city}}
{{profile.faxPhone.number}}
オーディエンス perso-segments
条件でプロファイル属性を活用する方法については、この節を参照してください。
オファー offers-syntax
この名前空間では、既存のオファー決定を参照できます。
オファーを参照するには、オファーを定義する様々な情報を使用してパスを宣言する必要があります。
このパスの構造は次のようになります。
offers.Type.[Placement Id].[Activity Id].Attribute
ここで:
offers
はオファー名前空間に属するパス式を識別します。Type
はオファー表示域のタイプを決定します。image
、html
およびtext
などの値が使用されます。Placement Id
とActivity Id
は配置とアクティビティの識別子です。Attributes
は、オファータイプに依存するオファー固有の属性です。例:deliveryUrl
(画像の場合)
決定 API とオファー表示域について詳しくは、このページを参照してください。
すべての参照は、このページで説明されている検証メカニズムを使用して、オファースキーマに対して検証されます。
サンプルリファレンス:
-
画像がホストされる場所:
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 式です。これらのヘルパーは、テンプレート内の任意のコンテキストからアクセスできます。
これらのブロックヘルパーは、ヘルパー名の先頭にある#で識別され、対となる同じ名前の「/」タグで閉じる必要があります。
ブロックは、ブロック開始タグ({{# }}) and closing ({{/}})を持つ式です。
リテラル型 literal-types
Adobe Journey Optimizer では、次のリテラル型をサポートしています。
例:
"prospect"
、"jobs"
、"articles"
例:
-201
、0
、412
注意:配列内の項目のプロパティに直接アクセスすることはできません。
例:
[1, 4, 7]
、["US", "FR"]
URL のパーソナライゼーション perso-urls
パーソナライズされた URL は、プロファイル属性に応じて、受信者を web サイトの特定のページに誘導するか、パーソナライズされたマイクロサイトに誘導します。Adobe Journey Optimizer では、メッセージコンテンツの URL にパーソナライゼーションを追加できます。URL のパーソナライゼーションはテキストや画像に適用でき、その際にプロファイルデータやコンテキストデータを使用できます。
Journey Optimizer では、パーソナライゼーションフィールドを追加して、メッセージに含まれる 1 つまたは複数の URL をパーソナライズできます。URL をパーソナライズするには、次の手順に従います。
-
メッセージコンテンツにリンクを作成します。詳細情報
-
パーソナライゼーションアイコンから、属性を選択します。パーソナライゼーションアイコンは、外部リンク、購読解除リンク および オプトアウト のリンクでのみ使用できます。
パーソナライズされた URL のサンプル
https://www.adobe.com/users/{{profile.person.name.lastName}}
https://www.adobe.com/users?uid={{profile.person.name.firstName}}
https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}