CSVインポート
CSVインポートを使用してユーザー属性やカスタムイベントを記録・更新する方法を説明します。
CSVインポートについて
CSVインポートを使用して、以下のユーザー属性やカスタムイベントを記録・更新できます。Brazeは、以下の表に記載された最大サイズ以内の標準CSVファイルとしてこのデータを受け付けます。
| タイプ | 定義 | 例 | 最大ファイルサイズ |
|---|---|---|---|
| デフォルト属性 | Brazeが認識する予約済みのユーザー属性。 | first_name、email |
500 MB |
| カスタム属性 | ビジネス固有のユーザー属性。 | last_destination_searched |
500 MB |
| カスタムイベント | ユーザーのアクションを表すビジネス固有のイベント。 | trip_booked |
50 MB |
CSVインポートの使用
ステップ1:CSVテンプレートをダウンロードする
CSVインポートを開くには、Audiences > Import Users に移動します。ここには、アップロード日、アップロード者名、ファイル名、ターゲティングの利用可否、インポートされた行数、インポートのステータスなど、最新のインポートに関する詳細を一覧表示するテーブルがあります。
開始するには、AttributesまたはEventsを選択し、適切なテンプレートをダウンロードしてアップロード用のCSVファイルを作成します。
ステップ2:識別子を選択する
インポートするCSVファイルには、専用の識別子が必要です。インポートに使用する識別子タイプを以下から選択してください。
顧客データをインポートする際、各顧客の一意の識別子としてexternal_idを使用できます。インポートでexternal_idを指定すると、Brazeは同じexternal_idを持つ既存のユーザーを更新するか、該当するユーザーが見つからない場合はそのexternal_idが設定された新しい識別済みユーザーを作成します。
- ダウンロード：CSV属性インポートテンプレート：External ID
- ダウンロード：CSVイベントインポートテンプレート：External ID
external_idを持つユーザーと持たないユーザーが混在している場合、インポートごとに1つのCSVを作成する必要があります。1つのCSVにexternal_idsとユーザーエイリアスの両方を含めることはできません。
external_idを持たないユーザーをターゲットにするには、ユーザーエイリアスを使用してユーザーのリストをインポートできます。エイリアスは代替の一意のユーザー識別子として機能し、サインアップやアカウント作成をしていない匿名ユーザーにマーケティングを行う場合に役立ちます。
エイリアスのみのユーザープロファイルをアップロードまたは更新する場合、CSVに以下の2つの列が必要です。
user_alias_name：一意のユーザー識別子。external_idの代替です。user_alias_label：ユーザーエイリアスをグループ化するための共通ラベル。
user_alias_name |
user_alias_label |
last_name |
email |
sample_attribute |
|---|---|---|---|---|
| 182736485 | my_alt_identifier | Smith | [email protected] | TRUE |
| 182736486 | my_alt_identifier | Nguyen | [email protected] | FALSE |
インポートでuser_alias_nameとuser_alias_labelの両方を指定すると、Brazeは同じuser_alias_nameとuser_alias_labelを持つ既存のユーザーを更新します。ユーザーが見つからない場合、Brazeはそのuser_alias_nameが設定された新しい識別済みユーザーを作成します。
既にexternal_idを持つ既存のユーザーをuser_alias_nameでCSVインポートを使用して更新することはできません。代わりに、関連するuser_alias_nameを持つ新しいユーザープロファイルが作成されます。エイリアスのみのユーザーをexternal_idに関連付けるには、ユーザー識別エンドポイントを使用してください。
ダウンロード：CSV属性インポートテンプレート：ユーザーエイリアス
external_idやuser_alias_nameとuser_alias_labelの値の代わりに、内部のBraze ID値を使用してBrazeの既存のユーザープロファイルを更新するには、列ヘッダーとしてbraze_idを指定します。
これは、セグメンテーション内のCSVエクスポートオプションを使用してBrazeからユーザーデータをエクスポートし、それらの既存ユーザーに新しいカスタム属性を追加したい場合に便利です。
braze_idを使用してCSVインポートで新しいユーザーを作成することはできません。この方法は、Brazeプラットフォーム内の既存ユーザーの更新にのみ使用できます。
BrazeダッシュボードからのCSVエクスポートでは、braze_idの値がAppboy IDと表示されている場合があります。このIDはユーザーのbraze_idと同じであるため、CSVを再インポートする際にこの列をbraze_idに名前変更できます。
external IDやユーザーエイリアスを省略し、メールアドレスまたは電話番号を使用してユーザーをインポートできます。メールアドレスまたは電話番号を含むCSVファイルをインポートする前に、以下を確認してください。
- CSVファイルにこれらのプロファイルのexternal IDやユーザーエイリアスが含まれていないことを確認してください。含まれている場合、Brazeはプロファイルの識別にメールアドレスよりもexternal IDまたはユーザーエイリアスを優先します。
- CSVファイルが正しくフォーマットされていることを確認してください。
CSVファイルにメールアドレスと電話番号の両方が含まれている場合、プロファイルの検索時にメールアドレスが電話番号よりも優先されます。
そのメールアドレスまたは電話番号を持つ既存のプロファイルがある場合、そのプロファイルが更新され、Brazeは新しいプロファイルを作成しません。同じメールアドレスを持つ複数のプロファイルがある場合、Brazeは/users/trackエンドポイントと同じロジックを使用し、最も最近更新されたプロファイルが更新されます。
そのメールアドレスまたは電話番号を持つプロファイルが存在しない場合、Brazeはその識別子を持つ新しいプロファイルを作成します。/users/identifyエンドポイントを使用して、後でこのプロファイルを識別できます。ユーザープロファイルを削除するには、/users/deleteエンドポイントも使用できます。
ステップ3:CSVファイルを作成する
以下のいずれかのデータタイプを1つのCSVファイルとしてアップロードできます。複数のデータタイプをアップロードするには、複数のCSVファイルをアップロードしてください。
- ユーザー属性：デフォルトとカスタムの両方のユーザー属性が含まれます。デフォルトのユーザー属性はBrazeの予約キー（
first_nameやemailなど）であり、カスタム属性はビジネス固有のユーザー属性（last_destination_searchedなど）です。 - カスタムイベント：ビジネス固有のイベントで、旅行予約アプリの
trip_bookedのように、ユーザーが実行したアクションを表します。
CSVファイルの作成を始める準備ができたら、以下の情報を参照してください。
必須の識別子
external_idは必須ではありませんが、CSVファイルには以下の識別子のうち1つにマッピングできるユーザー識別子を含める必要があります。各識別子の詳細については、識別子を選択するを参照してください。
external_idbraze_iduser_alias_nameおよびuser_alias_labelemailphone
カスタム属性
以下のデータタイプは、CSVインポートのカスタム属性として使用できます。デフォルト属性と完全に一致しない列ヘッダーは、マッピングステップで変更しない限り、Brazeでカスタム属性としてインポートされます。
| データタイプ | 説明 |
|---|---|
| 日時 | ISO-8601形式で保存する必要があります。 |
| ブール値 | trueまたはfalseを受け付けます。 |
| 数値 | スペースやカンマのない整数または浮動小数点数である必要があります。浮動小数点数はピリオド（.）を小数点区切りとして使用する必要があります。 |
| 文字列 | 値が二重引用符（""）で囲まれている場合、カンマを含めることができます。 |
| 空白 | 空白の値はユーザープロファイルの既存の値を上書きしません。CSVファイルに既存のすべてのユーザー属性を含める必要はありません。 |
配列、プッシュトークン、カスタムイベントのデータタイプはユーザーインポートではサポートされていません。CSVファイル内のカンマが列区切りとして解釈され、ファイルの解析時にエラーが発生するためです。
これらの種類の値をアップロードするには、代わりに/users/trackエンドポイントまたはクラウドデータ取り込みを使用してください。
デフォルト属性
デフォルト属性をインポートする場合、使用する列ヘッダーはデフォルトのユーザー属性のスペルと大文字小文字に完全に一致する必要があります。一致しない場合、Brazeはそれらをカスタム属性として検出します。
以下のデフォルト属性がユーザーインポートで利用可能です。
| ユーザープロファイルフィールド | データタイプ | 説明 | 必須？ |
|---|---|---|---|
external_id |
文字列 | 顧客の一意のユーザー識別子。 | 条件付き。必須の識別子を参照してください。 |
user_alias_name |
文字列 | external_idの代替となる匿名ユーザーの一意のユーザー識別子。user_alias_labelと一緒に使用する必要があります。 |
条件付き。必須の識別子を参照してください。 |
user_alias_label |
文字列 | ユーザーエイリアスをグループ化するための共通ラベル。user_alias_nameと一緒に使用する必要があります。 |
条件付き。必須の識別子を参照してください。 |
first_name |
文字列 | ユーザーが示した名（例：Jane）。 |
いいえ |
last_name |
文字列 | ユーザーが示した姓（例：Doe）。 |
いいえ |
email |
文字列 | ユーザーが示したメールアドレス（例：[email protected]）。 |
いいえ |
country |
文字列 | 国コードはISO-3166-1 alpha-2規格でBrazeに渡す必要があります（例：GB）。 |
いいえ |
dob |
文字列 | 「YYYY-MM-DD」形式で渡す必要があります（例：1980-12-21）。ユーザーの生年月日をインポートし、誕生日が「今日」のユーザーをターゲットにできます。 |
いいえ |
gender |
文字列 | 「M」、「F」、「O」（その他）、「N」（該当なし）、「P」（回答しない）、またはnil（不明）。 | いいえ |
home_city |
文字列 | ユーザーが示した居住都市（例：London）。 |
いいえ |
language |
文字列 | 言語はISO-639-1規格でBrazeに渡す必要があります（例：en）。対応言語一覧を参照してください。 |
いいえ |
phone |
文字列 | ユーザーが示した電話番号。E.164形式（例：+442071838750）。フォーマットのガイダンスについては、ユーザーの電話番号を参照してください。 |
いいえ |
email_open_tracking_disabled |
ブール値 | trueまたはfalseを受け付けます。trueに設定すると、このユーザーに送信される今後のすべてのメールに開封トラッキングピクセルが追加されなくなります。SparkPostとSendGridでのみ利用可能です。 | いいえ |
email_click_tracking_disabled |
ブール値 | trueまたはfalseを受け付けます。trueに設定すると、このユーザーに送信される今後のメール内のすべてのリンクのクリックトラッキングが無効になります。SparkPostとSendGridでのみ利用可能です。 | いいえ |
email_subscribe |
文字列 | 利用可能な値はopted_in（メールメッセージの受信を明示的に登録）、unsubscribed（メールメッセージの受信を明示的にオプトアウト）、subscribed（オプトインもオプトアウトもしていない）です。 |
いいえ |
push_subscribe |
文字列 | 利用可能な値はopted_in（プッシュメッセージの受信を明示的に登録）、unsubscribed（プッシュメッセージの受信を明示的にオプトアウト）、subscribed（オプトインもオプトアウトもしていない）です。 |
いいえ |
time_zone |
文字列 | タイムゾーンはIANAタイムゾーンデータベースと同じ形式でBrazeに渡す必要があります（例：America/New_YorkまたはEastern Time (US & Canada)）。 |
いいえ |
date_of_first_session date_of_last_session |
文字列 | 以下のISO 8601形式のいずれかで渡すことができます：「YYYY-MM-DD」「YYYY-MM-DDTHH:MM:SS+00:00」「YYYY-MM-DDTHH:MM:SSZ」「YYYY-MM-DDTHH:MM:SS」（例：2019-11-20T18:38:57） | いいえ |
subscription_group_id |
文字列 | サブスクリプショングループのid。この識別子はダッシュボードのサブスクリプショングループページで確認できます。 |
いいえ |
subscription_state |
文字列 | subscription_group_idで指定されたサブスクリプショングループのサブスクリプション状態。許可される値はunsubscribed（サブスクリプショングループに含まれない）またはsubscribed（サブスクリプショングループに含まれる）です。 |
いいえ。ただし、subscription_group_idを使用する場合は強く推奨されます |
サブスクリプショングループのステータスを更新する（オプション）
さらに、ユーザーインポートを通じてメールまたはSMSのサブスクリプショングループにユーザーを追加できます。これはSMSの場合に特に便利です。SMSチャネルでメッセージを送信するには、ユーザーがSMSサブスクリプショングループに登録されている必要があるためです。詳細については、SMSサブスクリプショングループを参照してください。
サブスクリプショングループのステータスを更新する場合、CSVに以下の2つの列が必要です。
subscription_group_id：サブスクリプショングループのid。subscription_state：利用可能な値はunsubscribed（サブスクリプショングループに含まれない）またはsubscribed（サブスクリプショングループに含まれる）です。
| external_id | first_name | subscription_group_id | subscription_state |
|---|---|---|---|
| A8i3mkd99 | Colby | 6ff593d7-cf69-448b-aca9-abf7d7b8c273 | subscribed |
| k2LNhj8Ks | Tom | aea02307-a91e-4bc0-abad-1c0bee817dfa | subscribed |
ユーザーインポートでは、1行につき1つのsubscription_group_idのみ設定できます。異なる行には異なるsubscription_group_idの値を設定できます。ただし、同じユーザーを複数のサブスクリプショングループに登録する必要がある場合は、複数回のインポートが必要です。
必須の識別子
external_idは必須ではありませんが、CSVファイルのヘッダーとして以下の識別子のうち1つを必ず含める必要があります。各識別子の詳細については、識別子を選択するを参照してください。
external_idbraze_iduser_alias_nameおよびuser_alias_labelemailphone
カスタムイベントフィールド
以下に加えて、CSVにはイベントプロパティの追加の列ヘッダーを含めることもできます。これらのプロパティの列ヘッダーは<event_name>.properties.<property name>.の形式にする必要があります。
例えば、カスタムイベントtrip_bookedにプロパティdestinationとdurationがある場合、列ヘッダーはtrip_booked.properties.destinationとtrip_booked.properties.durationになります。
| ユーザープロファイルフィールド | データタイプ | 情報 | 必須？ |
|---|---|---|---|
external_id |
文字列 | ユーザーの一意のユーザー識別子。 | 条件付き。必須の識別子を参照してください。 |
braze_id |
文字列 | Brazeが割り当てたユーザーの識別子。 | 条件付き。必須の識別子を参照してください。 |
user_alias_name |
文字列 | external_idの代替となる匿名ユーザーの一意のユーザー識別子。user_alias_labelと一緒に使用する必要があります。 |
条件付き。必須の識別子を参照してください。 |
user_alias_label |
文字列 | ユーザーエイリアスをグループ化するための共通ラベル。user_alias_nameと一緒に使用する必要があります。 |
条件付き。必須の識別子を参照してください。 |
email |
文字列 | ユーザーが示したメールアドレス（例：[email protected]）。 |
いいえ。他の識別子がない場合にのみ使用できます。以下の注記を参照してください。 |
phone |
文字列 | ユーザーが示した電話番号。E.164形式（例：+442071838750）。フォーマットのガイダンスについては、ユーザーの電話番号を参照してください。 |
いいえ。他の識別子がない場合にのみ使用できます。以下の注記を参照してください。 |
name |
文字列 | ユーザーのカスタムイベント。 | はい |
time |
文字列 | イベントの時刻。以下のISO-8601形式のいずれかで渡すことができます：「YYYY-MM-DD」「YYYY-MM-DDTHH:MM:SS+00:00」「YYYY-MM-DDTHH:MM:SSZ」「YYYY-MM-DDTHH:MM:SS」（例：2019-11-20T18:38:57） | はい |
<event name>.properties.<property name> |
複数 | カスタムイベントに関連するイベントプロパティ。例：trip_booked.properties.destination |
いいえ |
カスタムイベントのフォーマット要件
CSVを使用してカスタムイベントをインポートする場合、データインポートを成功させるために以下の要件に従ってファイルをフォーマットする必要があります。
カスタムイベントのフォーマットについて
各プロパティが正しいイベントにマッピングされるように、ドット記法を使用してカスタムイベントCSVを正しくフォーマットすることが重要です。フォーマットが正しくない場合、プロパティが欠落したり、特に1つのファイルに複数のイベントタイプが含まれている場合にインポートが失敗したりする可能性があります。
イベントプロパティにドット記法を使用する
ドット記法は、カスタムイベントとそのプロパティの階層関係を定義するために使用されます。このフォーマット規則により、各イベントの特定の属性を含む構造化されたイベントデータをインポートできます。
ドット記法の形式は次の構造に従います：event_name.properties.property_name
ドット記法は以下の順序で機能します。
- 最初にイベント名
- 次に
.properties.で、後続がイベントプロパティであることを示す - 最後に、特定のプロパティ名
例：
rented_movieというカスタムイベントにプロパティmovie_nameとgenreがある場合、CSVの列ヘッダーは次のようになります。
rented_movie.properties.movie_namerented_movie.properties.genre
この記法により、Brazeはrented_movieというカスタムイベントを作成し、そのイベントインスタンスにプロパティmovie_nameとgenreを付加します。
1行につき1イベント
CSVの各行は、1人のユーザーの1つのカスタムイベントを表します。ユーザーに複数のイベントがある場合、同じユーザー識別子を共有していても、各イベントに対して別々の行を含める必要があります。
行に特定のイベントのデータが含まれている場合、そのイベントのプロパティの列のみを入力してください。他のイベントの列は空白のままにしてください。
CSVの構造例
以下の表は、プロパティを持つカスタムイベントをインポートするための正しいフォーマットを示しています。この例では、2人のユーザーがそれぞれ異なるイベントを実行しています。1人は映画をレンタルし、もう1人は映画を購入しました。
| external_id | name | time | rented_movie.properties.movie_name | rented_movie.properties.genre | bought_movie.properties.movie_name | bought_movie.properties.genre |
|---|---|---|---|---|---|---|
| 123 | rented_movie | 2024-06-10T12:00:00Z | Ghostbusters | Action | ||
| 456 | bought_movie | 2024-06-12T12:00:00Z | Ghostbusters | Action |
この例では：
- ユーザー
123がプロパティmovie_name（Ghostbusters）とgenre（Action）を持つrented_movieイベントをトリガーしました - ユーザー
456がプロパティmovie_name（Ghostbusters）とgenre（Action）を持つbought_movieイベントをトリガーしました - 各イベントは関連するプロパティ列のみを入力し、他のイベントプロパティ列は空白のままにしています
ステップ4:ファイルをアップロードする
ファイルをアップロードするには、AttributesまたはEventsを選択し、Browse FilesをクリックしてCSVをアップロードします。Brazeは最初の数行のプレビューと検出されたフィールドの概要を表示します。
大きなファイル（デフォルト属性とカスタム属性は最大500 MB、カスタムイベントは最大50 MB）の場合、ファイルのアップロードとBrazeによるインポートの計算中にダッシュボードが一時的に応答しなくなることがあります。これらのアップロードと計算は、小さなファイルよりも完了に時間がかかる場合があります。このステップが完了するまでお待ちください。ファイルの制限とタイミングの詳細については、CSVの構築を参照してください。
Import nameフィールドで、インポートの名前を変更できます。デフォルトではファイル名が使用されます。
ファイルプレビューにはファイルの最初の数行のみが表示されます。インポート前にすべての行を確認するには、ファイル検証を使用してください。
ステップ5:フィールドをマッピングする（属性の場合）
プレビューの後、CSVヘッダーをBraze属性にマッピングできます。Brazeは、CSVファイル内のフィールドを同じ名前の属性に自動的にマッピングし、必要に応じて新しい属性を作成します。また、任意の列に対して手動で提案を調整したり、別の属性を選択したりする柔軟性もあります。
マッピングステータス
マッピングステータス列は、CSVファイルがインポートされたときに発生するアクションを示し、以下のいずれかになります。
| マッピングステータス | 意味 |
|---|---|
| マッピング済み | フィールドが既存の属性または識別子にマッピングされました。 |
| 新しい属性 | Brazeがインポート時に新しい属性を作成します。Edit new attributeボタンを選択してこの属性を編集できます。 |
| データタイプの不一致 | CSV列の検出されたデータタイプが、既存の属性または識別子のデータタイプと一致しません。Brazeはインポート時に既存の属性に合わせてデータタイプの変換を試みます。変換できない場合、値は破棄されます。 |
| ブロックリスト属性 | CSVフィールドがブロックリストに登録された属性の名前と一致しています。マッピングする別の属性を選択するか、その列はインポートされません。 |
| 重複属性 | CSVファイルに同じ名前のフィールドが1つ以上あります。同名の列を異なる属性にマッピングするか、最初の列のみがインポートされます。 |
新しい属性の編集
ワークスペースに一致する属性が存在しない場合、BrazeはCSVフィールドの名前と検出されたデータタイプを使用して、インポート時に新しい属性の作成を試みます。マッピングステータスの横にあるEdit new attributeボタンを選択して、インポート前にこの新しい属性を編集できます。
識別子がマッピングされるまで、マッピングステップを先に進めることはできません。Brazeは可能な場合、識別子を自動的にマッピングします。識別子がマッピングされているかどうかは、Required fieldsセクションを参照してください。
ステップ6:ターゲティング設定を選択する
マッピング後、インポート設定ページで以下のターゲティング設定から選択できます。インポートから新しいターゲティングフィルターやSegmentを作成する必要がない場合は、Do not make this list available as a targeting filterを選択してください。
| オプション | 説明 |
|---|---|
| ターゲティングフィルター | CSVファイルをユーザーSegment作成時のリターゲティングオプションに変換するには、Updated/Imported from CSVドロップダウンからファイルを選択し、Create targeting filterを選択します。 |
| 新しいSegment | 新しいターゲティングフィルターから新しいSegmentも作成するには、Create targeting filter and add to new segmentを選択します。 |
ステップ7:ファイルを検証する（オプション）
インポートを開始する前に、ファイル検証を実行してすべての行のエラーと警告を確認できます。ファイルを検証するには、インポート設定ページでValidate file before importingを選択し、Nextを選択します。
検証は最大許容サイズのファイルで最大2分かかる場合があります。検証の実行中に、Skip validationを選択して検証をバイパスし、すぐに進めることもできます。
検証結果
検証が完了すると、以下のいずれかの結果が表示されます。
| 結果 | 意味 | 次のステップ |
|---|---|---|
| 検証完了 | 問題は見つかりませんでした。 | Import dataを選択します。 |
| 問題が見つかりました | 一部の行にエラーまたは警告があります。 | エラーレポートをダウンロードして確認し、Import anywayを選択して続行するか、Cancelを選択してファイルを先に修正します。 |
| 検証がタイムアウトしました | 検証の時間が切れました。確認された行には問題がありませんでした。 | Import dataを選択します。完全なレポートは数分後に利用可能になります。 |
| 問題ありで検証がタイムアウトしました | 検証の時間が切れ、確認された行の一部にエラーが見つかりました。 | 部分的なレポートをダウンロードして確認し、Import anywayまたはCancelを選択します。 |
エラーレポートについて
エラーレポートは、フラグが付けられたすべての行とその元のデータ、および問題の説明を含むCSVファイルです。
| 問題タイプ | 説明 |
|---|---|
| エラー | インポート中にその行は完全にスキップされます。 |
| 警告 | その行はインポートされますが、一部の値は破棄されます。 |
レポートを確認した後、元のファイルの問題を修正して再アップロードするか、インポートを続行して部分的な結果を受け入れることができます。
ステップ8:CSVインポートを開始する
準備ができたら、Start Importを選択します。Import Usersページで現在の進捗状況を追跡できます。このページは5秒ごとに自動更新されます。 処理はCSVのサイズに応じて数分から数時間かかる場合があります。この間、ダッシュボードが応答しなくなったり、応答が遅くなったりすることがありますが、インポートは引き続き実行されています。
同時に複数のCSVをインポートできます。CSVインポートは並行して実行されるため、更新の順序がシリアルであることは保証されません。CSVインポートを順番に実行する必要がある場合は、CSVインポートが完了してから2番目のCSVをアップロードしてください。
インポートステータス
インポートを開始した後、Import Usersページでステータスを確認できます。
| ステータス | 説明 |
|---|---|
| 完了 | すべての行が正常にインポートされました。 |
| 一部成功 | 一部の行が失敗しました。インポートの横にある三点メニューを選択して、エラーレポートまたはアップロードされた元のCSVをダウンロードします。 |
| 処理中 | インポートは現在実行中です。 |
インポート後のエラーレポートには、検証ではカバーされない理由で失敗した行が含まれます。例えば、Brazeにユーザーが存在しない場合などです。
以前にアップロードされたCSVファイルは、アップロード日から14日間、Import Usersページからダウンロードできます。14日後、ファイルは完全に削除され、アクセスできなくなります。
データポイントに関する考慮事項
CSVファイルからインポートされた各顧客データは、ユーザープロファイルの既存の値を上書きし、データポイントとして記録されます。ただし、external IDと空白の値は除きます。Brazeのデータポイントの詳細について質問がある場合は、Brazeアカウントマネージャーにお問い合わせください。
| 考慮事項 | 詳細 |
|---|---|
| External ID | external_idのみを含むCSVをアップロードしても、データポイントは記録されません。これにより、データ制限に影響を与えることなく、既存のBrazeユーザーをセグメント化できます。ただし、emailやphoneなどのフィールドを含めると、既存のユーザーデータが上書きされ、データポイントが記録されます。external_id、braze_id、またはuser_alias_nameのみを含むセグメンテーション目的のCSVインポートでは、データポイントは記録されません。 |
| 空白の値 | CSVの空白の値は、既存のユーザープロファイルデータを上書きしません。インポート時にすべてのユーザー属性やカスタムイベントを含める必要はありません。 |
| サブスクリプション状態 | email_subscribe、push_subscribe、subscription_group_id、またはsubscription_stateの更新は、データポイント使用量にカウントされません。 |
CSVインポートまたはAPIを通じてユーザーにlanguageまたはcountryを設定すると、BrazeはSDKを通じてこの情報を自動的にキャプチャしなくなります。
トラブルシューティング
ファイル検証を使用した場合は、エラーレポートから始めてください。フラグが付けられた各行の具体的な問題と修正方法の説明が含まれています。検証ではなくインポート中に失敗した行については、Import Usersページで行にカーソルを合わせ、ボタンを選択してエラーレポートをダウンロードしてください。
CSVインポートのトラブルシューティングについては、以下の一般的な問題を確認してください。
CSVインポートがSegmentフィルターとして利用できない
CSVインポートをSegmentフィルターとして使用できるのは、アップロード時にターゲティング設定を有効にした場合のみです。
既存のインポートでターゲティングの利用可否が有効になっているかどうかを確認するには：
- Import Usersページで、CSVインポートを見つけます。
- そのインポートにGo to Segmentが表示されているかどうかを確認します。
- Go to Segmentが表示されている場合、CSVは
Updated/Imported from CSVのSegmentフィルターで利用可能です。 - Go to Segmentが表示されていない場合、そのインポートではターゲティングの利用可否が有効になっていません。
CSVアップロードの完了後にターゲティングの利用可否を有効にすることはできません。そのCSVをSegmentフィルターとして使用するには、ファイルを再アップロードし、ステップ6:ターゲティング設定を選択するでCreate targeting filterまたはCreate targeting filter and add to new segmentを選択してください。
プロファイルデータを更新せずにSegmentを作成することが目的の場合は、識別子列のみ（例：external_idまたはエイリアス識別子列）を含むCSVをアップロードし、Create targeting filter and add to new segmentを選択してください。
ファイルフォーマットの問題
不正な行
アップロードがエラーで完了した場合、CSVファイルに不正な行がある可能性があります。
データを正しくインポートするには、ヘッダー行が必要です。各行はヘッダー行と同じ数のセルを持つ必要があります。ヘッダー行よりも値が多いまたは少ない行はインポートから除外されます。値内のカンマは区切り文字として解釈され、このエラーの原因となる可能性があります。また、すべてのデータはUTF-8エンコードである必要があります。
CSVファイルに空白行があり、CSVファイルの合計行数よりも少ない行数がインポートされた場合、空白行はインポートする必要がないため、インポートに問題があるとは限りません。正しくインポートされた行数を確認し、インポートしようとしているユーザー数と一致していることを確認してください。
行の欠落
インポートされたユーザー数がCSVファイルの合計行数と一致しない理由はいくつかあります。
| 問題 | 解決方法 |
|---|---|
| external ID、ユーザーエイリアス、Braze ID、メールアドレス、または電話番号の重複 | external IDの列に重複がある場合、行が正しくフォーマットされていても、不正な行やインポートされない行が発生する可能性があります。場合によっては、特定のエラーが報告されないこともあります。重複を確認し、再アップロード前に削除してください。 |
| アクセント付き文字 | CSVにアクセント付きの名前や属性が含まれている場合があります。インポートの問題を防ぐため、ファイルがUTF-8エンコードであることを確認してください。 |
| Braze IDが孤立したユーザーに属している | ユーザーが別のユーザーにマージされ、BrazeがそのBraze IDを残りのプロファイルに関連付けられない場合、その行はインポートされません。 |
| 空の行 | CSVの空白行は不正なデータエラーの原因となる可能性があります。ExcelやSheetsではなく、プレーンテキストエディターを使用して確認してください。 |
エスケープされていないまたは不均衡な二重引用符（"） |
二重引用符はカンマを含む文字列値を囲みます。値自体に二重引用符が含まれている場合は、二重にしてエスケープしてください（""）。エスケープされていないまたは不均衡な二重引用符は不正な行の原因となります。 |
| 一貫性のない改行 | 混在する改行（例：\nと\r\n）により、データの最初の行がヘッダーの一部として扱われる場合があります。16進数エディターまたは高度なテキストエディターを使用して検査・修正してください。 |
| 不正にエンコードされたファイル | アクセントは許可されていますが、ファイルはUTF-8エンコードである必要があります。他のエンコーディングは部分的に機能する場合がありますが、完全にはサポートされていません。 |
文字列の引用符
シングルクォート（''）またはダブルクォート（""）で囲まれた値は、インポート時に文字列として読み取られます。
不正なフォーマットの日付
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ファイルでは、受け付けられる値がunsubscribed、subscribed、opted_inであるため、最初の行のユーザー（brazetest1）のみがメールとプッシュのステータスを正常に更新されます。
1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed
「Select CSV File」が機能しない
Select CSV Fileボタンが機能しない理由はいくつかあります。
| 問題 | 解決方法 |
|---|---|
| ポップアップブロッカー | ページの表示が妨げられている可能性があります。ブラウザがBrazeダッシュボードのWebサイトでポップアップを許可していることを確認してください。 |
| 古いブラウザ | ブラウザが最新であることを確認してください。最新でない場合は、最新バージョンに更新してください。 |
| バックグラウンドプロセス | すべてのブラウザインスタンスを閉じてから、コンピューターを再起動してください。 |