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

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

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

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

リキッドのプレビューはすぐに見ることができる：

1
{% catalog_items Games %}

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

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

例えば、『テイルズ』ゲームのタイトルと価格を参照するには、カタログ項目として『テイルズ』のid （1234）を選択し、表示される情報に対してtitle 、price 。

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

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

テイルズ』をわずか7.49ドルで手に入れよう！

その他の使用例

複数の項目

1つのメッセージに含まれる項目は1つに限定されない！パーソナライズの追加]モーダルを使用して、表示する追加カタログ項目と情報を挿入するだけである。なお、追加できるカタログ項目は3つまでである。

この例をチェックしてください。3つのゲーム、Tales、Teslagrad、Acaratusのidをカタログアイテムに追加し、表示する情報のためにtitleを選択します。

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

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

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

究極のトリオ「テイルズ」、「テスラグラッド」、「アカラタス」を今すぐ手に入れよう！

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

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

そのためには、リキッド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 がカタログ・リストである。

ユースケース:リキッド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 オブジェクトを使う。

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

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

![コンテンツカードコンポーザーで、画像フィールドにカタログのリキッドタグが使用されている。][3]

リキッドがレンダリングされるとこうなる：

![カタログのリキッドタグをレンダリングしたコンテンツカードの例。][4]{: style=”max-width:50%” }

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

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

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

リキッドテンプレートを使えば、ウィッシュリストのIDを動的に引き出し、メッセージの中で使うことができる。そのためには、[変数][10] をカスタム属性に割り当て、パーソナライゼーションの追加モーダルを使用して、配列から特定のアイテムを取り出す。

例えば、「テイルズ」（カタログに掲載されている、ユーザーが欲しいと思っている商品）がセール中であることをユーザーに知らせるには、メッセージ・コンポーザーに次のように追加すればいい：

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

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

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

たった7.49ドルで、今すぐ『テイルズ』を手に入れよう！

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

CSVをアップロードする

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

液体の使用

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