対応パーソナライズタグ

この参考記事では、サポートされているリキッドパーソナライゼーションタグの完全なリストをカバーしています。

便宜上、サポートされているパーソナライゼーション・タグの概要を示す。各タグの詳細とベストプラクティスについては、続きをお読みください。

Brazeのソース間でこれらの属性がどのように異なるかについては、このヘルプ記事を参照してください。

キャンバスとキャンペーンタグの違い

以下のタグはキャンバスとキャンペーンで動作が異なります：

-dispatch_id キャンバスとキャンペーンで異なるのは、Brazeはキャンバスのステップを、たとえ「スケジュール」されていても、トリガーされたイベントとして扱うからです（スケジュール可能なエントリーステップを除く）。詳しくは【派遣IDの動作】50を参照。 - Canvasで{{campaign.${name}}} タグを使用すると、Canvasコンポーネント名が表示されます。キャンペーンでこのタグを使用すると、キャンペーン名が表示されます。

最近使用したデバイス情報

すべてのプラットフォームで、ユーザーの最新のデバイスについて以下の属性をテンプレート化できます。ユーザがアプリケーションを使用していない場合 (たとえば、REST API 経由でユーザをインポートした場合)、これらの値はすべてnull になります。

デバイスのキャリア、モデル名、オペレーティングシステムは多岐にわたるため、これらの値のいずれかに条件依存するリキッドを徹底的にテストすることをお勧めします。これらの値は、特定のデバイスで利用できない場合、null 。

ターゲティングされたアプリ情報

アプリ内メッセージでは、Liquid内で以下のアプリ属性を使用できます。値は、アプリがメッセージングを要求するために使用するSDK APIキーに基づいています。

例えば、このリキッドコードは、リクエストアプリがリストにある2つのAPIキーのうちの1つでない場合、メッセージを中止します：

1
2
3
4
5
6
{% assign allowed_api_keys = 'sdk_api_key_1,sdk_api_key_2' | split: ',' %}
{% if allowed_api_keys contains {{app.${api_id}}} %}
User is in list of apps
{% else %}
{% abort_message("User not in list of apps") %}
{% endif %}

ターゲット・デバイス情報

プッシュ通知およびアプリ内メッセージ・チャネルでは、メッセージ送信先のデバイスについて、以下の属性をテンプレート化できます。つまり、プッシュ通知やアプリ内メッセージには、メッセージを読む端末の端末属性を含めることができる。これらの属性はコンテンツ・カードでは機能しないことに注意してください。

デバイスのキャリア、モデル名、オペレーティングシステムは多岐にわたるため、これらの値に条件依存するロジックは徹底的にテストすることをお勧めします。これらの値は、特定のデバイスで利用できない場合、null 。さらに、プッシュ通知の場合、プッシュトークンがAPI経由でインポートされた場合など、特定の状況下でBrazeがプッシュ通知に接続されたデバイスを識別できない可能性があり、その結果、これらのメッセージの値がnull 。

プッシュ・メッセージでファースト・ネーム変数を使うとき、デフォルト値として “there “を使う例]4。

状況によっては、デフォルト値を設定する代わりに条件付きロジックを使用することもできます。条件付きロジックでは、カスタム属性の値によって異なるメッセージを送信することができます。

さらに、条件付きロジックを使用して、NULLまたは空白の属性値を持つ顧客へのメッセージを中止することができます。

例えば、顧客に特典残高通知を送信する場合、デフォルト値を使用して残高の少ない顧客や残高のない顧客を考慮する良い方法はありません。

この場合、デフォルト値を設定するよりも有効なオプションが2つある：

1. 残高が少ない、ゼロ、空白の顧客に対するメッセージを中止する。

   1
   2
   3
   4
   5
   {% if {{custom_attribute.${balance}}} > 0 %}
   Your rewards balance is {{custom_attribute.${balance}}}
   {% else %}
   {% abort_message() %}
   {% endif %}
   

2. このような顧客には、まったく別のメッセージを送ろう：

   1
   2
   3
   4
   5
   {% if ${first_name} != blank and ${first_name} != null %}
   Hello {{${first_name} | default: 'there'}}, thanks for downloading!
   {% else %}
   Thanks for downloading!
   {% endif %}
   

この例では、姓が空白またはNULLのユーザーは、”Thanks for downloading “というメッセージを受け取る。名字にはデフォルト値を入れて、万が一間違えても顧客にリキッドが表示されないようにしてください。

可変タグ

assign タグを使って、メッセージ・コンポーザーに変数を作成することができます。変数を作成したら、メッセージング・ロジックやメッセージの中でその変数を参照することができます。

例えば、顧客がリワードポイントを100ポイント獲得したら、賞品と交換できるようにしたとしよう。そのため、追加で購入した場合、ポイント残高が100以上になる顧客だけにメッセージを送りたい：

1
2
3
4
5
6
{% assign new_points_balance = {{custom_attribute.${current_rewards_balance} | plus: 50}} %}
{% if new_points_balance >= 100 %}
Make a purchase to bring your rewards points to {{new_points_balance}} and cash in today!
{% else %}
{% abort_message('not enough points') %}
{% endif %}

