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 }
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
danquarterEnd
. 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.