CSV インポート

CSVインポートを使用して、ユーザー属性やカスタムイベントを記録・更新する方法を学習する。

CSVインポートについて

CSV インポートを使用して、次のユーザー属性およびカスタムイベントを記録および更新できます。

CSVインポートを使用する

ステップ 1: CSVテンプレートをダウンロードする

CSVユーザーインポートを開封するには、オーディエンス>ユーザーをインポートする。ここには、アップロード日、アップロード者の名前、ファイル名、ターゲットの有無、インポートされた行数、インポートのステータスなど、直近のインポートに関する詳細が一覧表示された表がある。

CSVを使い始めるには、属性またはイベント用のテンプレートをダウンロードしよう。

!Brazeダッシュボードの’Import Users’ページ。

ステップ 2: 識別子を選ぶ

インポートするCSVには専用の識別子が必要だ。以下の中から選ぶことができる：

• external id
• user alias
• braze id
• email address and phone numbers

ステップ 3: CSVファイルを作成する

アップロードできるデータ形式は、以下のいずれかのCSVファイルである。複数のデータ型をアップロードするには、複数のCSVファイルをアップロードする。

• ユーザー属性：これにはデフォルトとカスタムの両方のユーザー属性が含まれる。デフォルトユーザー属性は、Brazeの予約キー（first_name やemail など）であり、カスタム属性は、お客様のビジネスに固有のユーザー属性（last_destination_searched など）である。
• カスタムイベント：旅行予約アプリのtrip_booked のように、ユーザーが行ったアクションを反映する。

CSVファイルを作り始める準備ができたら、以下の情報を参考にしてほしい：

• user attributes
• custom events

ステップ 4: データをアップロードしてプレビューする

BrazeはCSVを処理する前に、最初の数行のプレビューを生成するので、問題がないかチェックすることができる。プレビューを作成するには、「アトリビューション」または「イベント」を選択し、「ファイルを参照」を選択してCSVファイルをアップロードする。

!CSVのアップロードが完了したが、1つの列にデータ型が混在するエラーが発生した。

ステップ 5: ターゲット設定を選択する

また、以下のターゲティング設定から選ぶこともできる。インポートから新しいターゲティングフィルターまたはセグメンテーションを作成する必要がない場合は、「このリストをターゲティングフィルターとして利用可能にしない」を選択する。

!更新／CSVからインポート」フィルターを持つフィルターグループには、「ハロウィーンシーズンの楽しみ」というタイトルのCSVファイルが含まれている。

ステップ6: CSVインポートを開始する

準備ができたら、Start importを選択する。現在の進捗状況は、5秒ごとに自動的に更新されるユーザーインポートページで確認できる。

問題がなければ、ステータスはCompleteに更新され、処理された行数が表示される。処理された行のデータはすべて、既存のプロファイルに追加されるか、新しく作成されたプロファイルに追加される。

データポイントの考慮事項

CSVファイルからインポートされた各顧客データは、外部IDと空白の値を除き、ユーザープロファイル上の既存の値を上書きし、データポイントを記録する。Brazeデータポイントのニュアンスについてご質問があれば、Brazeアカウントマネージャーがお答えできる。

トラブルシューティング

CSVインポートに問題がある場合は、以下の一般的な問題を確認してほしい。それでもサポートが必要な場合は、サポート@braze.com までご連絡を。

ファイルフォーマットの問題

正しくない形式の行

アップロードがエラーで完了した場合、CSVファイルに不正な行がある可能性がある。

データを正しくインポートするには、ヘッダー行がなければならない。各行のセル数はヘッダー行と同じでなければなりません。ヘッダー行より値の数が多い、または少ない行は、インポートから除外されます。値に含まれるコンマは区切り文字として解釈され、このエラーを引き起こす可能性があります。さらに、すべてのデータが UTF-8 でエンコードされていなければなりません。

CSV ファイルに空白行があり、インポートされた行数が CSV ファイルの合計行数より少ない場合、これはインポートの問題ではない可能性があります。空白行はインポートする必要がないためです。正しくインポートされた行数を調べて、インポートしようとしているユーザー数と一致することを確認してください。

行が欠けている

インポートされたユーザー数が CSV ファイルの合計行数と一致しない理由はいくつかあります。

文字列の引用符

一重引用符 ('') または二重引用符 ("") で囲まれた値は、インポート時に文字列として読み取られます。

正しくない形式の日付

ISO-8601 形式以外の日付は、インポート時に datetimes として読み取られません。

データ構造の問題

無効なメールアドレス

アップロードがエラーで完了した場合、1つ以上の無効な暗号化メールアドレスが存在する可能性がある。Brazeにインポートする前に、すべてのEメールアドレスが適切に暗号化されていることを確認する。

• Brazeで** Eメールアドレスを更新またはインポートする場合**、Eメールが含まれる場所ではハッシュ化されたEメール値を使用する。これらのハッシュメールの値は、あなたの内部チームによって提供される。
• 新規ユーザーを作成する際には、email_encrypted 、そのユーザーの暗号化されたメールの値を追加しなければならない。それ以外の場合、ユーザーは作成されません。同様に、メールを持っていない既存ユーザーにメールアドレスを追加する場合は、email_encrypted 。そうでなければ、ユーザーは更新されない。

データがカスタム属性としてインポートされる

デフォルトのユーザーデータ (email や first_name など) がカスタム属性としてインポートされている場合は、CSV ファイルの大文字小文字とスペースを確認してください。例えば、First_name はカスタム属性としてインポートされますが、first_name はユーザープロファイルの [名] フィールドに正しくインポートされます。

複数のデータ型

Braze では、列の各値が同じデータ型である必要があります。属性のデータ型と一致しない値があると、セグメンテーションでエラーが発生します。

さらに、ゼロで始まる数値は文字列とみなされるため、数値属性をゼロで始めると問題が発生する。Brazeがその文字列を変換するとき、8進数値（0から7までの数字を使用）のように扱われることがある。例えば、CSVファイルの値が0130の場合、Brazeプロファイルは88と表示される。この問題を防ぐには、文字列データ型のアトリビューションを使用する。しかし、このデータ型はセグメンテーション数の比較では利用できない。

デフォルトの属性タイプ

デフォルト属性の中には、ユーザー更新に有効な特定の値しか受け付けないものもある。ガイダンスについては、CSVを作成するを参照のこと。

末尾の空白や大文字と小文字の違いは、値が無効と解釈される原因となる。unsubscribed subscribed opted_in例えば、以下のCSVファイルでは、1行目のユーザー(brazetest1)のメールとプッシュ・ステータスの更新が成功する。

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

“CSVファイルを選択 “が機能しない

CSVファイルを選択」ボタンが機能しない理由はいくつかある：