Skip to content

CSV インポート

CSVインポートを使ってユーザー属性とカスタムイベントを記録・更新する方法を学ぶ。

CSVインポートについて

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

CSVインポートを使う

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

CSVユーザーインポートを開くには、オーディエンス＞ユーザーインポートへ移動する。ここには、最新のインポートに関する詳細を一覧にした表がある。例えば、アップロード日時、アップローダー名、ファイル名、ターゲティングの可用性、インポートされた行数、インポートのステータスなどが含まれる。

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

Braze ダッシュボードの [ユーザのインポート] ページ。

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

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

顧客データをインポートする際、各顧客の固有識別子としてexternal_id を使用できる。インポート時に を提供すると、Brazeexternal_idは既存のユーザーで同じ external_idを持つものを更新するか、該当するユーザーが見つからない場合はそのexternal_id を設定した新規ユーザーを作成する。

ユーザーエイリアスを持つユーザーのリストをインポートすることで、ユーザーエイリアスを持たないexternal_idユーザーを対象にできる。別名は代替となる一意のユーザー識別子として機能し、アプリに登録していない匿名のユーザーにマーケティングを行う場合に役立つ。

エイリアスのみを持つユーザープロファイルのアップロードまたは更新を行う場合、CSV に以下の 2 列が必要です。

  • user_alias_name:一意のユーザー識別子。 external_id の代わりに使用します。
  • user_alias_label:ユーザーエイリアスをグループ化するための共通ラベル。

インポート時に とuser_alias_name の両方を提供した場合、user_alias_labelBrazeは既存のユーザーで同じuser_alias_name と を持つものをuser_alias_label更新する。ユーザーが見つからない場合、Brazeはそのuser_alias_name設定で新規に付与された識別子でユーザーを作成する。

ダウンロード：CSV属性インポートテンプレート：ユーザーエイリアス

external_id または user_alias_name および user_alias_label 値の代わりに内部 Braze ID 値を使用して、Braze の既存のユーザープロファイルを更新するには、列のヘッダーとして braze_id を指定します。

これは、セグメンテーション内のCSVエクスポートオプションを使用してBrazeからユーザーデータをエクスポートし、既存のユーザーに新しいカスタム属性を追加したい場合に役立ちます。

外部ID またはユーザーエイリアスを省略し、電子メールアドレスまたは電話番号を使用してユーザーをインポートできます。メールアドレスまたは電話番号を含むCSV ファイルをインポートする前に、次の点を確認してください。

  • CSV ファイルにこれらのプロファイルの外部ID またはユーザエイリアスがないことを確認します。この場合、Braze は、プロファイルを識別するために、電子メールアドレスの前に外部ID またはユーザーエイリアスを使用して優先順位を付けます。
  • CSV ファイルが正しくフォーマットされていることを確認します。

既存のプロファイルにそのメールアドレスや電話番号が登録されている場合、そのプロファイルが更新される。Brazeは新しいプロファイルを作成しない。同じメールアドレスを持つ複数のプロファイルがある場合、Braze は/users/track endpoint と同じロジックを使用します。ここでは、最新の更新されたプロファイルが更新されます。

そのメールアドレスや電話番号のプロファイルが存在しない場合、Brazeはその識別子で新しいプロファイルを作成する。このプロファイルを後で識別するには、/users/identify endpoint を使用できます。ユーザープロファイルを削除するには、/users/delete エンドポイントも使用できます。

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

以下のいずれかのデータタイプを単一のCSVファイルとしてアップロードできる。複数のデータタイプをアップロードするには、複数のCSVファイルをアップロードする。

  • ユーザー属性：これにはデフォルトの属性とカスタムのユーザー属性の両方が含まれる。デフォルトのユーザー属性は、Brazeで予約されているキー（例：first_nameemail`\`や\`）であり、カスタム属性は自社固有のユーザー属性（例：`last_destination_searched）である。
  • カスタムイベント：これらはあなたのビジネスに固有のものであり、ユーザーが行ったアクションを反映している。例えば旅行予約アプリの場合trip_bookedなどだ。

CSVファイルの作成を始める準備ができたら、以下の情報を参照するんだ。

必須の識別子

CSVファイルにはヘッダーとして以下の識別子のいずれかを必ずexternal_id含める必要がある。各識別子についての詳細は、「識別子の選択」を参照せよ。

  • external_id
  • braze_id
  • user_alias_name そして user_alias_label
  • email
  • phone

カスタム属性

以下のデータ型は、CSVインポートのカスタム属性として使用できる。列ヘッダーがデフォルト属性と完全に一致しない場合、Brazeではカスタム属性としてインポートされる。

デフォルト属性

ユーザーインポートでは、以下のデフォルト属性が利用可能である。

サブスクリプショングループのステータスを更新する（任意）

さらに、ユーザーインポートを通じて、メールやSMSのサブスクリプショングループにユーザーを追加できる。これは特に SMS で便利です。ユーザーが SMS チャネルでメッセージを受信するには、SMS 購読グループに登録されていなければならないためです。詳細については、SMS サブスクリプショングループを参照してください。

サブスクリプショングループのステータスを更新する場合は、CSV に次の2 つの列が必要です。

  • subscription_group_id:サブスクリプショングループの id。
  • subscription_state:使用できる値は、unsubscribed(購読グループに含まれない) または subscribed (購読グループに含まれる) です。

必須の識別子