このタグは、コネクテッド・コンテンツ機能から返されたコンテンツを再フォーマットしたい場合に便利です。詳しくはShopifyの変数タグに関するドキュメントをご覧ください。

反復タグ

反復タグは、コードのブロックを繰り返し実行するために使うことができる。この例では、for 。

例えば、ナイキのスニーカーのセールを開催し、ナイキに興味を示した顧客にメッセージを送るとしよう。各顧客のプロフィールには、さまざまな商品ブランドが表示されています。この配列には最大25の製品ブランドを含めることができますが、直近の5つの製品ビューの1つとしてナイキ製品を見た顧客だけにメッセージを送りたいのです。

1
2
3
4
5
6
7
8
9
10
{% for items in {{custom_attribute.${Brands Viewed}}} limit:5 %}
{% if {{items}} contains 'Converse' %}
{% assign converse_viewer = true %}
{% endif %}
{% endfor %}
{% if converse_viewer == true %}
Sale on Converse!
{% else %}
{% abort_message() %}
{% endif %}

この例では、閲覧されたスニーカーブランド配列の最初の5項目をチェックします。その中にconverseという項目があれば、converse_viewerという変数を作り、trueをセットする。

そして、converse_viewerがtrueの時にセールメッセージを送る。そうでなければ、メッセージを中止する。

これは、Brazeメッセージコンポーザーでの反復タグの使い方の簡単な例です。Shopifyのイテレーションタグに関するドキュメントに詳しい情報があります。

構文タグ

構文タグは、リキッドがどのようにレンダリングされるかを制御するために使用することができます。echo タグを使って式を返すことができる。これは、中括弧を使って式をラップするのと同じですが、リキッドタグの中でこのタグを使うことができます。また、liquid タグを使用すると、各タグに区切り文字のないリキッドのブロックを持つことができます。liquid タグを使用する場合は、各タグを独立した行にする必要がある。より詳細な情報と例については、Shopifyの構文タグに関するドキュメントをチェックしてください。

空白コントロール]49を使うと、タグの周りの空白を取り除くことができます。

HTTPステータスコード

まずローカル変数として保存し、__http_status_code__ キーを使用することで、Connected Content呼び出しからの HTTP ステータスを利用することができます。例えば、こうだ：

1
2
3
4
{% connected_content https://example.com/api/endpoint :save connected %}
{% if connected.__http_status_code__ != 200 %}
{% abort_message('Connected Content returned a non-200 status code') %}
{% endif %}

言語、最新のロケール、タイムゾーンに基づいたメッセージ送信

状況によっては、特定のロケールに特化したメッセージを送りたい場合もあるでしょう。例えば、ブラジルのポルトガル語は、一般的にヨーロッパのポルトガル語とは異なる。

ここでは、国際化されたメッセージをさらにローカライズするために、最新のロケールを使用する方法の例を示します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{% if ${language} == 'en' %}
Message in English
{% elsif  ${language} == 'fr' %}
Message in French
{% elsif  ${language} == 'ja' %}
Message in Japanese
{% elsif  ${language} == 'ko' %}
Message in Korean
{% elsif  ${language} == 'ru' %}
Message in Russian
{% elsif ${most_recent_locale} == 'pt_BR' %}
Message in Brazilian Portuguese
{% elsif ${most_recent_locale} == 'pt_PT' %}
Message in European Portuguese
{% elsif  ${language} == 'pt' %}
Message in default Portuguese
{% else %}
Message in default language
{% endif %}

この例では、最新のロケールが「pt_BR」の顧客にはブラジルのポルトガル語のメッセージが届き、最新のロケールが「pt_PT」の顧客にはヨーロッパのポルトガル語のメッセージが届きます。最初の2つの条件を満たさないが、言語がポルトガル語に設定されている顧客には、デフォルトのポルトガル語の言語タイプでメッセージが表示されます。

また、タイムゾーンでユーザーをターゲットにすることもできます。例えば、相手が東部標準時をベースにしている場合は1通のメッセージを送り、東部標準時をベースにしている場合は別のメッセージを送る。これを行うには、現在時刻をUTCで保存し、if/else文でユーザーの現在時刻と比較し、正しいタイムゾーンに正しいメッセージを送信していることを確認します。ユーザーが適切な時間にキャンペーンを受け取れるように、ユーザーのローカルタイムゾーンで送信するようにキャンペーンを設定する必要があります。午後2時から午後3時の間に発信されるメッセージで、各タイムゾーンに特化したメッセージを書く方法については、次の例を参照してください。

1
2
3
4
5
6
7
8
{% assign hour_in_utc = 'now' | date: '%H' | plus:0 %}
{% if hour_in_utc >= 19 && hour_in_utc < 20 %}
It is between 2:00:00 pm and 2:59:59 pm ET!
{% elsif hour_in_utc >= 22 && hour_in_utc < 23 %}
It is between 2:00:00 pm and 2:59:59 pm PT!
{% else %}
{% abort_message %}
{% endif %}