Skip to content

よくある質問

このページには Currents に関するよくある質問とその回答を掲載しています。

履歴データを取得するには?

Currents はリアルタイムのライブデータストリームです。つまりイベントを再生することはできません。ただし、Amazon S3 や Microsoft Azure Blob Storage などのデータウェアハウスに Currents データを保存できるため、過去のイベントを必要に応じて処理できます。データは30日間保持されますが、さらに過去の履歴データについては、Snowflake をクエリできます。

Currents が JSON ではなく Avro 形式でデータを出力するのはなぜですか?

Avro は、スキーマレスの JSON とは異なり、スキーマの進化をネイティブでサポートしています。また、Avro は圧縮性が高いため、より少ない帯域幅で Avro ファイルを送信でき、ストレージ容量も節約できるという利点があります。

Braze はファイルのオーバーヘッドをどのように処理しますか?

Extract, Transform, Load (ETL) プロセスを構築しています。このプロセスにより、あるデータベースから大量のデータを取り出し、別のデータベースに格納できます。

クエリのためにこのデータをどこに保存すればよいですか?

Braze は、クエリ用にデータを保存できる複数のデータウェアハウスと提携しています。以下を使用することをお勧めします。

Currents データの信頼性はどの程度ですか?

Currents は「at-least-once（少なくとも1回）」の配信を保証しています。つまり、重複イベントがストレージバケットに書き込まれることがあります。ユースケースで厳密に1回の配信が必要な場合は、すべてのイベントに付与されるユニーク識別子フィールド（id）を使用してイベントの重複を排除できます。詳細については、イベント配信セマンティクスを参照してください。

データはどのくらいの頻度で Currents に同期されますか?

データは継続的にストリーミングされます。Braze は、送信するバッチがいっぱいになるたびに、または5分ごとに（いずれか早い方で）イベントのバッチを送信します。大量のコネクターの場合、データはほぼリアルタイムで届きます。少量のコネクターの場合、データの到着には5〜30分かかることがあります。詳細については、Avro 書き込みしきい値を参照してください。

Currents で利用可能なイベントを確認するには?

Currents がログに記録するイベントの完全なリストについては、顧客行動イベントおよびメッセージエンゲージメントイベントの用語集を参照してください。これらの用語集はイベントタイプ（送信、配信、開封など）でフィルターできます。

すべての送信イベントは Currents にログ記録されますか?

すべてのイベントは Currents にログ記録されます。Currents ストリームからイベントが意図的に抑制されるシナリオはありません。

Currents でデータが破損することはありますか?

通常の状況では、Currents データは破損しません。まれな問題が発生する可能性は常にありますが、データが体系的に破損する既知の条件はありません。

Currents 統合を設定する前の日付のカスタムイベントデータが表示されるのはなぜですか?

Braze は Currents にイベントをバックフィルしません。ただし、カスタムイベントは過去のタイムスタンプでログ記録されることがあります（たとえば、イベント発生時にデバイスがオフラインで、後から同期された場合など）。このような場合、イベントのタイムスタンプはイベントが最初に発生した時刻を反映するため、Currents 統合が設定される前の日付になることがあります。

Currents の送信イベントにカスタム属性を含めることはできますか?

いいえ。Currents は送信イベントにカスタム属性を含めません。Currents はカスタムイベントとメッセージエンゲージメントイベントをログ記録します。利用可能なフィールドの完全なリストについては、イベント用語集を参照してください。

Currents にはキャンペーンタグやキーと値のペアが含まれますか?

いいえ。Currents にはキャンペーンタグやメッセージレベルのキーと値のペアは含まれません。回避策として、キャンペーン内の Webhook チャネルを使用し、Liquid でタグやキーと値のペアのデータをテンプレート化して、独自のエンドポイントにこの情報を送信できます。

Braze は Currents の変更をどのように顧客に通知しますか?

Currents の変更（新しいイベントフィールドやイベントタイプなど）が発生した場合、Braze は過去30日以内にダッシュボードを使用したアクティブな Currents 統合を持つすべての顧客にメールを送信します。最新の変更については、Currents 変更ログも参照できます。

Currents データにはどのくらいのストレージが必要ですか?

ストレージ要件は、イベントの量とエクスポートするイベントの種類によって異なります。Braze は Avro 形式のサンプルイベントを提供しており、ユースケースに合わせてファイルサイズを見積もることができます。

Currents データでキャンペーン名やキャンバスステップ名が NULL になるのはなぜですか?

新しいキャンペーンやキャンバスを作成すると、名前がすべての Braze システムに伝播するまでに時間がかかることがあります。この時間枠内に Currents を通じて送信されたイベントでは、名前フィールド（campaign_name や canvas_step_name など）が NULL になることがあります。これは、イベントがログ記録される直前に名前が変更された場合にも発生します。これを回避するには、キャンペーンやキャンバスステップを作成または名前変更した後、送信前にしばらく時間を置いてください。

Currents がデータを書き込もうとしたときにストレージバケットが利用できない場合はどうなりますか?

データ転送時にストレージバケットが利用できない場合、そのデータは失われます。Braze は正常に配信されなかったイベントをバックフィルすることはできません。データ損失を防ぐために、ストレージバケットが常に利用可能で適切に設定されていることを確認してください。

スキーマ ID はどのくらいの頻度で更新されますか?

スキーマ ID はすべてのイベントタイプでグローバルであり、順番にインクリメントされます。更新はいつでも発生する可能性があり、Braze は今後の変更についてメールで顧客に通知します。いずれかのイベントタイプでスキーマの更新が発生するたびに、次に利用可能なグローバル ID が割り当てられます。スキーマ ID の変更に対応するために、ルートパスからファイルを再帰的に読み取ることをお勧めします。詳細については、Avro スキーマの変更を参照してください。
Github   GitHub でこのページを編集
New Stuff!