Skip to content

ユーザーインポート

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

CSV のアップロードが完了しましたが、ある列でデータ型が混在しているエラーが発生しました

アップロードしたファイルに問題がないことを確認したら、インポートを開始します。ポップアップが閉じ、バックグラウンドでインポートが開始されます。[ユーザーインポート] ページで進捗状況を確認できます。進捗状況は 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からユーザーデータをエクスポートし、既存のユーザーに新しいカスタム属性を追加したい場合に役立ちます。

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

ヘッダーがデフォルトのユーザーデータと完全に一致しない場合、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 (購読グループに含まれる) です。
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

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

インポートの開始前に、[この CSV からインポートされたユーザーからセグメントを自動生成する] を選択することで、ユーザーインポートを使用してセグメントを作成することもできます。

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

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

考慮事項

トラブルシューティング

行の欠落

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

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

正しくない形式の行

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

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

複数のデータ型

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

正しくない形式の日付

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

文字列の引用符

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

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

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

Github   GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!