ユーザーインポート

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

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

特に Web ブラウザーでのパーソナライゼーションを目的としているデータを Braze にインポートする場合、Web ブラウザーのレンダリング時に悪意を持って利用される可能性のある 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 エンドポイントを使用して、カスタムイベント、ユーザー属性、およびユーザーの購入を記録します。

クラウドデータ取り込み

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

CSV インポート

CSVファイルからオーディエンス > ユーザーのインポートを通じてユーザープロフィールをアップロードおよび更新できます。

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

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 を更新しても、データポイントは消費されません。

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

CSV のインポート

CSV ファイルをインポートするには、[オーディエンス] > [ユーザーをインポート] の順に移動します。ここには、最近のインポートがリストされた表があり、アップロード日、アップローダー名、ファイル名、ターゲティングの使用可能性、インポートされた行数、各インポートのステータスなどの詳細が表示されます。

[ファイルを参照] を選択し、ファイルを選択します。Braze によりファイルがアップロードされ、列ヘッダー、および各列のデータ型がチェックされます。

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

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

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

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

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

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

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

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

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

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

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 はそのID を持つ新しいプロファイルを作成します。このプロファイルを後で識別するには、/users/identify endpoint を使用できます。ユーザープロファイルを削除するには、/users/delete エンドポイントも使用できます。

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

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

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

• 日時:ISO-8601 形式で保存する必要があります
• Boolean: true または false
• 番号:整数または浮動小数点数にスペースやコンマを含めず、小数点の区切りにはピリオド (.) を使用する必要があります。
• 文字列:二重引用符 ("") で囲まれた列の値がある場合、コンマを含めることができます
• 空白:空白の値はユーザープロファイルの既存の値を上書きしないため、CSV ファイルに既存のすべてのユーザー属性を含める必要はありません。

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

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

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

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

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

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

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

ユーザーインポートからのターゲット変更フィルタの作成

ユーザーインポートを使用すると、[この CSV にユーザーをインポートし、この特定のユーザーのバッチをグループとしてリターゲティングできるようにする] を選択して、CSV ファイルをリターゲティングフィルターに変換できます。セグメント内のファイル、またはフィルタリングがオプションである場所でフィルタリングするには、「CSV から更新/インポート」フィルターを選択し、次にファイルの正確な名前を検索します。

ユーザーインポートからのセグメントの作成

ユーザーインポートを使用してセグメントを作成することもできます。これを行うには、[このCSVのユーザーをインポートし、この特定のユーザーのバッチをグループとしてリターゲティングできるようにする] を選択し、インポートを開始する前に [この CSV からインポートされたユーザーからセグメントを自動的に生成する] をオンにします。

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

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

考慮事項

トラブルシューティング

アップロードがエラーで完了

正しくない形式の行

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

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

無効なメールアドレス

ブレーズが無効な暗号化された電子メールアドレスを検出しました。Braze にインポートする前に、すべてのメールアドレスが適切に暗号化されていることを確認します。

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

行の欠落

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

• 重複する外部ID、ユーザエイリアス、ブレーズID、電子メールアドレス、または電話番号:external ID 列が重複している場合、行の形式が正しくても、インポートされた行の形式が変形したり、行がインポートされなかったりする可能性があります。場合によっては、特定のエラーが報告されないことがあります。CSV に重複した external ID がないか確認してください。ある場合は、重複を削除して再度アップロードを試してください。
• アクセント付きの文字:CSV 内の名前や属性に、アクセント付きの文字が含まれている可能性があります。問題を防ぐために、ファイルが UTF-8 でエンコードされていることを確認してください。
• Braze ID は孤立したユーザに属します。ユーザが孤立している場合、孤立がマージされた残りのユーザは、孤立しているユーザのBraze ID をプロファイルに関連付けることはできません。この場合、Braze は更新するユーザーを見つけないため、行はインポートされたものとしてカウントされません。
• 空行:CSV ファイルに空白行があります。これは、テキストエディタプログラムでCSV を開いた場合に確認できます(Excel やSheets を使用しないでください)。空の行でCSV をアップロードすると、不正な形式のデータを持つ行があることを示すエラーメッセージが表示されます。
• 二重引用符を含む("):この文字は無効で、行が不正形式になります。代わりに、一重引用符(') を使用します。
• 一貫性のない改行:たとえば、CSV ファイルが最初の行に\n を使用し、後続の各行に\r\n を使用する場合、データの最初の行はヘッダの一部として処理され、そのデータは期待どおりにインポートされません。これは、16進エディタまたは空白文字を区別する特殊なテキストエディタで確認できます。
• 不正にエンコードされたファイルCSV ファイルには、アクセントを持つ名前または属性を含めることができますが、ファイルを適切にインポートするには、UTF-8 にエンコードする必要があります。その他の文字エンコーディングは、場合によっては機能しますが、完全に互換性があるのはUTF-8 のみです。

正しくない形式の日付

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

文字列の引用符

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

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

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

複数のデータ型

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

また、0 で始まる数値は文字列とみなされるため、0 で始まる数値属性では問題が発生します。Braze がその文字列を変換するときは、8 進数値(0 から7 までの数字を使用) のように扱うことができます。つまり、それは対応する10 進数値に変換されます。たとえば、CSV ファイルの値が0130 の場合、ろう付けプロファイルには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

“Select CSV File” ボタンが動作しない

Select CSV Fileボタンが機能しない理由はいくつかあります。

• ポップアップブロッカー:これにより、ページが表示されない場合があります。ブラウザでBraze ダッシュボードWeb サイトのポップアップが許可されていることを確認します。
• 古いブラウザ:ブラウザが最新であることを確認します。最新でない場合は、最新バージョンに更新します。
• バックグラウンドプロセス:すべてのブラウザインスタンスを閉じ、コンピュータを再起動します。