よくある質問
このページでは、Currentsに関するよくある質問への回答を提供します。
特定の日付範囲でキャンペーンやキャンバスのデータをエクスポートできますか？
定義された日付範囲のキャンペーンまたはキャンバスの指標を取得するには、以下のいずれかの方法を使用してください。
- date-aligned campaign or キャンバス 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はat-least-once配信を提供しているため、重複イベントが記録されることがあります。ダッシュボードの指標と比較する前に、各イベントの一意のidフィールドで重複を排除してください。
Currentsのメール開封やクリックイベントのexternal_user_id（Brazeスキーマ：external_id）がBrazeダッシュボードのユーザープロファイルと異なるのはなぜですか？
- Brazeダッシュボード： メールアドレスに関連付けられたユーザーがメールを開封またはクリックすると、そのメールアドレスを共有するすべてのユーザープロファイルが、そのメールを開封またはクリックしたとしてマークされます。詳細については、メールが送信された際に、複数のプロファイルが同じメールアドレスを持っている場合はどうなりますか？を参照してください。
- Currents： 同じ開封やクリックは1つのプロファイルに保存されます。Brazeは、そのプロファイルがまだそのメールアドレスを共有している場合、送信時に元々ターゲットとなったプロファイルに帰属させます。それ以外の場合、Brazeはそのメールアドレスを共有するプロファイルの中からランダムに選択された1つのプロファイルに帰属させます。
このため、Currentsのメール開封やクリックイベントのexternal_user_id値（Brazeスキーママッピングテーブルではexternal_idという名前）は、CurrrentsとBrazeダッシュボードを比較した際に、期待するユーザープロファイルと一致しない場合があります。
すべての送信イベントはCurrentsに記録されますか？
すべてのイベントはCurrentsに記録されます。Currentsストリームからイベントが意図的に抑制されるシナリオはありません。
Currentsのデータが破損することはありますか？
通常の状況では、Currentsのデータが破損することはありません。まれに問題が発生する可能性は常にありますが、データが体系的に破損するような既知の条件はありません。
Currentsインテグレーションの設定前の日付のカスタムイベントデータが表示されるのはなぜですか？
BrazeはCurrentsにイベントをバックフィルしません。ただし、カスタムイベントは過去のタイムスタンプで記録される場合があります（例えば、イベント発生時にデバイスがオフラインで、後から同期された場合など）。このような場合、イベントのタイムスタンプはイベントが実際に発生した時点を反映するため、Currentsインテグレーションが設定される前の日付になることがあります。
Currentsイベントにはどのユーザー識別子が含まれていますか？
メッセージエンゲージメントイベント（送信、開封、クリックなど）には、BrazeユーザーID（user_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では、異なるコネクター機能に対して個別のエンタイトルメントプールが使用されます。
- エンゲージメントイベント：標準のCurrentsコネクターの作成またはアップグレードに必要です。
- 顧客行動イベント：顧客行動とユーザーイベントの追跡を有効にするために必要です。
- ユーザープロファイルと属性：ユーザープロファイルと属性の追跡を有効にするために必要です。
いずれかのプールが使い切られると、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バケットにエンゲージメントレポートをアップロードします。Send Report Toフィールドに記載されているユーザーは、S3内のレポートへのリンクが含まれたメールを受信します。
匿名ユーザーデータはBraze Currentsを通じてAmplitudeに送信できますか？
device_idで識別される匿名ユーザーデータは、Currentsを通じてAmplitudeに送信できます。これには、Brazeアカウントチームによる機能の有効化が必要です。
Content Cardsおよびアプリ内メッセージのコントロールグループインプレッションは、Currentsでどのように記録されますか？
ユーザーがContent Cardsまたはアプリ内メッセージキャンペーンのコントロールグループに割り当てられると、Currentsはインプレッションイベントではなくusers.campaigns.EnrollInControlイベントを送信します。
APIで存在しないユーザーをターゲットにした場合はどうなりますか？
存在しないユーザーをターゲットにした場合、APIは200レスポンスを返しますが、送信は「Unknown external ID」という結果でキャンセルされます。その送信に対するCurrentsイベントは生成されません。send_to_existing_onlyパラメーターはデフォルトでtrueに設定されているため、明示的にfalseに設定しない限り、不明なユーザーへの送信はサイレントにスキップされます。