デフォルト値を設定する

既定のフォールバックは、メッセージで使用する任意のパーソナライゼーション 属性に設定できます。この記事では、デフォルト値の仕組み、設定方法、メッセージングでの使用方法について説明する。

仕組み

デフォルト値を追加するには、Liquid フィルターを「デフォルト」という名前で指定します (インラインでフィルターを区別するには | を使用します)。

1
| default: 'Insert Your Desired Default Here'

デフォルト値が提供されておらず、フィールドが存在しないか、ユーザーに設定されていない場合、メッセージの中でフィールドは空白になる。

次の例は、デフォルトを追加するための正しい構文を示しています。この場合、ユーザーのfirst_name フィールドが空の場合や利用できない場合は、「Valued User」という文字が属性{{ ${first_name} }} に置き換わる。

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

Janet Doe という名前のユーザーには、次のいずれかの方法でメッセージが表示されます。

1
Hi Janet, thanks for using the App!

または。。。

1
Hi Valued User, thanks for using the App!

異なるデータ型にデフォルト値を設定する

上の例は、文字列にデフォルトを設定する方法を示している。値が empty 、nil (未定義)、または false の任意の Liquid データ型 (文字列、ブール値、配列、オブジェクト、数値を含む) のデフォルト値を設定できます。

ユースケース:ブール値

例えば、premium_user というブーリアンカスタム属性があり、ユーザーのプレミアムステータスに基づいてパーソナライズされたメッセージを送信したいとしよう。プレミアムステータスを設定していないユーザーもいるので、そのようなユーザーを捕捉するためにデフォルト値を設定する必要がある。

1. premium_user 属性にis_premium_user という変数を割り当て、デフォルト値を false とします。つまり、premium_user がnil の場合、is_premium_user のデフォルト値は false になります。

1
{% assign is_premium_user = {{custom_attribute.${premium_user}}} | default: false %}

2.次に、条件付きロジックを使用して、is_premium_user が true の場合に送信するメッセージを指定します。言い換えれば、premium_user がtrue の場合、何を送ればいいのか、ということだ。また、ユーザーの名が不明な場合に備えて、ユーザーの名にもデフォルト値を割り当てます。

1
2
{% if is_premium_user %}
Hi {{${first_name} | default: 'premium user'}}, thank you for being a premium user!

3.最後に、is_premium_user がfalse の場合（つまり premium_user がfalse またはnil の場合）に送信するメッセージを指定します。その後、条件ロジックを閉じます。

1
2
3
{% else %}
Hi {{${first_name} | default: 'valued user'}}, consider upgrading to premium for more benefits!
{% endif %}

1
2
3
4
5
6
{% assign is_premium_user = {{custom_attribute.${premium_user}}} | default: false %}
{% if is_premium_user %}
Hi {{${first_name} | default: 'premium user'}}, thank you for being a premium user!
{% else %}
Hi {{${first_name} | default: 'valued user'}}, consider upgrading to premium for more benefits!
{% endif %}

ユースケース:数値

例えば、reward_points という数値のカスタム属性があり、ユーザーの報酬ポイントをメッセージとして送信したいとしよう。報酬ポイントが設定されていないユーザーもいるので、そのようなユーザーを考慮してデフォルト値を設定する必要がある。

1. メッセージの開始時に、ユーザーの名を指定します。ユーザーの名が不明な場合はデフォルト値 Valued User を使用します。

1
Hi {{${first_name} | default: 'valued user'}},

2.カスタム属性 reward_points とデフォルト値 0 を使用して、ユーザーのリワードポイント数をメッセージの最後に記載します。reward_points の値が nil であるすべてのユーザーには、リワードポイントとして 0 がメッセージに記載されます。

1
Hi {{${first_name} | default: 'valued user'}}, you have {{custom_attribute.${reward_points} | default: 0}} reward points.

ユースケース:オブジェクト

例えば、city とstate のプロパティを含む、location という階層化カスタム属性オブジェクトがあるとしよう。これらのプロパティが設定されていない場合は、ユーザーが設定するように促したい。

1. ユーザーを名で呼び、名前がわからない場合に備えてデフォルト値を含める。

1
Hi {{${first_name} | default: 'valued user'}},

2.ユーザーの位置情報を確認したいというメッセージを書く。

1
We'd like to confirm the location associated with your account. We use this location to send you promotions and offers for stores nearest you. You can update your location in your profile settings.

3.ユーザーの所在地をメッセージに挿入し、addressプロパティが設定されていない場合のデフォルト値を割り当てる。

1
2
3
Your location:
City: {{custom_attribute.${address.city} | default: 'Unknown'}}
State: {{custom_attribute.${address.state} | default: 'Unknown'}}

1
2
3
4
5
6
7
Hi {{${first_name} | default: 'valued user'}}

We'd like to confirm the location associated with your account. We use this location to send you promotions and offers for stores nearest you. You can update your location in your profile settings.

Your location:
City: {{custom_attribute.${address.city} | default: 'Unknown'}}
State: {{custom_attribute.${address.state} | default: 'Unknown'}}

ユースケース:配列

例えば、destination とdeparture_date というプロパティを持つトリップを含む、upcoming_trips という配列カスタム属性があるとしよう。スケジュールされた旅行の有無に基づき、パーソナライズされたメッセージをユーザー群に送りたい。

1. upcoming_trips がempty の場合、メッセージを送信しないことを指定する条件付きロジックを書く。

1
2
{% if {{custom_attribute.${upcoming_trips}}} == empty %}
{% abort_message('No upcoming trips scheduled') %}

2.upcoming_trips にコンテンツがある場合に送信するメッセージを指定する：

2a.ユーザーを指定し、ユーザーの名前が不明な場合に備えてデフォルト値を含めます。
2b.for タグを使用して、upcoming_trips に含まれる各トリップのプロパティ (または情報) を取得することを指定します。
2c.メッセージにプロパティを列挙し、departure_date が設定されていない場合のデフォルト値を含める。(トリップの作成にはdestination が必要なので、デフォルト値を設定する必要はないとしよう)。
2d.for タグを閉じ、次に条件ロジックを閉じます。

1
2
3
4
5
6
7
8
9
10
11
12
{% else %}
Hello {{${first_name} | default: 'fellow traveler'}},
  Here are your upcoming trips:
  <ul>
  {% for trip in {{custom_attribute.${upcoming_trips}}} %}
    <li>
      Destination: {{trip.destination}}
      Departure Date: {{trip.departure_date | default: 'Date not set'}}
    </li>
  {% endfor %}
  </ul>
{% endif %}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% if {{custom_attribute.${upcoming_trips}}} == blank %}
{% abort_message('No upcoming trips scheduled') %}
{% else %}
Hello {{${first_name} | default: 'fellow traveler'}},
  Here are your upcoming trips:
  <ul>
  {% for trip in {{custom_attribute.${upcoming_trips}}} %}
    <li>
      Destination: {{trip.destination}}
      Departure Date: {{trip.departure_date | default: 'Date not set'}}
    </li>
  {% endfor %}
  </ul>
{% endif %}