同期レポート

同期レポートとは

同期レポートは、短時間で実行する必要がある小さなレポートです。DCM レポート プラットフォームは、同期レポートの実行リクエストを受信すると、すぐにレポートの実行を開始します。このようなレポートは、グラフィカル ユーザー インターフェースで指標を表示する場合など、小さなデータチャンクが必要な状況に最適です。

同期レポートと非同期レポート生成の違いは何ですか？

データを非同期でリクエストする場合、少量のデータをリクエストする場合でも、常に数分かかります。同期レポートでは、レポート作成に要する時間のタイムアウトを小さくしつつ、このデータを迅速に返すことができます。非同期レポート生成は、同期タイムアウト期間内にレポートを実行できない場合、またはユーザー インターフェースなどの時間的制約のある環境でない場合に使用する必要があります。

同期レポートのタイムアウト期間はどのくらいですか。

10 秒以内に実行できるだけの小さなレポートの場合、システムは最初の実行リクエストに完全なレポート ファイルを返します。 それ以外の場合は、タイムアウトになるまで 50 秒間レポートが作成されます。

同期レポートに時間がかかりすぎる場合はどうなりますか？

同期レポートの生成がタイムアウト期間内に完了しない場合、生成が停止し、非同期レポートキューにレポートがフェイルオーバーされます。このレポートは、失敗することもエラーも返しませんが、非同期レポート キューに移動すると、レポートが生成されるまで少なくとも数分かかります。

レポートの生成時間以外の同期レポート タイムアウト時間を超過したことを示す通知は届きません。これは 50 秒以内に同期的に完了するか、非同期になって数分間かかります。

同期実行がサポートされているレポートタイプは、次のうちどれですか。

以下の例外を除き、すべてのレポートタイプで同期実行がサポートされます。

他のレポートタイプはすべて同期実行をサポートしていますが、データが多すぎるか、リソースを大量に消費する指標とディメンションの組み合わせが使用されている場合は、タイムアウトします。

同期レポートの作成方法

デフォルトでは、すべてのレポートが非同期で実行されます。新しいレポート ファイルの生成をリクエストするときに、オプションの synchronous パラメータを true に設定して、レポートの同期実行をリクエストできます。ドキュメントの サンプルコードをご覧ください。

すべてのレポートを同期実行でリクエストする必要がありますか？

いいえ。同期実行をリクエストできるのは、レポートがタイムアウト期間内に完了する場合のみです。レポートが同期実行で始まり、タイムアウトに達すると、そのレポートは非同期キューに移動します。つまり、レポートの合計実行時間は、非同期レポートを生成するのに必要な時間と同期タイムアウト期間を加えた時間になります。したがって、レポートを非同期的にリクエストすれば、同期タイムアウトが長く遅延することを避けられます。

リクエストする指標とディメンションはレポートの生成時間に影響しますか？

はい、表示されます。指標とディメンションの中には、他の指標よりもコンパイルに時間がかかるものがあります。また、一部の指標とディメンションでは、同期レポートが常にタイムアウトする場合があります。地域ディメンションは、このようなディメンションの同期レポートに組み込まれることはあまりありませんが、そういった速度はほとんどありません。

同期レポートを許可するためにレポートの生成時間を短縮するには、どうすればよいですか？

速度には、対象キャンペーンの規模やレポートの対象期間など、さまざまな要因が影響します。レポートを手動で細かく調整するには、できるだけ手作業で微調整するのが最も効果的です。まずは、必要なデータをすべてすばやく表示し、レポートが同期的に正常に実行されるまで絞り込むことです。