分割レポート

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。この新しい API は 柔軟性の向上により、カスタム レポートを作成し、データをレポート アプリケーションに統合できます。 プロセスです。詳しくは、検索広告 360 リニューアル版レポートへの移行と利用に関する記事をご覧ください。 API。

Search Ads 360 API は、より詳細な分割されたデータをリクエストしない限り、集計データのみを返します できます。たとえば、キーワードの [クリック数] 列は レポートには、指定した期間内のキーワードの合計クリック数が表示されます。

keywordText keywordLandingPage clicks
ウィジェット http://www.example.com 6000

ただし、四半期ごとに分割したキーワード レポートをリクエストすると、キーワードごとに 四半期ごとに 1 行が表示され、クリック数の列には四半期の合計が表示されます。

keywordText keywordLandingPage quarterStart quarterEnd clicks
ウィジェット http://www.example.com 2012-01-01 2012-03-31 1000
ウィジェット http://www.example.com 2012-04-01 2012-06-30 1000
ウィジェット http://www.example.com 2012-07-01 2012-09-30 1000
ウィジェット http://www.example.com 2012-10-01 2012-12-31 3000

分割されたレポートでは、該当するセグメントのデータが利用可能な場合にのみ行が返されます。 たとえば、floodlightActivity 列を含むキーワード レポートでは、キーワードと 関連付けられている指標がない場合、Floodlight アクティビティのペアはレポートに表示されません 追加することもできます

一部のセグメントは特定の列に対応していません

セグメントによっては、特定の列で無効なデータが返される場合があります。たとえば floodlightActivity は、Floodlight をレポートする列が含まれている場合にのみ意味があります。 データ（dfaActions、dfaRevenue、dfaTransactions、 および dfaWeightedActions。その他の種類のコンバージョン列（ adWordsConversions）、エンジンの指標をレポートする列（クリック数、 値には Floodlight でレポートされたデータが含まれていないため、 レポートをfloodlightActivityで分割する。

分割レポートをリクエストする方法

分割レポートをリクエストするには、レポートの種類のリファレンスに、動作として segment を記載した列を含めます。

次の非同期リクエストは、四半期ごとに分割されたキーワード レポートに対するものです。「 各行の [クリック数] 列には、その四半期の合計クリック数が含まれます。

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
注: 日付に注意してください。四半期ごとのレポートをリクエストする場合は、 レポートの timeRange 四半期全体が含まれますそうしないと、部分的な結果しか得られないため、 クリック数や収益などが大幅に減少したと回答した人の割合です

複数のセグメントのリクエスト

リクエストには複数のセグメント列を含めることができます。次の点にご留意ください。

  • 週、月、四半期で分割する場合は、両方の属性を含めることをおすすめします。 start 列と end 列だけです。たとえば四半期レポートには quarterStart 列と quarterEnd 列。この両方を含む 列に期間の開始日と終了日が出力されるので、 全期間のデータが含まれます

  • 同じリクエストに異なるタイプの時間関連セグメントを含めることはできません。 たとえば、同じリクエストで四半期と月別に分割することはできません。

  • セグメントが追加されるたびに行数が指数関数的に増加する可能性があります。