カタログの作成

カタログを使用すると、Liquidを通じてBrazeキャンペーンの非ユーザーデータを参照できます。

カタログを作成するには、非ユーザーデータの CSV ファイルを Braze にインポートする必要があります。これにより、その情報にアクセスしてメッセージを充実させることができます。カタログにはあらゆる種類のデータを取り込むことができます。このデータは通常、eコマースビジネスの商品情報や教育機関向けのコース情報など、会社の何らかのメタデータです。

カタログの一般的な使用例には、次のようなものがあります。

• 製品
• サービス
• 食べ物
• 近日開催予定のイベント
• ミュージック
• パッケージ

この情報をインポートすると、Liquidからカスタム属性やカスタムイベントプロパティにアクセスするのと同じ方法で、メッセージからアクセスできるようになります。

CSV ファイルの準備

カタログを作成する前に、希望するカタログ作成方法がアップロードである場合は、必ずCSVファイルを用意してください。

CSV ファイルを作成するときは、次のガイドラインに注意してください。CSV ファイルの最初の列はのヘッダーである必要がありid、id各項目は一意である必要があります。その他の列名はすべて一意でなければなりません。さらに、カタログ CSV ファイルには次の制限が適用されます。

• 最大 500 フィールド (列)
• フィールド (列) 名の最大文字数は 250 文字
• 社内のすべての CSV ファイルを組み合わせて最大 100 MB (無料)
• CSV ファイルの最大サイズは 2 GB (プロ)
• 5,000 文字の最大フィールド値 (セル)
• およびヘッダー値には、文字、数字、ハイフン、idアンダースコアのみ

次のステップでCSVファイルを正常にアップロードするには、CSVファイルをUTF-8形式でエンコードしていることを確認してください。また、CSV ファイル内のすべてのテキストを小文字にすることをお勧めします。

メソッドを選択する

カタログを作成するには、[データ設定] > [カタログ] に移動します。

「新規カタログを作成」をクリックし、「CSV をアップロード」または「ブラウザで作成」を選択します。

メソッド 1:CSV をアップロード

1. ファイルをアップロードゾーンにドラッグアンドドロップするか、[CSV をアップロード] をクリックしてファイルを選択します。
   
   
   
2. 列ごとに、ブーリアン、数値、文字列、または時間のいずれかのデータタイプを選択します。
   
   
   
3. カタログに名前を付けてください。カタログの次の要件に注意してください。 name:
   • 一意でなければなりません。
   • 最大 250 文字まで
   • 数字、文字、ハイフン、およびアンダースコアのみを使用できます
     
     
4. (オプション) カタログの説明を追加します。
5. [プロセスカタログ] をクリックしてカタログを作成します。

カタログ名にはテンプレートを使用できないことに注意してください。たとえば、カタログ名として以下を使用することはできません。そうしないと、呼び出しは失敗します。

1
{% catalog_items custom_attribute.${catalog} item1, item2 %}

ブラウザでカタログを作成することを選択した後に、CSV ファイルを更新することもできます。[カタログを更新] > [CSV をアップロード] をクリックし、カタログ内の商品を更新、追加、削除するかどうかを選択します。

メソッド 2:ブラウザで作成

1. カタログの名前を入力します。カタログの次の要件に留意してください。 name:
   • 一意でなければなりません。
   • 最大 250 文字まで
   • 数字、文字、ハイフン、およびアンダースコアのみを使用できます
     
     
     
2. (オプション) カタログの説明を入力します。
3. カタログのリストページから作成したカタログを選択して、カタログを更新します。
4. [カタログを更新] > [フィールドを追加] をクリックしてフィールドを追加します。次に、フィールド名を入力し、ドロップダウンを使用してデータタイプを選択します。必要に応じて繰り返します。
   
   
   
5. [カタログの更新] > [アイテムの追加] をクリックして、以前に追加したフィールドに基づいて情報を入力してカタログにアイテムを追加します。次に、[商品を保存] または [保存して別の商品を追加**] をクリックして、商品の追加を続行します。
   

ブラウザでカタログの作成を選択した後に CSV ファイルをアップロードすることもできます。

カタログ例

このチュートリアルでは、2 つのゲームとその価格、イメージリンクを掲載したカタログを使用します。

この例では、CSV ファイルをアップロードしてカタログを作成します。、、image_linkおよびのデータ型はidtitleprice、それぞれ文字列、文字列、数値、および文字列です。

