ユーザープロファイル

ユーザープロファイルは、特定のユーザーに関する情報を確認するのに最適な方法です。ユーザーに関連するすべての永続データは、そのユーザーのプロファイルに保存されます。

プロファイルへのアクセス

ユーザーのプロファイルにアクセスするには、ユーザー検索ページに移動し、以下のいずれかでユーザーを検索します。

• 外部ユーザー ID
• Braze ID
• メール
• 電話番号
• プッシュトークン
• “[user_alias]:[alias_name]” 形式のユーザーエイリアス（例: “amplitude_id:user_123”）

一致するものが見つかった場合、Braze SDKで記録されたこのユーザーの情報を確認できます。検索で複数のユーザープロファイルが返された場合は、各プロファイルを個別にマージするか、一括ユーザーマージを実行できます。詳しい手順については、重複ユーザーのマージを参照してください。

ユースケース

ユーザープロファイルは、ユーザーのエンゲージメント履歴、セグメントメンバーシップ、デバイス、オペレーティングシステムに関する情報に簡単にアクセスできるため、トラブルシューティングやテストに役立つリソースです。

たとえば、ユーザーが問題を報告し、使用しているデバイスやオペレーティングシステムがわからない場合、概要タブを使用してこの情報を確認できます（メールアドレスまたはユーザーIDがわかっている場合）。また、ユーザーの言語も確認できます。これは、期待どおりに動作しなかった多言語キャンペーンのトラブルシューティングに役立ちます。

エンゲージメントタブを使用して、特定のユーザーがキャンペーンを受信したかどうかを確認できます。さらに、そのユーザーがキャンペーンを受信していた場合、いつ受信したかを確認できます。また、ユーザーが特定のセグメントに含まれているかどうか、プッシュ、メール、またはその両方にオプトインしているかどうかも確認できます。この情報はトラブルシューティングに役立ちます。たとえば、ユーザーが受信するはずのキャンペーンを受信しなかった場合や、受信するはずではないキャンペーンを受信した場合に、この情報を確認してください。

ユーザープロファイルの要素

ユーザープロファイルには5つの主要なセクションがあります。

• 概要：ユーザーに関する基本情報、セッションデータ、カスタム属性、カスタムイベント、購入、およびユーザーが最後にログインしたデバイス。
• エンゲージメント：ユーザーの連絡先設定、受信したキャンペーン、セグメント、コミュニケーション統計、インストールアトリビューション、およびランダムバケット番号に関する情報。
• イベント履歴：過去30日間のカスタムイベントと購入。完全なイベントプロパティがJSONとして表示されます。
• メッセージング履歴：過去30日間のこのユーザーの最近のメッセージング関連イベント。
• フィーチャーフラグの対象条件：ロールアウト、キャンバスステップ、および実験全体で、ユーザーが現在どのフィーチャーフラグの対象であるかを検証します。

• 概要タブ
• エンゲージメントタブ
• イベント履歴タブ

受信したキャンペーンにキャンペーンが表示されるタイミング

一般的に、Brazeはメッセージの送信を試みた後に受信したキャンペーンにキャンペーンを表示します。ユーザーのデバイスや受信トレイへの配信は、送信が記録されるために必要ではありません。受信したキャンバスメッセージは、各キャンバスメッセージタイプに対して同じチャネル固有のルールに従います。

• メール： Brazeは、メッセージがメールサービスプロバイダー（ESP）に渡された時点で送信を記録します。ハンドオフ後、Liquidロジック、レート制限、またはユーザーが到達不能とマークされたことによるメッセージの中止は行われません。次のイベントは通常、配信またはバウンスです。
• プッシュ： Brazeは、メッセージがプッシュプロバイダー（Apple Push Notification service（APNs）やFirebase Cloud Messaging（FCM）など）に渡された時点で送信を記録します。プロバイダーは通常、即座に配信を試みます。デバイスが利用できない場合（オフラインなど）、プロバイダーはメッセージの有効期限が切れるまでリトライすることがあります。
• アプリ内メッセージ： Brazeは、キャンペーンが開始された時点で送信を記録します。
• Content Cards： Brazeが_送信_イベントを記録するタイミングは、配信タイプとカード作成設定によって異なります。Content Cardsのキャンペーンは、ユーザーがアプリでカードを表示した後にのみ、ユーザープロファイルの受信したキャンペーンに表示されます。詳細については、Content Cardsレポートの記事の送信が記録されるタイミングおよび受信したキャンペーンとリターゲティングフィルターを参照してください。
• SMS、WhatsApp、およびwebhook： Brazeは、メッセージがそのチャネルの配信パス（SMSまたはWhatsAppプロバイダー、またはwebhookエンドポイントなど）に入った時点で送信を記録します。

メッセージング履歴タブ

ユーザープロファイルのメッセージ履歴タブには、過去30日間の個々のユーザーの最近のメッセージング関連イベント（約40件）が表示されます。これらのイベントには、ユーザーに送信されたメッセージ、受信されたメッセージ、インタラクションが行われたメッセージなどが含まれます。

このタブのデータは、ユーザーがマージされた後は更新されません。また、API経由で送信されたメッセージ（たとえば、/messages/sendエンドポイント）に関連するイベントは、それらの送信でキャンペーンIDが指定されていない場合、このタブに表示されません。

イベントの表示と理解

