おすすめのレポート方法

このページでは、レポートの作成時に推奨される方法をいくつか紹介します。

レポートを保存、再利用する

定期的に実行するクエリのレポートを作成して保存することをおすすめします 同じレポートを何度も挿入して削除するとリソースが浪費されるためです 相対的な期間（YESTERDAY、LAST_7_DAYS など）を使用すると、レポートの再利用が簡単になります。

スケジュール設定されたレポート

アドホック（1 回限り）のレポートは個別に実行され、不完全なデータセットに対しても実行される可能性があるため、リソースを浪費するおそれがあります。スケジュールに基づくレポートは一括で実行され、かつその日の前のデータ処理が完了するまでは実行されないことが保証されているため、レポート リソースが最大限に活用されます。詳しくは、使用可能なスケジュール フィールドをご覧ください。

レポートのステータスをポーリングするときに指数バックオフを使用する

レポートの実行にかかる時間を予測することはできません。長さ 時間は、日付などのさまざまな要因によって、数秒から数時間の範囲になります 処理されるデータの量などに応じて 異なりますレポートの実行時間とレポートに含まれる行数との間にも相関関係はありません。そのため、実行中のレポートのステータスを定期的に確認して、 いつ終了したかを判断します。このプロセスを「ポーリング」と呼びます。

ポーリングは必要なものではありますが、実行に長時間を要するレポートに遭遇した場合、実装効率が悪いと割り当てられたリソースをすぐに使い切ってしまう可能性があります。そのためおすすめは 指数バックオフを使用して再試行回数を制限し 割り当てを節約できます

マルチパート ダウンロードを実行する

レポート ファイルは最大で数ギガバイトになる場合があります。このようなレポートを 1 回のリクエストでダウンロードすると、接続の問題が発生する可能性があります。また、1 つのリクエストが ダウンロードが中断されて再開する方法はなく、1 回のリクエストの失敗 中断するとダウンロードを再開できません。そのため、新しい Google Chat の マルチパート ダウンロードを使用して、大規模なダウンロードを小さなチャンクに分割します。分割された 1 回のダウンロードが失敗した場合、その時点からダウンロードを再開できます。

チャンク化には多くのメリットがありますが、各チャンクが別々のリクエストを生成します。 そのため、無駄を避けるため、最小サイズを 10 MB にすることをおすすめします。 できます。ただし、レポートサイズの平均が非常に大きい場合は、接続速度が許す限り、分割するサイズを大きくすることを検討してください。

レポートの割り当てを検討する

キャンペーン マネージャー 360 のレポート機能の責任ある使用 次の 3 つのプロダクト全体の使用量割り当てで提供されます。

  1. アドホック レポート実行数（1 日あたり）

    キャンペーン マネージャー アカウント / キャンペーン マネージャー ユーザー プロフィールが 24 時間以内に実行できるアドホック レポートの数を制限します。割り当てを超えないようにするには、次のようにします。

    • 重複レポートを削減します。
    • 定期的に実行されるレポートをスケジュール設定します。
    • 不要な API スクリプトを無効にします。

  2. スケジュール設定が可能なレポート数

    一定期間にキャンペーン マネージャー アカウント / キャンペーン マネージャー ユーザー プロフィールがアクティブにスケジュール設定できるレポートの数を制限します。割り当てを超えないようにするには、次のようにします。

    • 重複レポートを削減します。
    • 不要なスケジュール設定済みレポートを無効にします。
    • 不要な API スクリプトを無効にする。

  3. 同時レポート

    キャンペーン マネージャー アカウント / キャンペーン マネージャーユーザー プロフィールが同時に実行できるレポートの数を制限します。割り当てを超えないようにするには、次のようにします。

    • 定期的に実行するレポートをスケジュールします。
    • 不要な API スクリプトを無効にします。
    • バックオフ ロジックを実装します。

レポートの実装を最適化しているにもかかわらず、特定の割り当てを超えている場合は、お問い合わせフォームからキャンペーン マネージャー 360 サポートまでお問い合わせください。