Skip to content

カタログを作成する

カタログを作成するには、ユーザー以外のデータのCSVファイルをBrazeにインポートします。これにより、その情報にアクセスしてメッセージを充実させることができます。カタログには、任意のタイプのデータを取り込むことができます。このデータは通常、eコマースビジネスの商品情報や、教育プロバイダーのコース情報など、会社のある種のメタデータです。

ユースケース

カタログの一般的なユースケースは次のとおりです。

  • 製品
  • サービス
  • 食品
  • 今後のイベント
  • 音楽
  • パッケージ

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

サポートされているデータタイプ

サポートされているカタログのデータタイプ、説明、各データタイプの作成・更新方法（CSV vs APIおよびCDI）、フォーマットと例については、データタイプを参照してください。

カタログを作成する

カタログを作成するには、データ設定 > カタログに移動し、新規カタログ作成を選択して、以下のいずれかのオプションを選びます。

ステップ 1:CSVファイルを確認する

CSVファイルをアップロードする前に、そのファイルが以下の要件を満たしていることを確認してください。

CSVの要件 詳細
ヘッダー CSVファイルの最初の列は id と名付ける必要があり、各行には一意の id 値が含まれている必要があります。
列 CSVファイルには最大1,000個のフィールド（列）を含めることができます。各列名は最大250文字までです。
ファイルサイズ 無料プランでは、会社全体で扱うすべてのCSVファイルの合計サイズは100 MBに制限されます。プロプランの場合、単一のCSVファイルの最大ファイルサイズは2 GBです。
フィールド値 各セル（フィールド値）は最大5,000文字まで含めることができます。
有効な文字 id 列とすべてのヘッダー値は、英字、数字、ハイフン、アンダースコアのみを含めることができます。
データタイプ CSVアップロードでサポートされているデータタイプは、文字列、数値、ブール値、時刻です。APIおよびCDIを通じてのみ利用可能なデータタイプを含む全リストについては、データタイプを参照してください。
フォーマット 一貫性を保つため、すべてのテキストを小文字でフォーマットしてください。
エンコーディング UTF-8エンコーディングでCSVファイルを保存し、アップロードしてください。

ステップ 2:CSVをアップロードする

ファイルをアップロードゾーンにドラッグ＆ドロップするか、CSVをアップロードを選択してファイルを選択します。

各列のデータタイプを選択します。

カタログの名前と任意の説明を入力します。カタログに名前を付ける際には、以下の要件に留意してください。

  • 一意でなければなりません
  • 最大250文字
  • 数字、アルファベット、ハイフン、アンダースコアのみを含めることができます

「my_catalog」という名前のカタログ。

カタログを処理を選択してカタログを作成します。

チュートリアル:CSVファイルからカタログを作成する

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

チュートリアル: CSVファイルからカタログを作成する
id title price image_link
1234 Tales 7.49 https://picsum.photos/200
1235 Regeneration 22.49 https://picsum.photos/200

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

4つのカタログ列名:「id」、「title」、「price」、「image_link」。

次に、このカタログに「games_catalog」と名前を付け、カタログを処理ボタンを選択します。その後、Brazeはカタログを作成する前に、カタログにエラーがないかチェックします。

「games_catalog」という名前のカタログ。

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

カタログを作成したら、Campaignでのカタログの参照を開始できます。

前提条件

ブラウザでカタログを編集または作成するには、ワークスペースに対して以下のユーザー権限が必要です。

  • カタログを表示
  • カタログを編集
  • カタログをエクスポート
  • カタログを削除

ステップ 1:カタログの詳細を入力する

カタログの名前と任意の説明を入力します。カタログに名前を付ける際には、以下の要件に留意してください。

  • 一意でなければなりません
  • 最大250文字
  • 数字、アルファベット、ハイフン、アンダースコアのみを含めることができます

「my_catalog」という名前のカタログ。

ステップ 2:カタログを作成する

リストからカタログを選択し、次にカタログを更新 > フィールドを追加を選択します。フィールド名を入力し、ドロップダウンからデータタイプを選択します。必要に応じて繰り返します。

「rating」と「name」という2つのフィールドの例。

カタログを更新 > 項目を追加を選択し、以前に追加したフィールドに基づいて情報を入力して、カタログに項目を追加します。次に、項目を保存または保存して追加を選択して、項目の追加を続けます。

カタログ項目を追加する。

カタログのデータタイプのフォーマットと例については、データタイプを参照してください。

カタログ名でのテンプレートの使用

カタログに名前を付ける際、カタログ名にテンプレートを使用することもできます。これにより、言語やCampaignなどの変数に基づいてカタログ名をダイナミックに生成できます。例えば、次のように使用できます。

1
2
3
4

{% assign language = "content_spanish" %}

{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}

カタログの管理

ダッシュボードで

CSVをアップロードした後やブラウザでカタログを作成した後にカタログを更新するには、カタログを更新 > CSVをアップロードを選択し、カタログ内のアイテムを更新するか、追加するか、削除するかを選択します。

REST APIの使用

作成したカタログが増えた場合、カタログ一覧エンドポイントを使用して、ワークスペース内のカタログのリストを返すこともできます。

REST APIは、JSONオブジェクトや文字列配列を含む、すべてのカタログデータタイプをサポートしています。JSONオブジェクトと文字列配列は、REST APIを通じてのみ作成または更新できます。

クラウドデータ取り込みの使用

カタログはクラウドデータ取り込みを通じて維持できます。具体的には、データウェアハウス（Snowflake、Redshift、BigQuery、Databricks、Microsoft Fabric、S3など）からカタログデータを直接同期し、スケジュールに基づいて更新します。

カタログ項目の管理

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

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

カタログストレージ

ストレージ制限の概要については、データストレージの制限を参照してください。

無料版のカタログでは、会社全体のすべてのCSVファイルの合計で最大100 MBのファイルサイズがサポートされています。一方、Catalogs Proバージョンでは、単一のCSVファイルに対して最大2 GBのファイルサイズがサポートされています。

無料版

無料版カタログのストレージサイズは最大100 MBです。100 MB未満であれば、アイテム数に制限はありません。

Catalogs Pro

会社レベルで、Catalogs Proの最大ストレージはカタログデータのサイズに基づきます。ストレージサイズのオプションは、5 GB、10 GB、15 GBのいずれかです。なお、無料版のストレージ（100 MB）はこれらの各プランに含まれています。

仕様

以下の表は、カタログに含めることができる内容の仕様をまとめたものです。

項目 仕様
項目値の文字数 単一の値に最大5,000文字です。例えば、description というラベルのフィールドがある場合、そのフィールド内の最大文字数は5,000文字です。
項目列名の文字数 最大250文字
カタログあたりのセレクション数 カタログあたり最大30セレクション
New Stuff!