カタログを作成する

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

カタログの一般的な使用例には次のようなものがある：

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

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

CSVファイルを準備する

カタログを作成する前に、アップロードによるカタログ作成を希望する場合は、CSVファイルを用意しておくこと。

CSVファイルのガイドライン

CSVファイルを作成する際には、以下のガイドラインに注意すること。CSVファイルの最初の列は、id のヘッダーでなければならず、各項目のid は一意でなければならない。その他のカラム名はすべて一意でなければならない。さらに、カタログCSVファイルには以下の制限が適用される：

• 最大1,000フィールド（列）。
• 最大250文字のフィールド（カラム）名
• 全社CSVファイル合計で最大100MB（無料）
• CSV ファイルの最大サイズ 2 GB (Pro)
• 最大5,000文字のフィールド値（セル）。
• id とヘッダーの値には、英字、数字、ハイフン、アンダースコアのみを使用できます。

また、CSVファイルのテキストはすべて小文字でフォーマットすることを推奨する。次のステップでCSVファイルをうまくアップロードするために、CSVファイルをUTF-8形式でエンコードしていることを確認しよう。

方法を選択する

カタログを作成するには、「データ設定」＞「カタログ」と進む。

新しいカタログを作成」を選択し、「CSVをアップロード」または「ブラウザで作成」のいずれかを選択する。

方法1:CSVをアップロードする

1. ファイルをアップロードゾーンにドラッグ＆ドロップするか、「CSVをアップロード」をクリックしてファイルを選択する。
   
   
   
2. 各列のデータ型として、boolean、number、string、timeのいずれかを選択する。
   
   
   
3. カタログに名前をつける。カタログ名に関する以下の要件に留意すること：
   • 一意でなければなりません。
   • 最大 250 文字。
   • 数字、アルファベット、ハイフン、アンダースコアのみを含むことができる。
     
     
4. (オプション）カタログの説明を追加する。
5. プロセスカタログを押してカタログを作成します。

カタログ名にテンプレートを使うこともできる。例えば、次のものを使用できます。

1
2
3
4
{% assign language = "content_spanish" %}

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

ブラウザでカタログ作成を選択した後、CSVファイルを更新することもできる。[カタログを更新] > {CSV をアップロード] をクリックし、カタログのアイテムの更新、追加、または削除のいずれを実行するかを選択します。

方法2：ブラウザで作成する

1. カタログの名前を入力する。カタログ名については、以下の要件に留意すること：
   • 一意でなければなりません。
   • 最大 250 文字
   • 数字、アルファベット、ハイフン、アンダースコアのみを含むことができる。
     
     
     
2. (オプション）カタログの説明を入力する。
3. カタログを更新するには、[カタログ] ページのリストから、先ほど作成したカタログを選択します。
4. カタログ更新＞フィールド追加を選択し、フィールドを追加する。次に、フィールド名を入力し、ドロップダウンを使ってデータタイプを選択する。必要に応じて繰り返す。
   
   
   
5. カタログ更新＞アイテム追加を選択し、以前に追加したフィールドに基づいて情報を入力し、カタログにアイテムを追加する。その後、「Save Item」または「Save and Add Another」を選択して、アイテムの追加を続ける。
   

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

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

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

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

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

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

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

APIでカタログを管理する

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

カタログ項目の管理

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

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

カタログ階層{#tiers}

次の表で、無料版とプロ版のカタログの違いを説明します。

カタログストレージ

無料版

無料版カタログのストレージサイズは最大 100 MBです。100 MB 未満であれば、アイテム数に制限はありません。セレクションはストレージに影響します。セレクションが複雑になるほど、より多くのストレージが必要です。また、CSVカタログデータとデータストアのデータ表現との間にサイズの不一致が生じる。

カタログ Pro

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