分割レポート

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

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

分割されたレポートでは、該当するセグメントのデータが利用可能な場合にのみ行が返されます。 たとえば、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
}