Laporan Tersegmentasi

Search Ads 360 API hanya menampilkan data gabungan, kecuali jika Anda meminta segmen yang lebih mendetail layanan otomatis dan data skalabel. Misalnya, kolom klik dalam kata kunci laporan mencantumkan total jumlah klik pada kata kunci selama rentang waktu yang Anda tentukan.

Namun, jika meminta laporan kata kunci yang segmennya menurut kuartal, untuk setiap kata kunci, Anda melihat satu baris untuk setiap kuartal, dan kolom klik akan mencantumkan total tiga bulanan.

Perhatikan bahwa laporan yang disegmentasi akan menampilkan baris hanya jika data tersedia untuk sebuah segmen. Misalnya, dalam laporan kata kunci dengan kolom floodlightActivity, kata kunci dan Pasangan aktivitas Floodlight tidak akan muncul dalam laporan jika tidak ada metrik yang diatribusikan untuk rentang tanggal laporan.

Beberapa segmen tidak kompatibel dengan kolom tertentu

Beberapa segmen dapat menyebabkan kolom tertentu menampilkan data yang tidak valid. Misalnya, segmentasi menurut floodlightActivity hanya berguna jika Anda menyertakan kolom yang melaporkan Floodlight seperti dfaActions, dfaRevenue, dfaTransactions, dan dfaWeightedActions. Jenis kolom konversi lainnya (seperti adWordsConversions), atau kolom yang melaporkan metrik mesin telusur (seperti klik dan tayangan), tidak berisi data yang dilaporkan oleh Floodlight, sehingga menampilkan nilai yang tidak valid jika segmentasikan laporan menurut floodlightActivity.

Cara meminta laporan yang tersegmentasi

Untuk meminta laporan yang disegmentasikan, sertakan kolom yang mencantumkan segment sebagai perilakunya di referensi Jenis Laporan.

Permintaan asinkron berikut ditujukan untuk laporan kata kunci yang disegmentasikan menurut kuartal. Tujuan Klik di setiap baris akan berisi jumlah total klik untuk kuartal tersebut:

{
  "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
}