ユーザーインポート

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

REST API

を使用して、/users/track` endpoint]12 to record custom events, user attributes, and purchases for users.ができます。

クラウドデータ取り込み

Braze のクラウドデータ取り込みを使用して、ユーザー属性のインポートと管理ができます。

CSV

[オーディエンス] > [ユーザーのインポート] から、CSV ファイル経由でユーザープロファイルのアップロードと更新もできます。

この機能は、靴のサイズなどのカスタム属性に加えて、名やメールアドレスなどのユーザー属性の記録と更新をサポートしています。CSV インポートを行うときに、external_id を使用する、またはユーザーエイリアスを使用するという 2 とおりの方法があります。

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

顧客データをインポートする場合、各顧客の一意の識別子 (external_id とも呼ばれる) を指定する必要があります。CSV インポートの開始前に、Braze によるユーザーの識別方法を開発チームから聞いて理解しておくことが重要です。一般的に、これは内部で使用されるデータベース ID です。これは、モバイルと Web で Braze SDK がユーザーを識別する方法と一致する必要があり、各顧客がデバイスを問わず Braze 内で単一のユーザープロファイルを持つように設計されています。詳細については、Brazeの「ユーザープロファイルのライフサイクル」を参照してください。

インポートで 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 を使用してインポートされた各顧客データは、ユーザープロファイルの既存の値を上書きし、external ID および空白の値を除き、1 データポイントとしてカウントされます。

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

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

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

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

ユーザーインポートでは、以下のデータ型が受け入れられます。 - 日時 (ISO-8601 形式で保存する必要がある) - ブール値 (TRUE/FALSE) - 数値 (整数または浮動小数点数。スペースやコンマは使用しない。浮動小数点数の小数点にはピリオド (.) を使用する) - 文字列 (列の値を二重引用符で囲む場合にのみ、コンマを使用できる) - 空白 (空白の値は、ユーザープロファイルの既存の値を上書きしないため、CSV ファイルに既存のすべてのユーザー属性を含める必要はない)

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

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

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

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

CSV のインポート

CSV ファイルをインポートするには、[ユーザーインポート] ページの [ユーザー] セクションに移動します。下側のテキストボックス [最近のインポート] には、最近の最大 20 件のインポート、そのファイル名、ファイル内の行数、インポートに成功した行数、各ファイルの合計行数、各インポートのステータスを示すテーブルがあります。

上側のボックス [CSV をインポート] には、インポートの指示と、インポートを開始するためのボタンがあります。[CSV ファイルを選択] をクリックし、目的のファイルを選択して [アップロードを開始] をクリックします。Braze によりファイルがアップロードされ、列ヘッダー、および各列のデータ型がチェックされます。

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

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

同時に複数の CSV をインポートできます。CSV インポートは同時に実行されるため、順番どおりに更新が行われるとは限りません。CSV インポートを順次実行する必要がある場合は、1 つのCSV インポートが完了するまで待ってから、次の CSV インポートをアップロードする必要があります。

アップロード中に Braze がファイル内で誤った形式を検出した場合、これらのエラーは要約とともに表示されます。例えば、ファイルに誤った形式の行が含まれている場合、ファイルをインポートするときにこのエラーがプレビューに表示されます。そのため、エラーがあってもファイルをインポートできますが、インポートの開始後にキャンセルしたりロールバックしたりすることはできません。プレビューを確認し、エラーが表示された場合は、インポートをキャンセルしてファイルを修正してください。プレビューの段階で Braze は入力ファイルの各行をスキャンしていないため、アップロードの前に CSV ファイル全体を調べることが重要です。つまり、Braze がこのプレビューを生成するときに、検出していないエラーが存在する可能性があります。

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

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

[処理した行数] の下に、インポートの進捗状況が表示されます。インポートが完了すると、ステータスが [完了] に変化します。インポート中も Braze ダッシュボードの他の機能を使用でき、インポートの開始と終了時に通知を受け取ります。

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

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

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

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

セグメンテーション

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

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

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

HTML データのストリップ

Braze では、取り込み時に HTML データをサニタイズしません。Braze にデータをインポートする場合、特に Web ブラウザーでのパーソナライゼーションを目的としている場合は、Web ブラウザーのレンダリング時に悪意を持って利用される可能性のある HTML、JavaScript、その他のスクリプトタグを必ず除去してください。

別の方法として、HTML の場合は、Braze の Liquid フィルター (strip_html) を HTML のエスケープ付きテキストに使用できます。以下に例を示します。

• input
• output

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

1
Have you read Ulysses?

トラブルシューティング

行の欠落

インポートされたユーザー数が 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 はユーザープロファイルの [名] フィールドに正しくインポートされます。