Laporan Tersegmentasi

Search Ads 360 Reporting API versi baru kini tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

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

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

Namun, jika Anda meminta laporan kata kunci yang mengelompokkan berdasarkan kuartal, untuk setiap kata kunci, Anda akan melihat satu baris untuk setiap kuartal, dan kolom klik akan mencantumkan total per kuartal.

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 disegmentasikan menampilkan baris hanya jika data tersedia untuk sebuah segmen. Misalnya, dalam laporan kata kunci dengan kolom floodlightActivity, pasangan kata kunci dan aktivitas Floodlight tidak akan muncul dalam laporan jika tidak ada metrik yang diatribusikan ke kolom tersebut 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 data Floodlight, seperti dfaActions, dfaRevenue, dfaTransactions, dan dfaWeightedActions. Jenis kolom konversi lainnya (seperti adWordsConversions), atau kolom yang melaporkan metrik mesin (seperti klik dan tayangan), tidak berisi data yang dilaporkan oleh Floodlight, sehingga menampilkan nilai yang tidak valid jika Anda menyegmentasikan laporan menurut floodlightActivity.

Cara meminta laporan yang disegmentasikan

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

Permintaan asinkron berikut ditujukan untuk laporan kata kunci yang dikelompokkan menurut kuartal. Kolom klik di setiap baris akan berisi total jumlah 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 sebagian, yang mungkin membuat orang berpikir bahwa telah terjadi penurunan drastis pada klik, pendapatan, dan sebagainya.

Meminta beberapa segmen

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

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

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

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