メッセージング履歴テーブルの各イベントについて、メッセージングチャネル、イベントタイプ、イベントが発生したタイムスタンプ、関連するキャンペーンまたはキャンバスメッセージ、およびユーザーのデバイスデータを確認できます。特定のイベントをフィルタリングするには、フィルターをクリックし、リストからイベントを選択します。

メッセージエンゲージメントイベント

メール、SMS、プッシュ、アプリ内メッセージ、Content Cards、およびwebhookでは、以下のメッセージエンゲージメントイベントを利用できます。特定のイベントのトラッキング方法の詳細については、メッセージエンゲージメントイベント用語集を参照してください。

チャネル	利用可能なエンゲージメントイベント
メール	バウンス クリック 遅延イベント 配信 スパムとしてマーク 開封（メール開封イベントに関する注意を参照） 送信 ソフトバウンス 購読解除
SMS	キャリア送信 配信 配信失敗 受信 拒否 送信
プッシュ	バウンス 影響を受けた開封 iOSフォアグラウンド 開封 送信
アプリ内メッセージ	クリック インプレッション
Content Cards	クリック 閉じる インプレッション 送信
webhook	送信
WhatsApp	中止 配信 失敗 フリークエンシーキャップ 受信 既読 送信

メッセージ中止イベント

メッセージ中止イベントは、ユーザーに送信されたメッセージがLiquidまたはConnected Contentの条件ロジック、またはLiquidレンダリングのタイムアウトにより中止された場合に発生します。

中止イベントは以下のチャネルで利用できます：

• メール
• SMS
• プッシュ
• webhook

中止イベントは現在、アプリ内メッセージとContent Cardsでは利用できません。

フリークエンシーキャップイベント

フリークエンシーキャップイベントは、ユーザーがメッセージの受信対象となったものの、フリークエンシーキャップ設定により実際にはメッセージを受信しなかった場合に発生します。フリークエンシーキャップ設定は、設定 > フリークエンシーキャップルールからカスタマイズできます。

空白の送信先

一部のメッセージ送信は、メッセージング履歴で送信先が空白（「—」で示される）として表示される場合があります。これは、Content Cardsやwebhookなどの一部のチャネルが、メッセージ送信時にデバイスデータを収集しないためです。

Content Cardsの送信は、カードが表示可能になった時点で記録されます。Content Cardsは複数のデバイスで表示できるため、送信時にデバイスデータは記録されません。代わりに、この情報はインプレッション時（カードが実際に表示された時点）に記録されます。webhookはシステムエンドポイント（デバイスではない）に送信されるため、デバイスデータは適用されません。

メール開封イベントに関する注意

メール開封のトラッキングは、Brazeを含むどのツールでも誤りが生じやすいものです。さまざまなメールクライアントが提供するプライバシー保護機能により、画像の自動読み込みをブロックしたり、サーバー上で事前に読み込んだりするため、メール開封イベントは偽陽性と偽陰性の両方が発生しやすくなっています。

メール開封の統計は集計レベルで（たとえば、異なる件名の効果を比較する場合に）役立ちますが、個々のユーザーの個別の開封イベントが意味のあるものだと想定すべきではありません。

メッセージ履歴タブで特定のフィールドが空白なのはなぜですか？

以下のシナリオでは、ユーザーのメッセージ履歴タブで一部のフィールドが空白になる場合があります：

• イベントの送信済みメッセージのデータが欠落している場合、そのキャンペーンにメッセージバリエーションがないことを示します。
• イベントのキャンペーン/キャンバスと送信済みメッセージのデータが欠落している場合、このメッセージがcampaign_idとmessage_variation_idを指定していないAPIキャンペーン（APIトリガーキャンペーンではない）から送信されたことを示します。これらのフィールドはオプションであり、リクエストボディから省略される場合があります。これらのフィールドが指定されている場合、その情報はメッセージ履歴ログに反映されます。
  • 特定のメッセージがメッセージング履歴にないが、受信したキャンペーンログに表示される場合、そのユーザーは現在のユーザーとして識別される前にキャンペーンを受信した可能性があります。既存のプロファイルが孤立した場合、受信したキャンペーンログは転送されますが、メッセージング履歴は転送されません。
• キャンペーン/キャンバスのデータが欠落している場合、手動テストが送信された可能性があります。手動テストはメッセージング履歴タブに記録されますが、送信されたキャンペーンまたはキャンバスは記録されません。
• ユーザーがシードグループまたはその他の内部テストオーディエンスに含まれている場合、メッセージング履歴には本番送信と比較して、限定的なキャンペーンまたはキャンバスのメタデータが表示される場合があります。

データサイズの制約

Brazeは、ユーザープロファイルの合計サイズに対して全体的な容量制限を設けていません。ただし、ユーザーに関連付けられた特定のデータ型には、定義されたサイズ容量があります。

カスタム属性配列

カスタム属性配列（オブジェクトの配列を含む）の容量は100 KBです。この容量を超える配列を送信した場合、そのカスタム属性は処理されません。APIは成功レスポンス（201）を返しますが、配列はユーザープロファイルに表示されず、その属性の既存データも更新されません。

配列がこの容量に近づいている場合は、合計サイズを100 KB以内に収めるために、入力するオブジェクトの数を制限することを検討してください。

カスタム属性の詳細については、カスタム属性のデータ型を参照してください。

関連記事

• ユーザープロファイルのライフサイクル
• POST:識別子によるユーザープロファイルのエクスポート
• POST:ユーザーの削除