ユーザーインポート

Braze には、次のようにユーザーデータをプラットフォームにインポートするさまざまな方法が用意されています。SDK、API、クラウドデータ取り込み、テクノロジーパートナー連携、CSV。

先に進む前に、Brazeはインポート時にHTMLデータをサニタイズ（検証または適切なフォーマット）しないことに注意すること。つまり、Web のパーソナライゼーション用にインポートしたすべてのデータから、スクリプトタグを取り除く必要があります。

ウェブブラウザでのパーソナライズ使用を特に意図したデータをBrazeにインポートする場合は、ウェブブラウザでレンダリングされたときに悪意を持って利用される可能性のあるHTML、JavaScript、その他のスクリプトタグが取り除かれていることを確認すること。

HTMLの場合は、Braze Liquidフィルタ(strip_html)を使って、レンダリングされたテキストをHTMLエスケープすることもできる。以下に例を示します。

• インプット
• 出力

1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

1
Have you read Ulysses?

REST API

/users/track エンドポイント]12 を使って、ユーザーのカスタム・イベント、ユーザー属性、購入を記録することができる。

クラウドデータ取り込み

Brazeの[Cloud Data Ingestion][14] ]を使って、ユーザー属性をインポートし、管理することができる。

CSV インポート

Audience>Import Users（ オーディエンス>ユーザーのインポート）からCSVファイルをアップロードして、ユーザー・プロフィールを更新することもできる。

この機能は、靴のサイズなどのカスタム属性に加えて、名やメールアドレスなどのユーザー属性の記録と更新をサポートしています。external_id 、またはユーザー・エイリアスの2つの一意のユーザー識別子のいずれかを指定することで、CSVをインポートできる。

external ID を使用するインポート

顧客データをインポートする場合、各顧客の一意の識別子 (external_id とも呼ばれる) を指定する必要があります。CSVインポートを開始する前に、Brazeでユーザーをどのように識別するかをエンジニアリングチームから理解しておくことが重要である。通常、これは内部データベースIDである。これは、モバイルとウェブでBraze SDKがユーザーを識別する方法と一致するはずであり、各顧客がデバイスを問わずBraze内で単一のユーザープロファイルを持つように設計されている。Braze [ユーザープロファイルのライフサイクル]][13] についてもっと読む。

インポートで external_id を指定すると、Braze は、同じ external_id を持つ既存のユーザーを更新します。external_id が見つからない場合は、その external_id を持つ新規ユーザーを作成します。

