Skip to content

CSV インポート

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

CSVインポートについて

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

CSVインポートを使う

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

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

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

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

ステップ 2: 識別子を選択する

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

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

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

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

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

インポート時に user_alias_name と user_alias_label の両方を提供した場合、Braze は同じ 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からユーザーデータをエクスポートし、既存のユーザーに新しいカスタム属性を追加したい場合に役立ちます。

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

  • CSVファイルにこれらのプロファイルの external ID またはユーザーエイリアスがないことを確認します。含まれている場合、Braze はプロファイルを識別する際にメールアドレスよりも external ID またはユーザーエイリアスを優先して使用します。
  • CSVファイルが正しくフォーマットされていることを確認します。

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

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

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

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

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

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

必須の識別子

external_id は必須ではありませんが、CSVファイルのヘッダーとして以下の識別子のいずれかを必ず含める必要があります。各識別子についての詳細は、識別子を選択するを参照してください。

  • 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（サブスクリプショングループに含まれる）です。

必須の識別子

external_id は必須ではありませんが、CSVファイルのヘッダーとして以下の識別子のいずれかを必ず含める必要があります。各識別子についての詳細は、識別子を選択するを参照してください。

  • external_id
  • braze_id
  • user_alias_name および user_alias_label
  • email
  • phone

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

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

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

ステップ 4: ファイルをアップロードする

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

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

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

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

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

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

検証結果

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

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

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

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

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

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

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

「更新済み/CSVからインポート」フィルターを含むフィルターグループで、タイトルが「Halloween season fun」というCSVファイルが含まれています。

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

準備ができたら、インポートを開始を選択します。ユーザーインポートページで現在の進捗状況を追跡できます。このページは5秒ごとに自動更新されます。

インポートステータス

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

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

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

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

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

トラブルシューティング

ファイル検証を使用した場合は、まずエラーレポートから確認してください。そこにはフラグが立った各行の具体的な問題点と、修正方法の説明が含まれています。検証中ではなくインポート中に失敗した行については、ユーザーインポートページで行にカーソルを合わせ、 ボタンを選択してエラーレポートをダウンロードしてください。

CSVインポートのトラブルシューティングについては、以下のよくある問題を確認してください。

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

不正な形式の行

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

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

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

行が欠けている

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

文字列の引用符

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

正しくない形式の日付

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

データ構造の問題

無効なメールアドレス

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

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

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

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

カスタム属性のデータ型を変更する

既存のカスタム属性のデータ型を変更する必要がある場合（例：文字列からブール値へ）、CSVをインポートする前にダッシュボードのカスタム属性ページでデータ型を更新してください。CSVのデータ型が属性の現在定義されているデータ型と一致しない場合、インポートはエラーで失敗します。

複数のデータ型

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,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

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

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