Skip to main content
実際のダッシュボードのタイルには 2 つの数値が表示されます。ヘッドラインの期間スコア(1 つの 大きな数値)と日次系列(折れ線)です。これらは同じエンドポイントへの 2 回の 別々の呼び出しから得られます。このレシピでは両方を並べて実行し、 それぞれの抽出方法と、一方から他方を導出できない理由を 説明します。
日次の行を平均して期間スコアを算出しないでください:両者は計算方法が 異なります。詳しくは 規約と注意点 を参照してください。

この例の仕組み

  1. ヘッドラインの呼び出しには date ディメンションがありません。API は期間全体について、 トラフィックで重み付けされた単一のスコアを返します。
  2. 系列の呼び出しでは、dimensions に date を追加し、date_interval を設定します。 API は 1 日につき 1 行を返し、各行にはその日の重み付けされていない比率が含まれます。
  3. 日次の値を平均してヘッドラインを計算しないでください。 ヘッドラインでは プロンプト数の多い日ほど大きく反映されますが、日次の平均はすべての日を 等しく扱います。この 2 つは意図的に異なる方法で計算されています。

2 つのレスポンスの違い

日次の値を平均できない理由

ヘッドラインは各日をプロンプト量で重み付けします。10,000 件の プロンプトがある日は、100 件の日よりもヘッドラインを大きく動かします。日次の比率を平均すると、 この 2 日を同等に扱ってしまいます。ほとんどのアセットでは差は 1〜3 パーセンテージ ポイントですが、トラフィックが急増するアセットではそれ以上になることがあります。ヘッドラインには 必ずヘッドラインの呼び出しを使用してください。