CSVファイルにはヘッダーとして以下の識別子のいずれかを必ずexternal_id含める必要がある。各識別子についての詳細は、「識別子の選択」を参照せよ。

  • external_id
  • braze_id
  • user_alias_name そして user_alias_label
  • email
  • phone

カスタムイベントフィールド

以下の項目に加えて、CSVファイルにはイベントのプロパティを示す追加の列ヘッダーが含まれている場合がある。これらのプロパティには列ヘッダーが必要だ。 <event_name>.properties.<property name>.

例えば、カスタムイベントにはプロパティdestinationtrip_bookedとを持つことがあるduration。これらのデータは、列ヘッダーを とtrip_booked.properties.destination に設定trip_booked.properties.durationすることでインポートできる。

ステップ 4: ファイルをアップロードせよ

ファイルをアップロードするには、属性またはイベントを選択し、ファイルを参照をクリックして、CSVファイルをアップロードする。Brazeは最初の数行のプレビューと、検出されたフィールドの概要を表示する。

アップロード完了モーダルには、ファイルのプレビュー、インポート名フィールド、ターゲティング設定、ファイル検証チェックボックスが表示される。

インポート名フィールドでは、インポートの名前を変更できる。デフォルトでは、ファイル名が使われる。

ステップ 5: ファイルを検証する（任意）

インポートを開始する前に、ファイル検証を実行して各行のエラーや警告を確認できる。ファイルを検証するには、インポート前に「ファイルを検証」を選択し、その後「インポートを開始」をクリックする。

最大許可サイズまでのファイルの場合、検証には最大2分かかることがある。検証が実行されている間、[検証をスキップ]を選択すれば検証を省略してすぐに進める。

検証結果

検証が完了すると、以下のいずれかの結果が表示される。

問題が見つかりましたダイアログは、エラーと警告のある行数を表示し、キャンセル、エラーレポートのダウンロード、またはそれでもインポートするオプションを提供する。

エラーレポートを理解する

エラーレポートはCSVファイルであり、フラグが立てられた行すべてを、元のデータと問題の説明とともに含む。

レポートを確認した後、元のファイルで問題を修正して再アップロードするか、インポートを続行して部分的な結果を受け入れることができる。

ステップ 6: ターゲティング設定を選択する

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

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

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

準備ができたら、[インポートを開始]をクリックする。インポートユーザーページで現在の進捗状況をトラッキングできる。このページは5秒ごとに自動更新される。

インポートステータス

インポートを開始した後、そのステータスは「ユーザーインポート」ページで確認できる。

ユーザーインポートページは部分的な成功ステータスを示し、コンテキストメニューが開いている。ダウンロードエラーレポートとアップロード済みCSVのダウンロードオプションが表示されている。

インポート後のエラーレポートには、検証対象外の理由で失敗した行が含まれる。例えば、ユーザーがBrazeに存在しない場合などだ。

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

CSVファイルからインポートされた顧客データは、external IDと空白値を除き、ユーザープロファイル上の既存値を上書きし、データポイントをログに記録する。Brazeのデータポイントに関する細かい点について質問があるなら、担当のアカウントマネージャーが答えてくれる。

トラブルシューティング

ファイル検証を使ったなら、まずエラーレポートから始めろ。そこにはフラグが立った各行の具体的な問題点と、修正方法の説明が含まれている。インポート中に失敗した行（検証中のエラーではない）については、ユーザーインポートページの三点メニューからエラーレポートをダウンロードする。

CSVのインポートで問題がある場合は、以下のよくある問題を確認するといい。それでもサポートが必要な場合は、support@に連絡braze.comせよ。

ファイルの書式設定の問題

正しくない形式の行

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

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

CSVファイルに空白行が含まれており、インポートされる行数がファイル全体の行数より少ない場合、これはインポートの問題を示しているとは限らない。空白行はインポートする必要がないからだ。正しくインポートされた行数を調べて、インポートしようとしているユーザー数と一致することを確認してください。

行が欠けている

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

文字列の引用符

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

正しくない形式の日付

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

データ構造の問題

無効なメールアドレス

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

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

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

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

複数のデータ型

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

さらに、数値属性にゼロで始まる数字を使用すると問題が発生する。なぜなら、ゼロで始まる数値は文字列と見なされるからだ。Brazeがその文字列を変換する際、8進値（0から7までの数字を使用）として扱われる場合がある。つまり、対応する10進値に変換されるのだ。例えば、CSVファイルの値が0130の場合、Brazeプロファイルには88と表示される。この問題を防止するには、文字列データ型の属性を使用する。ただし、このデータ型はセグメンテーション番号の比較では利用できない。

デフォルトの属性タイプ

一部のデフォルト属性は、ユーザー更新において特定の値のみを有効な値として受け入れる場合がある。参考までに、CSVの作成方法を参照のこと。

末尾のスペースや大文字小文字の違いは、値が無効と解釈される原因となる。例えば、次のCSVファイルでは、最初の行（brazetest1）のユーザーのみがメールとプッシュ通知のステータスを正常に更新できた。なぜなら、受け入れられる値は unsubscribed,subscribed , だからだopted_in。

1
2
3

external_id,email,email_subscribe,push_subscribe
brazetest1,test1@braze.com,unsubscribed,unsubscribed
brazetest2,test2@braze.com,Unsubscribed,Unsubscribed

「CSVファイルを選択」が機能していない

「CSVファイルを選択」ボタンが動作しない理由はいくつかある：
Github   GitHub でこのページを編集
New Stuff!