ヘルパー gs-helpers

デフォルトのフォールバック値 default-value

Default Fallback Value ヘルパーは、属性が空または null の場合にデフォルトのフォールバック値を返すために使用されます。このメカニズムは、プロファイル属性とジャーニーイベントで機能します。

構文

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

この例では、このプロファイルの firstName 属性が空または null の場合、there という値が表示されます。

条件 if-function

if ヘルパーを使用して、条件ブロックを定義します。
式の評価結果が true の場合、ブロックはレンダリングされます。true でない場合はスキップされます。

構文

{%#if contains(profile.personalEmail.address, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

if ヘルパーの後に、else ステートメントを入れて、その条件の結果が false の場合に実行するコードのブロックを指定することもできます。
elseif ステートメントは、最初のステートメントが false を返した場合にテストする新しい条件を指定します。

形式

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

例

Unless unless

unless ヘルパーを使用して、条件ブロックを定義します。if ヘルパーとは異なり、式評価が false を返した場合、ブロックがレンダリングされます。

構文

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

例

メールアドレスの拡張子に基づいてコンテンツをレンダリングする。

{%#unless endsWith(profile.personalEmail.address, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content Content
{%/unless%}

Each each

each ヘルパーを使用して、配列に対して反復処理を行います。
ヘルパーの構文は {{#each ArrayName}} YourContent {{/each}} です。
個々の配列項目は、ブロック内でキーワード this を使用して参照できます。配列の要素のインデックスは、{{@index}} を使用してレンダリングできます。

構文

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

例

{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

例

ユーザーが買い物かごに入れた商品のリストをレンダリングする。

{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

With with

with ヘルパーを使用して、template-part の評価トークンを変更します。

構文

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

with ヘルパーは、ショートカット変数を定義する場合にも使用できます。

例

with は、長い変数名に短い別名を付ける場合にも使用できます。

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

Let let

let 関数を使用すると、式を変数として保存し、後からクエリで使用できます。

構文

{% let variable = expression %} {{variable}}

例

次の例では、買い物かご内の価格が 100～1000 の製品の合計価格を計算できます。

{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}

実行メタデータ execution-metadata

executionMetadata ヘルパーを使用すると、カスタムのキーと値のペアを動的にキャプチャし、メッセージ実行コンテキストに保存できます。

構文

{{executionMetadata key="your_key" value="your_value"}}

この構文では、key はメタデータ名を指し、value は保持するメタデータです。

ユースケース

この機能を使用すると、キャンペーンやジャーニーの任意のネイティブアクションにコンテキスト情報を追加できます。 これにより、トラッキング、分析、パーソナライゼーション、ダウンストリーム処理など、様々な目的で、リアルタイム配信のコンテキストデータを外部システムに書き出すことができます。

例えば、実行メタデータヘルパーを使用して、各プロファイルに送信される各配信に特定の ID を追加できます。 この情報は実行時に生成され、エンリッチメントされた実行メタデータを書き出して、外部レポートプラットフォームとのダウンストリーム調整を行うことができます。

仕組み

キャンペーンまたはジャーニー内のチャネルコンテンツから任意の要素を選択し、パーソナライゼーションエディターを使用して、executionMetadata ヘルパーをこの要素に追加します。

実行時に、次のスキーマの追加を伴って、メタデータ値が既存の メッセージフィードバックイベントデータセット に追加されます。

"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}

制限事項

アクションごとのキーと値のペアの上限は 2 kb です。

2 Kb の制限を超えた場合、メッセージは配信されますが、キーと値のペアは切り捨てられる場合があります。

例

{{executionMetadata key="firstName" value=profile.person.name.firstName}}

この例では、profile.person.name.firstName = "Alex"とすると、結果のエンティティは次のようになります。

{
  "key": "firstName",
  "value": "Alex"
}