メッセージでカタログを使う

カタログを作成した後、Liquid を使用して、Braze キャンペーンの非ユーザーデータを参照できます。Liquidがサポートされているドラッグ・アンド・ドロップ・エディター内の任意の場所を含む、すべてのメッセージング・チャンネルでカタログを使用できる。

ステップ 1: パーソナライゼーションタイプを追加する

選択したメッセージコンポーザーで、 プラスアイコンを選択してパーソナライズの追加モーダルを開き、パーソナライズのタイプに カタログアイテムを選択する。次に、カタログ名を選択します。先ほどの例を使って、「ゲーム」カタログを選択する。

以下の Liquid プレビューがすぐに表示されます。

1
{% catalog_items Games %}

ステップ 2: カタログ項目を選択する

ここではカタログアイテムを追加します。ドロップダウンを使って、カタログ項目と表示する情報を選択する。この情報は、カタログを生成するために使用される、アップロードされたCSVファイルの列に対応している。

例えば、Tales ゲームのタイトルと価格を参照するには、カタログアイテムとして Tales (1234) の id を選択し、表示される情報に対して title と price をリクエストします。

1
2
3
{% catalog_items Games 1234 %}
 
Get {{ items[0].title }} for just {{ items[0].price }}!

これは次のように表示される：

「Tales」をわずか 7.49 ドルでゲットしよう!

その他の使用例

複数の項目

1つのメッセージ内の1つの項目だけに限定されるわけではありません。Add Personalizationモーダルを使用して、一度に最大3つのカタログアイテムを追加できます。メッセージにアイテムを追加するには、メッセージコンポーザーでカスタマイズを追加を選択し、表示する追加のカタログアイテムと情報を選択します。

この例では、Tales、Teslagrad、Acaratus の 3 つのゲームの id をカタログアイテムに追加し、[表示する情報] のために title を選択します。

Liquid の周りにテキストを追加することで、メッセージをさらにパーソナライズできます。

1
2
Get the ultimate trio {% catalog_items games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

これは以下のように返される：

究極のトリオ「Tales」、「Teslagrad」、「Acaratus」を今すぐゲット!

リキッドif ステートメントを使用する

カタログ項目を使って条件文を作ることができる。例えば、キャンペーンで特定の項目が選択されたときに、特定メッセージの表示をトリガーできます。

これを行うには、次のような形式で Liquid の if ステートメントを使用します。

1
2
3
4
5
6
{% catalog_items Test-list %}
{% if {{items[0].first-item}} == true %}
Do this
{% else %}
Do that
{% endif %}

if ステートメントを使用する前に、カタログリストを宣言する必要があることに注意してください。上の例では、Test-list がカタログ・リストである。

ユースケース:Liquid の if スニペット

このシナリオでは、カスタム属性venue_name の文字数が10文字以上か10文字未満かで、異なるメッセージが表示される。venue_name が blank の場合、何も表示されません。

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %} 
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters. 
{% elsif items[0].venue_name.size < 10 %}
Message if the venue name's size is less than 10 characters. 
{% else %} 
{% abort_message(no venue_name) %} 
{% endif %}

画像の使用

また、カタログ内の画像を参照してメッセージングで使用することもできます。そのためには、画像のリキッドフィールドでcatalogs タグとitem オブジェクトを使う。

例えば、Games カタログの image_link を「Tales」のプロモーションメッセージに追加するには、[カタログ項目] フィールドで id を選択し、[表示する情報] フィールドで image_link を選択します。これにより、以下のリキッドタグが画像フィールドに追加される：

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

Liquid がレンダリングされると、次のように表示されます。

カタログ項目をテンプレート化する

また、テンプレート化を使って、カスタム属性に基づいてカタログ項目を動的に引き出すこともできる。例えば、あるユーザーがカスタム属性wishlist （カタログのゲームIDの配列）を持っているとする。

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Liquid テンプレートを使用することで、ウィッシュリストから ID をダイナミックに取り出し、メッセージで使用できます。そのためには、変数 をカスタム属性に割り当て、パーソナライゼーションの追加モーダルを使用して、配列から特定のアイテムを取り出す。

例えば、「Tales」(ウィッシュリストに含まれている、御社カタログの項目) が販売中であることをユーザーに通知するために、メッセージ作成画面で以下を追加できます。

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now, for just {{ items[0].price }}!

以下のように表示される：

「Tales」をわずか 7.49 ドルで今すぐゲットしよう!

テンプレート化により、各ユーザーのカスタム属性、イベントプロパティ、その他のテンプレート化可能なフィールドに基づいて、各ユーザーに異なるカタログ項目をレンダリングすることができる。

CSVをアップロードする

追加する新しいカタログ項目や、更新するカタログ項目の CSV をアップロードできます。アイテムのリストを削除するには、アイテムIDのCSVをアップロードして削除する。

Liquid の使用

Liquid ロジックを手動で作成することもできます。ただし、存在しないIDを入力しても、Brazeはオブジェクトのないitems配列を返すことに注意。配列のサイズをチェックしたり、if ステートメントを使用して配列が空の場合を考慮するなど、エラー処理を含めることを推奨する。

リキッドを含むカタログアイテムのテンプレート化

コネクテッドコンテンツと同様に、Liquid タグで :rerender フラグを使用してカタログアイテムの Liquid コンテンツをレンダリングする必要があります。:rerender フラグはレベル1の深さしかないことに注意してください。つまり、階層化 Liquid タグ 呼び出しには適用されません。

カタログアイテムにユーザープロファイルフィールド (Liquid パーソナライゼーションタグ内) が含まれている場合は、Liquid を適切にレンダリングするために、テンプレート作成の前にメッセージでこれらの値を Liquid で事前に定義する必要があります。:rerender フラグが指定されていない場合、生の Liquid コンテンツがレンダリングされます。

たとえば、「Messages」という名前のカタログに、この Liquid を含むアイテムがあるとします。

以下のリキッドコンテンツをレンダリングするには:

1
2
3
4
Hi ${first_name}

{% catalog_items Messages greet_msg :rerender %}
{{ items[0].Welcome_Message }}

次のように表示されます。

1
2
3
Hi Peter,

Welcome to our store, Peter!