よくある質問
このページでは、Currentsに関するよくある質問への回答を提供します。
特定の日付範囲でキャンペーンやキャンバスのデータをエクスポートできますか？
特定の日付範囲のキャンペーンやキャンバスの指標を取得するには、以下のいずれかの方法を使用してください。
- date-aligned campaign or Canvas exports for dashboard-style reporting outside standard API windowsにご興味がある場合は、製品フィードバックを送信してください。
- キャンペーン分析またはキャンバス分析エンドポイントを
ending_atとlengthパラメーターで呼び出します（または時系列データには/campaigns/data_seriesと/canvas/data_seriesを使用します）。 - 継続的にクエリ可能なメッセージエンゲージメントデータが必要な場合は、Currentsを使用して、Amazon S3、Azure Blob Storage、またはその他のサポートされている送信先にイベントをデータウェアハウスにストリーミングします。
ライブのCurrentsインテグレーションを編集するにはどうすればよいですか？
ライブのCurrentsコネクタを変更するには、インテグレーションを開き、編集を選択します。編集がない場合、インテグレーションUIは読み取り専用のままとなり、アイコンだけではコネクタの設定を変更できません。
アップロード後、BrazeはAzure Blob StorageのAvroファイルをどのように処理しますか？
Brazeは、アップロードが完了した後、Microsoft Azure Blob Storage内のAvroファイルを変更しません。Azureは、アップロードがまだ進行中の間、Blobの削除をブロックする場合があります。
過去のデータを取得するにはどうすればよいですか？
Currentsはリアルタイムのライブデータストリームであるため、イベントを再生することはできません。ただし、Amazon S3やMicrosoft Azure Blob StorageなどのデータウェアハウスにCurrentsデータを保存できるため、過去のイベントに対して必要に応じてアクションを実行できます。データは30日間保持されますが、より長期間の過去データについては、Snowflakeをクエリできます。
なぜCurrentsはJSON形式ではなくAvro形式でデータを出力するのですか？
スキーマレスのJSONとは異なり、Avroはスキーマの進化をネイティブにサポートしています。また、Avroは高い圧縮率を持つため、Avroファイルの送信に必要な帯域幅を削減し、ストレージスペースを節約できるというメリットもあります。
Brazeはファイルのオーバーヘッドをどのように処理しますか？
Brazeは、Extract, Transform, Load（ETL）プロセスを構築しています。これにより、大量のデータを1つのデータベースから抽出し、別のデータベースに配置・保存できます。
クエリ用のデータはどこに保存すべきですか？
Brazeは、クエリ用のデータを保存できる複数のデータウェアハウスと提携しています。以下の使用をお勧めします。
Currentsデータの信頼性はどの程度ですか？
Currentsは「少なくとも1回」の配信を保証しています。これは、重複イベントがストレージバケットに書き込まれる場合があることを意味します。ユースケースで厳密に1回だけの配信が必要な場合は、すべてのイベントとともに送信される一意の識別子フィールド（id）を使用してイベントの重複排除を行うことができます。詳細については、イベント配信セマンティクスを参照してください。
データはどのくらいの頻度でCurrentsに同期されますか？
データは継続的にストリーミングされます。Brazeは、送信すべきイベントのバッチが満杯になるか、5分が経過するか、いずれか早い方のタイミングでイベントのバッチを送信します。大量のコネクターの場合、データはほぼリアルタイムで到着します。少量のコネクターの場合、データの到着には5〜30分かかることが想定されます。詳細については、Avro書き込みしきい値を参照してください。
デバイスがインターネットに接続されていない場合、イベントの作成に遅延が生じることがあります。これは、アプリ内メッセージがオフラインでもトリガーされる可能性があるため、アプリ内メッセージイベントで最もよく発生します。
Currentsで利用可能なイベントを確認するにはどうすればよいですか？
Currentsが記録するイベントの完全なリストについては、顧客行動イベントおよびメッセージエンゲージメントイベント用語集を参照してください。これらの用語集は、イベントタイプ（送信、配信、開封など）でフィルタリングできます。
Currentsのイベント数がダッシュボードやEngagement Reportの指標と一致しないのはなぜですか？
Currentsとダッシュボードでは特定の指標の計算方法が異なるため、Currentsのイベントとダッシュボードの指標が完全に一致することは想定されていません。
ユニーククリック: メールの場合、ダッシュボードは7日間のユニーククリックを追跡し、dispatch_id 単位で計測します。Currentsは各クリックイベントをそのまま記録します。Currentsベースのユニーククリック数をダッシュボードの指標と揃えるには、is_unique が true であるイベントのみをフィルターしてください。
購読解除: ダッシュボードの購読解除指標は、Brazeの標準的な購読解除リンクのクリックを反映しています。カスタム購読解除ページでは、APIを通じてユーザーを更新しない限り、この指標はインクリメントされません。Currentsの users.messages.email.Unsubscribe イベントは、ユーザーがメール本文やフッター内の購読解除リンク、またはlist-unsubscribeヘッダーを通じてクリックした際に発生する、特殊なクリックイベントです。これはすべてのメール購読状態の変更を表すものではありません。
タイムスタンプとタイムゾーン: CurrentsのタイムスタンプはすべてUTCです。ダッシュボードの指標は、会社のタイムゾーンに基づいています。Currentsのデータを会社のタイムゾーンに変換せずにカレンダー日単位で集計すると、ダッシュボードに表示される日付とは異なる日付バケットにカウントが振り分けられる可能性があります。
重複イベント: Currentsは「少なくとも1回」の配信を保証しているため、重複イベントが発生することがあります。ダッシュボードの指標と比較する前に、各イベントの一意の id フィールドを使用して重複を排除してください。
Currentsのメール開封またはクリックイベントのexternal_user_id（Brazeスキーマ：external_id）がBrazeダッシュボードのユーザープロファイルと異なるのはなぜですか？
- Brazeダッシュボードの場合： あるメールアドレスに関連付けられたユーザーがメールを開封またはクリックすると、そのメールアドレスを共有するすべてのユーザープロファイルに開封またはクリックが記録されます。詳細については、メールが送信されたとき、複数のプロファイルが同じメールアドレスを持っている場合はどうなりますか？を参照してください。
- Currentsの場合： 同じ開封またはクリックは1つのプロファイルに保存されます。Brazeは、送信時に元々ターゲットとされたプロファイルがそのメールアドレスをまだ共有している場合、そのプロファイルに帰属させます。それ以外の場合、Brazeはそのメールアドレスを共有するプロファイルの中からランダムに選択された1つのプロファイルに帰属させます。
このため、Currentsのメール開封またはクリックイベントのexternal_user_id値（Brazeスキーママッピングテーブルではexternal_idと表記）は、CurrentsとBrazeダッシュボードを比較した際に、期待するユーザープロファイルと一致しない場合があります。
すべての送信イベントはCurrentsに記録されますか？
すべてのイベントはCurrentsに記録されます。Currentsストリームからイベントが意図的に抑制されるシナリオはありません。
Currentsでデータが破損することはありますか？
通常の状況下では、Currentsのデータは破損しません。まれに問題が発生する可能性は常にありますが、データが体系的に破損するような既知の条件はありません。
Currentsインテグレーションを設定する前の日付のカスタムイベントデータが表示されるのはなぜですか？
BrazeはCurrentsにイベントをバックフィルしません。ただし、カスタムイベントは過去のタイムスタンプで記録されることがあります（たとえば、イベントの発生時にデバイスがオフラインで、後から同期された場合など）。このような場合、イベントのタイムスタンプはイベントが実際に発生した時刻を反映するため、Currentsインテグレーションが設定される前の日付になることがあります。
Currentsイベントにはどのユーザー識別子が含まれますか？
メッセージエンゲージメントイベント（送信、開封、クリックなど）には、BrazeユーザーID（user_id）と、プロファイルに存在する場合はexternal ID（イベントペイロードではexternal_user_id、Brazeスキーママッピングテーブルではexternal_idとラベル付け）が含まれます。一部のメールメッセージエンゲージメントイベントにはemail_addressも含まれます。カスタム属性は含まれません。
Currentsデータをデータウェアハウスまたはカスタマーリレーションシップマネジメント CRMにルーティングし、プロファイルデータと結合する必要がある場合は、ダウンストリームシステムでuser_idまたはexternal_user_idを使用してその結合を行ってください。
Currents送信イベントにカスタム属性を含めることはできますか？
いいえ。Currentsは送信イベントにカスタム属性を含みません。Currentsはカスタムイベントとメッセージエンゲージメントイベントを記録します。利用可能なフィールドの完全なリストについては、イベント用語集を参照してください。
Currentsにはキャンペーンやキャンバスのタグ、またはキーと値のペアが含まれていますか？
いいえ。Currentsにはキャンペーンやキャンバスのタグ、またはメッセージレベルのキーと値のペアは含まれていません。タグデータを取得するには、エクスポートREST APIを使用してください。別の回避策として、キャンペーン内のWebhookチャネルを使用して、Liquidで値をテンプレート化し、タグやキーと値のペアのデータを独自のエンドポイントに送信できます。
BrazeはCurrentsの変更をどのように顧客に通知しますか？
まれに破壊的な変更が発生した場合、Brazeはアクティブなインテグレーションの連絡先、および過去30日以内にダッシュボードを使用したアクティブなCurrentsインテグレーションを持つすべての管理者に、事前にメールを送信します。新しいイベントや既存のイベントへの新しいフィールドの追加など、非破壊的な変更については、Brazeは通知を送信しません。最新の変更については、Currents変更履歴を参照してください。
Currentsデータにはどのくらいのストレージが必要ですか？
ストレージの要件は、イベントの量とエクスポートするイベントの種類によって異なります。BrazeはAvro形式のサンプルイベントを提供しており、お使いのユースケースに合わせたファイルサイズの見積もりにご利用いただけます。
キャンペーン名やキャンバスステップ名がCurrentsデータでNULLになるのはなぜですか？
新しいキャンペーンやキャンバスを作成した場合、名前がすべてのBrazeシステムに反映されるまでに時間がかかることがあります。この間にCurrentsを通じて送信されたイベントでは、名前フィールド（campaign_nameやcanvas_step_nameなど）がNULLになることがあります。イベントが記録される直前に名前が変更された場合も、同様の現象が発生します。これを避けるには、キャンペーンやキャンバスステップを作成または名前変更した後、送信するまでしばらく時間を置いてください。
Currentsでセッション終了イベントが遅延する、または欠落するのはなぜですか？
セッション終了イベントは、SDKの通常のアップロードスケジュールに従います。Braze SDKはセッションデータをローカルにキャッシュし、ネットワーク品質に基づいて定期的にフラッシュします。例えば、接続が良好な場合は約10秒ごとにフラッシュされます。SDKがイベントをアップロードするまで、Currentsには表示されません。
ユーザーが次のフラッシュ前にアプリを強制終了したりオフラインになったりすると、セッション終了イベントの到着が遅れるか、まったく届かない場合があります。iOSでは、SDKがバックグラウンドでデータを送信できないため、セッション終了イベントはアプリが再度開かれるまでフラッシュされないことがよくあります。
Currentsでよりタイムリーなセッション境界が必要な場合は、アプリがバックグラウンドに移行するときやフォアグラウンドに戻るときなどのライフサイクルポイントでrequestImmediateDataFlush()を呼び出してください。詳細については、データのアップロードとダウンロードおよびセッション終了とセッション開始のタイムスタンプが類似している（iOS）を参照してください。
Currentsがデータを書き込もうとしたときにストレージバケットが利用できない場合はどうなりますか？
データ転送時にストレージバケットが利用できない場合、そのデータは失われます。Brazeは、正常に配信されなかったイベントをバックフィルすることはできません。データ損失を防ぐために、ストレージバケットが常に利用可能で適切に設定されていることを確認してください。
Currentsインテグレーションの作成または編集時にエンタイトルメント制限メッセージが表示されるのはなぜですか？
Currentsは、異なるコネクター機能に対して個別のエンタイトルメントプールを使用します。
- Engagement Events：標準的なCurrentsコネクターの作成またはアップグレードに必要です。
- Customer Behavior Events：Track Customer Behavior and User Eventsを有効にするために必要です。
- User Profiles and Attributes：Track user profiles and attributesを有効にするために必要です。
いずれかのプールが使い果たされると、Brazeはエンタイトルメントの警告を表示し、そのアクションをブロックします。追加のエンタイトルメントのリクエストや設定の調整については、Brazeアカウントマネージャーにお問い合わせください。
ストレージパスのCurrentsバージョンはどのくらいの頻度で変更されますか？
ストレージパスのversion=<currents_version>セグメントは、毎月のリリースサイクルに合わせてCurrentsのリリースごとに更新されます（例：version=6からversion=7）。特定のバージョンセグメントをハードコーディングするのではなく、ルートパスから再帰的にファイルを読み取ることをお勧めします。これにより、バージョン変更後もパイプラインが自動的にデータを取得できます。パス形式の詳細については、イベント配信セマンティクスを参照してください。バージョンごとの変更履歴については、Currents変更ログを参照してください。
メッセージエンゲージメントイベントからcampaign_idやcanvas_idが欠落しているのはなぜですか？
イベントの種類やコンテキストによっては、メッセージエンゲージメントイベントが特定のキャンペーンやキャンバスステップに紐づいていない場合があります。そのような場合、campaign_id、canvas_id、および関連する名前フィールドがイベントペイロードから省略されることがあります。特定のイベントでこれらのフィールドが見つからない場合は、そのイベントの種類やコンテキストが通常キャンペーンやキャンバスの識別子を含むかどうかを確認してください。
Currentsのタイムスタンプが秒精度に制限されているのはなぜですか？
Currentsイベントのtimeフィールドは32ビット整数として保存されるため、秒精度に制限されています。一部のイベントには、別途64ビットのミリ秒精度タイムスタンプフィールドも含まれています。各イベントタイプで利用可能なフィールドについては、イベント用語集を確認してください。
Currentsのusers.canvas.Conversionイベントの時刻がキャンバスと異なるのはなぜですか？
Currentsのusers.canvas.Conversionイベントの時刻は、キャンバスへのエントリからの合計コンバージョンウィンドウ（キャンバスの期間とコンバージョン期限の合計）を反映しています。
エンゲージメントレポートがS3に送信されるとどうなりますか？
データエクスポート用にS3認証情報が設定されているが、Currents用には設定されていない場合、Brazeはエンゲージメントレポートを指定されたS3バケットにアップロードします。レポート送信先フィールドに記載されているユーザーは、S3内のレポートへのリンクを含むメールを受信します。
匿名ユーザーデータはBraze Currentsを通じてAmplitudeに送信できますか？
device_idで識別される匿名ユーザーデータは、Currentsを通じてAmplitudeに送信できます。この機能を利用するには、Brazeアカウントチームによる機能の有効化が必要です。
Content Cards、アプリ内メッセージ、バナーにおけるコントロールグループユーザーはCurrentsでどのように記録されますか？
ユーザーがContent Cardsまたはアプリ内メッセージキャンペーンのコントロールグループに割り当てられた場合、Currentsはインプレッションイベントではなくusers.campaigns.EnrollInControlイベントを発行します。
バナーキャンペーンの動作は異なります。コントロールユーザーはusers.campaigns.EnrollInControlに記録されません。代わりに、コントロールの露出はSDKがインプレッションを記録した後にusers.messages.banner.Impressionイベントとして記録されます。これは、インテグレーションがコントロールバナーに対してinsertBannerを呼び出し、コンテナを非表示にする場合も含まれます。Currentsまたはデータ共有でコントロールユーザーを特定するには、コントロールバリエーションのmessage_variation_idまたはmessage_variation_name（Control Group）でフィルタリングしてください。
テーブルスキーマについては、バナーインプレッションイベントおよびUSERS_MESSAGES_BANNER_IMPRESSION_SHAREDを参照してください。
API経由で存在しないユーザーをターゲットにした場合はどうなりますか？
存在しないユーザーをターゲットにした場合、APIは200レスポンスを返しますが、送信は「Unknown external ID」という結果でキャンセルされます。その送信に対するCurrentsイベントは生成されません。send_to_existing_onlyパラメーターはデフォルトでtrueに設定されているため、不明なユーザーへの送信は、明示的にfalseに設定しない限りサイレントにスキップされます。