Laporan Tersegmentasi

Search Ads 360 Reporting API versi baru kini tersedia. API baru menyediakan meningkatkan fleksibilitas dalam membuat laporan kustom dan mengintegrasikan data ke dalam aplikasi pelaporan dan proses. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Pelaporan Search Ads 360 versi baru Google Cloud Platform.

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.

keywordText keywordLandingPage clicks
widget http://www.example.com 6000

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.

keywordText keywordLandingPage quarterStart quarterEnd clicks
widget http://www.example.com 2012-01-01 2012-03-31 1000
widget http://www.example.com 2012-04-01 2012-06-30 1000
widget http://www.example.com 2012-07-01 2012-09-30 1000
widget http://www.example.com 2012-10-01 2012-12-31 3000

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
}
Catatan: Berhati-hatilah dengan tanggal. Jika Anda meminta laporan tiga bulanan, pastikan timeRange laporan mencakup seluruh kuartal. Jika tidak, Anda hanya akan mendapatkan hasil yang tidak lengkap, yang mungkin membuat orang merasa ada penurunan drastis pada klik, pendapatan, dan sebagainya.

Meminta beberapa segmen

Anda dapat menyertakan lebih dari satu kolom segmen dalam permintaan. Perhatikan hal berikut:

  • Jika Anda melakukan segmentasi menurut minggu, bulan, atau kuartal, sebaiknya Anda menyertakan kedua jenis kolom awal dan akhir dalam permintaan Anda. Misalnya, dalam laporan tiga bulanan, sertakan kolom quarterStart dan quarterEnd. Menyertakan keduanya akan menghasilkan tanggal mulai dan akhir periode, yang akan membantu memastikan bahwa Anda data yang disertakan untuk setiap periode penuh.

  • Anda tidak dapat menyertakan berbagai jenis segmen terkait waktu dalam permintaan yang sama. Misalnya, Anda tidak dapat melakukan segmentasi berdasarkan kuartal dan bulan dalam permintaan yang sama.

  • Jumlah baris bisa meningkat secara eksponensial dengan setiap segmen tambahan.