対応パーソナライズタグ

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

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

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 。

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

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

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

この場合、デフォルト値を設定するよりも効果的なオプションが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 “というメッセージを受け取る。名字には[デフォルト値]47 ]を入れて、万が一間違えても顧客にリキッドが表示されないようにすべきである。

可変タグ

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 %}

このタグは、[Connected Content]4 ]機能から返されたコンテンツを再フォーマットしたいときに便利だ。詳しくは、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項目をチェックする。それらの項目の1つがconverseであれば、converse_viewer変数を作り、それをtrueに設定する。

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

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

構文タグ

シンタックスタグは、リキッドがどのようにレンダリングされるかをコントロールするために使うことができる。echo 、式を返すことができる。これは、中括弧を使って式をラップするのと同じだが、リキッドタグの中でこのタグを使うことができる。また、liquid タグを使えば、各タグに区切りのないリキッドのブロックを持つことができる。liquid 、それぞれのタグは1行にまとめなければならない。より詳細な情報と例については、Shopifyの構文タグに関するドキュメントをチェックしよう。

[空白コントロール]49] を使用すると、タグの周りの空白を削除でき、リキッド出力の外観をさらにコントロールするのに役立ちます。

HTTPステータスコード

コネクテッドコンテンツ コールからのHTTPステータスをローカル変数として保存し、次に__http_status_code__キーを使用することで利用できます。以下に例を示します。

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 %}