Skip to content

カタログを作成する

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

ユースケース

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

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

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

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

以下の表は、サポートされているカタログのデータタイプと、それぞれの作成・更新方法を示しています。

カタログの作成

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

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

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

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

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

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

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

このデータタイプはカタログの設定後に編集できません。また、NULL値はCSVアップロードではサポートされておらず、文字列として扱われます。

カタログの名前とオプションの説明を入力します。カタログの命名には以下の要件に注意してください。

  • 一意である必要があります
  • 最大250文字
  • 数字、文字、ハイフン、アンダースコアのみ使用可能

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

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

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

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

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」という名前のカタログ。

カタログの作成後はこの名前を編集できません。カタログを削除し、同じカタログ名を使用して更新版を再アップロードできます。

カタログを作成したら、キャンペーンでのカタログの参照を開始できます。

前提条件

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

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

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

カタログの名前とオプションの説明を入力します。カタログの命名には以下の要件に注意してください。

  • 一意である必要があります
  • 最大250文字
  • 数字、文字、ハイフン、アンダースコアのみ使用可能

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

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

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

「rating」と「name」の2つのサンプルフィールド。

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

カタログアイテムを追加する。

カタログのデータ型

カタログは、データを効果的に整理・構造化するために、さまざまなデータ型をサポートしています。次の表は、サポートされている各データ型と、CSVおよびAPIの型名とのマッピングについて説明しています。

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

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

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を通じてのみ作成または更新できます。

Cloud Data Ingestionを使用する

Cloud Data Ingestionを使用して、データウェアハウス（Snowflake、Redshift、BigQuery、Databricks、Microsoft Fabric、S3など）からカタログデータをスケジュールに基づいて直接同期することで、カタログを維持できます。

カタログアイテムの管理

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

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

カタログストレージ

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

無料版

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

Catalogs Pro

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

仕様

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