Skip to content

カタログを作成

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

ユースケース

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

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

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

サポートされているデータ型

以下の表は、サポートされているカタログデータ型と、それらの作成または更新方法を一覧表示している。

カタログを作成する

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

ステップ 1: CSVファイルを確認せよ

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

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

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

各列のデータ型を選択せよ。

カタログの名前と任意の説明を入力せよ。カタログに名前を付ける際には、以下の要件を心に留めておくことだ。

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

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

プロセスカタログを押してカタログを作成します。

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

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

id 名称 価格 image_link
1234 Tales 7.49 https://picsum.photos/200
1235 Regeneration 22.49 https://picsum.photos/200

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

四つのカタログ列名:「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を通じてのみ作成または更新できる。

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

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

カタログ項目の管理

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

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

カタログ保管

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

無料版

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

カタログ Pro

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

New Stuff!