ダウンロード: [CSV インポートのテンプレート][テンプレート］

ユーザーエイリアスを使用するインポート

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 によるエイリアスインポートのテンプレート][template_alias］

Braze ID を使用するインポート

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

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

CSV の作成

Braze にはいくつかのデータ型があります。CSV ファイルを使用してユーザ プロファイルをインポートまたは更新する場合、デフォルト のユーザ属性またはカスタム属性を作成または更新することができる。

• デフォルトのユーザー属性は Braze の予約キーです。first_name、email などがあります。
• カスタム属性は、お客様のビジネスに合わせてカスタマイズされます。例えば、旅行予約アプリには、last_destination_searched というカスタム属性を作成できます。

Braze は、最大 500 MB のファイルから標準 CSV 形式のユーザーデータを受け入れます。ダウンロード可能な CSV テンプレートについては、インポートに関する前述のセクションを参照してください。

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

CSVファイルからインポートされた各顧客データは、外部IDと空白の値を除き、ユーザープロファイル上の既存の値を上書きし、データポイントとしてカウントされる。

• CSVファイルからアップロードされた外部IDはデータポイントを消費しない。既存の Braze ユーザーのセグメンテーションを行うために、external ID のみを CSV でアップロードする場合、データポイントを消費せずに実行できます。インポート時にユーザーのEメールや電話番号などのデータを追加すると、既存のユーザーデータが上書きされ、データポイントが消費されてしまう。
  • セグメンテーション目的のCSVインポート（external_id 、braze_id 、user_alias_name を唯一のフィールドとしてインポート）は、データポイントを消費しない。
• 空白の値はユーザープロファイルの既存の値を上書きしないため、CSV ファイルに既存のすべてのユーザー属性を含める必要はありません。
• email_subscribe、push_subscribe、subscription_group_id、または subscription_state を更新しても、データポイントは消費されません。

デフォルトのユーザーデータ列のヘッダー

カスタムデータのインポート

ヘッダーがデフォルトのユーザーデータと完全に一致しない場合、Braze にカスタム属性が作成されます。

ユーザーインポートでは、以下のデータ型が受け入れられます。

• Datetime（ISO-8601形式で保存すること。）
• ブール値（TRUE/FALSE）
• 数値（整数または浮動小数点数で、スペースやカンマは使用しない、浮動小数点数の区切りにはピリオド（.）
• 文字列（カラム値をダブルクォーテーションで囲む限り、カンマを含むことができる）
• 空白(空白の値は、ユーザ・プロファイル上の既存の値を上書きしないため、CSVファイルに既存のすべてのユーザ属性を含める必要はない)

サブスクリプショングループのステータスの更新

ユーザーのインポートにより、EメールまたはSMS購読グループにユーザーを追加できる。SMSチャンネルでメッセージを送るには、ユーザーがSMS購読グループに登録されていなければならないからである。詳細については、SMS サブスクリプショングループを参照してください。

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

• subscription_group_id: サブスクリプショングループの id。
• subscription_state:利用可能な値は、unsubscribed （サブスクリプション・グループ内ではない）またはsubscribed （サブスクリプション・グループ内）である。

CSV のインポート

CSVファイルをインポートするには、AudiencesセクションのUser Importページに行く。ここには、アップロード日、アップローダー名、ファイル名、ターゲット可用性、インポートされた行数、各インポートのステータスなどの詳細を含む、最新のインポートを一覧表示するテーブルがある。

Browse Filesを選択し、ファイルを選択する。Brazeはあなたのファイルをアップロードし、カラムヘッダーと各カラムのデータ型をチェックする。

CSV テンプレートをダウンロードする場合は、このページの「external ID を使用するインポート」または「ユーザーエイリアスを使用するインポート」のセクションを参照してください。

アップロードが完了すると、ファイルの内容をプレビューするモーダルが表示される。このテーブルのすべての情報は、CSV ファイルの最上部の数行の値に基づきます。列ヘッダーの場合、標準属性は通常のテキストで書かれ、カスタム属性はイタリック体で書かれ、そのタイプは括弧で示される。ポップアップの上部にはファイルの概要も表示される。

同時に複数の CSV をインポートできます。CSVインポートは同時に実行されるため、更新の順序が連続であることは保証されない。CSVインポートを次々に実行する必要がある場合は、CSVインポートが終了するまで待ってから、2つ目のCSVインポートをアップロードする。

Brazeがアップロード中にファイルに不正な形があることに気づいた場合、これらのエラーはサマリーとともに表示される。例えば、ファイルに不正な行が含まれている場合、ファイルをインポートする際にそのエラーがプレビューに表示される。そのため、エラーがあってもファイルをインポートできますが、インポートの開始後にキャンセルしたりロールバックしたりすることはできません。プレビューを確認し、エラーが表示された場合は、インポートをキャンセルしてファイルを修正してください。

形式が正しくない行や external ID のない行はインポートされません。その他すべてのエラーはインポートできますが、セグメント作成時のフィルター処理が困難になる可能性があります。詳細については、「トラブルシューティング」セクションを参照してください。

アップロードしたファイルに問題がないことを確認したら、インポートを開始します。ポップアップが閉じ、バックグラウンドでインポートが開始されます。その進捗状況は、5秒ごとに更新される「ユーザーインポート」ページ、または「最近のインポート」ボックスの更新ボタンを押すことで確認できる。

処理が完了すると、ステータスはCompleteに変わる。インポート中も Braze ダッシュボードの他の機能を使用でき、インポートの開始と終了時に通知を受け取ります。

インポート処理でエラーが発生した場合、ファイルの総行数の横に黄色の警告アイコンが表示される。アイコンの上にカーソルを置くと、特定の行が失敗した理由の詳細を見ることができる。インポートが完了すると、すべてのデータが既存のプロファイルに追加されるか、新規プロファイルが作成されます。

Lambda でのユーザー CSV インポート

弊社のサーバーレス S3 Lambda CSV インポートスクリプトを使用して、ユーザー属性をプラットフォームにアップロードできます。このソリューションはCSVアップローダーとして機能し、CSVをS3バケットにドロップすると、スクリプトがAPIを通じてアップロードする。

100万行のファイルの推定実行時間は約5分である。詳細については、「Braze へのユーザー属性 CSV のインポート」を参照してください。

セグメンテーション

ユーザーインポートではユーザープロファイルの作成と更新が行われますが、セグメントの作成にも使用できます。セグメントを作成するには、インポートの開始前に、[この CSV からインポートされたユーザーからセグメントを自動生成する] を選択します。

セグメント名を設定することも、デフォルト (ファイル名) をそのまま使用することもできます。セグメントの作成に使用されたファイルには、インポート完了後にセグメントを表示するためのリンクが表示されます。

セグメント作成に使用するフィルターにより、選択したインポートで作成された、または更新されたユーザーが選択されます。このフィルターは、[セグメントを編集] ページでその他すべてのフィルターとともに使用できます。

トラブルシューティング

行の欠落

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

• external ID の重複:external ID 列が重複している場合、行の形式が正しくても、インポートされた行の形式が変形したり、行がインポートされなかったりする可能性があります。場合によっては、具体的なエラーとして報告されないこともあります。CSV に重複した external ID がないか確認してください。ある場合は、重複を削除して再度アップロードを試してください。
• アクセント付きの文字:CSV 内の名前や属性に、アクセント付きの文字が含まれている可能性があります。問題を防ぐために、ファイルが UTF-8 でエンコードされていることを確認してください。

正しくない形式の行

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

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

複数のデータ型

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

正しくない形式の日付

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

文字列の引用符

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

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

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

/docs/ja/user_guide/data_and_analytics/user_data_collection/user_profile_lifecycle/ [14]: /docs/ja/user_guide/data_and_analytics/cloud_ingestion/ [errors]:#common-errors [template]: /docs/ja/assets/download_file/braze-user-import-template-csv.xlsx?3aafd0c03634ac03f248b3055fbc3126 [template_alias]: /docs/ja/assets/download_file/braze-user-import-alias-template-csv.xlsx?c0ce6c0aa1e901395161d87c5ba17747