次に、このカタログに「games_catalog」という名前を付けて、プロセスカタログボタンをクリックします。その後、Braze はカタログの作成前にカタログにエラーがないか確認します。

カタログが作成された後は、この名前を編集することはできませんのでご注意ください。カタログを削除し、同じカタログ名を使用して更新バージョンを再アップロードできます。

メッセージでのカタログの使用

カタログは、Liquidがサポートされているドラッグアンドドロップエディターのどこでも含め、すべてのメッセージングチャネルで使用できます。

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

選択したメッセージコンポーザーで、プラスアイコンをクリックして「パーソナライゼーションを追加」モーダルを開き、パーソナライゼーションタイプの「カタログアイテム」を選択します。次に、カタログ名を選択します。前の例を使用して、「ゲーム」カタログを選択します。

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

1
{% catalog_items Games %}

ステップ 2:カタログアイテムを選択します

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

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

```liquid {% catalog_items Games 1234 %}

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

これは以下のようにレンダリングされます。

たったの7.49ドルでテイルズを手に入れよう！

API 経由のカタログ

Catalogs エンドポイントを活用して、増え続けるデータや情報を管理できます。

カタログの管理

カタログの作成エンドポイントを使用してカタログを作成できます。

さらにカタログを作成するときに、List catalogs エンドポイントを使用してワークスペース内のカタログのリストを返すこともできます。

カタログアイテムの管理

カタログの管理に加えて、非同期エンドポイントと同期エンドポイントを使用してカタログアイテムを管理することもできます。これには、カタログアイテムを編集および削除したり、カタログアイテムの詳細を一覧表示したりする機能が含まれます。

たとえば、個々のカタログアイテムを編集する場合は、/catalogs/catalog_name/items/item_idエンドポイントを使用できます。

その他のユースケース

複数のアイテム

1つのメッセージで1つのアイテムだけに制限されるわけではありません！「パーソナライゼーションを追加」モーダルを使用して、追加のカタログ項目と情報を挿入して表示するだけです。追加できるカタログ項目は 3 つまでであることに注意してください。

この例では、「テイルズ」、「テスラグラード」、「アカラトゥス」の 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!

これは以下のように戻ります。

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

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がカタログリストです。

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

画像を使う

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

たとえば、ゲームカタログのをテイルズのプロモーションメッセージに追加するには、「カタログアイテム」フィールドと image_link「表示する情報」フィールドに「」を選択します。image_link idこれにより、次の Liquid タグが画像に追加されます。 field:

```liquid {% catalog_items Games 1234 %}

{{ items[0].image_link }} ```

Liquidをレンダリングすると、次のようになります。

カタログアイテムのテンプレート作成

テンプレートを使用して、カスタム属性に基づいてカタログアイテムを動的に取得することもできます。たとえば、あるユーザーがカタログのゲーム ID wishlist の配列を含むカスタム属性を持っているとします。

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

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

たとえば、テイルズ（カタログで希望していた商品）がセール中であることをユーザーに知らせるには、メッセージコンポーザーに以下を追加します。

```liquid {% 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をアップロードして削除できます。

液体を使用する

Liquid ロジックのカタログを手動でつなぎ合わせることもできます。ただし、存在しない ID を入力した場合でも、Braze はオブジェクトを含まないアイテム配列を返すことに注意してください。配列のサイズをチェックしたり、if空の配列ケースに対応するステートメントを使用したりするなどのエラー処理を含めることをお勧めします。

カタログの管理

カタログをさらに作成するにつれて、カタログエンドポイントを活用して、増え続けるデータや情報を管理できます。これには、カタログアイテムの作成、編集、削除、およびカタログアイテムの詳細を一覧表示する機能が含まれます。

カタログ層

次の表は、無料版とプロ版のカタログの違いをまとめたものです。

カタログストレージ

無料版

無料版のカタログのストレージサイズは最大100 MBです。100 MB 未満であれば、アイテム数に制限はありません。選択内容はストレージに貢献します。選択内容が複雑になればなるほど、使用するストレージも多くなります。

カタログプロ

企業レベルでは、Catalogs Proの最大ストレージはカタログデータのサイズによって異なります。5 ギガバイト、10 ギガバイト、または 15 ギガバイト無料版のストレージ（100 MB）は、これらの各プランに含まれていることに注意してください。