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

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

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

簡単な式のサンプル:

{{profile.person.name}}

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

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

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

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

Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

構文では大文字と小文字が区別されます。

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

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

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

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

プロファイル

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

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

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

参照の例:

{{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

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

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

オファー offers-syntax

この名前空間では、既存のオファー決定を参照できます。
オファーを参照するには、オファーを定義する様々な情報を使用してパスを宣言する必要があります。

このパスの構造は次のようになります。

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

ここで:

  • offers はオファー名前空間に属するパス式を識別します。
  • Type はオファー表示域のタイプを決定します。imagehtml および text などの値が使用されます。
  • Placement IdActivity 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 ({{/}})を持つ式です。

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

リテラル型 literal-types

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

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

URL のパーソナライゼーション perso-urls

パーソナライズされた URL は、プロファイル属性に応じて、受信者を web サイトの特定のページに誘導するか、パーソナライズされたマイクロサイトに誘導します。Adobe Journey Optimizer では、メッセージコンテンツの URL にパーソナライゼーションを追加できます。URL のパーソナライゼーションはテキストや画像に適用でき、その際にプロファイルデータやコンテキストデータを使用できます。

Journey Optimizer では、パーソナライゼーションフィールドを追加して、メッセージに含まれる 1 つまたは複数の URL をパーソナライズできます。URL をパーソナライズするには、次の手順に従います。

  1. メッセージコンテンツにリンクを作成します。詳細情報

  2. パーソナライゼーションアイコンから、属性を選択します。パーソナライゼーションアイコンは、外部リンク購読解除リンク ​および​ オプトアウト ​のリンクでのみ使用できます。

NOTE
パーソナライゼーションエディターでは、パーソナライズされた 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}}
CAUTION
スペースは、URL 内で使用されるパーソナライゼーショントークンではサポートされていません。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76