Anda dapat mengkueri data performa dengan cepat, dan tanpa melebihi kuota, dengan menjalankan kueri harian untuk data selama satu hari.
Anda harus memilih informasi yang diinginkan dalam data: jenis penelusuran (web, gambar, video, dll.) dan dimensi (halaman, kueri, negara, atau perangkat), serta apakah akan mengelompokkan hasil menurut halaman atau properti. Saat membuat kueri untuk string kueri dan/atau halaman, beberapa data mungkin dihapus (berikut alasannya).
Ringkasan
- Sebaiknya jalankan kueri setiap hari untuk data selama satu hari menggunakan salah satu gaya kueri yang dijelaskan di bawah. Menjalankan kueri harian untuk data selama satu hari tidak boleh melebihi kuota harian Anda. Data biasanya tersedia setelah 2-3 hari; Anda dapat mempelajari data terbaru yang tersedia dengan menjalankan kueri sederhana yang dikelompokkan menurut tanggal selama 10 hari terakhir. Dalam menulis kueri Anda:
- Pilih apakah akan mengelompokkan hasil menurut halaman atau properti.
- Pilih apakah Anda ingin jumlah yang lebih lengkap atau lebih banyak dimensi dalam kueri Anda. Catatan: data tampilan penelusuran (AMP, link biru, hasil kaya, dan sebagainya) harus dikueri menggunakan proses dua langkah.
- Halaman melalui hasil dengan menjalankan kembali kueri yang sama, meningkatkan nilai
startRow
sebesar 25.000 dalam permintaan hingga Anda mencapai halaman terakhir (respons dengan 0 baris). - Secara opsional, jalankan kueri yang sama dengan parameter
type
lainnya.
Berikut adalah contoh kode semu untuk satu kueri. Anda dapat menjalankan ini sekali sehari
untuk setiap nilai type
yang datanya Anda inginkan.
int maxRows = 25000; // Current max response size int i = 0; do { response = Request(startDate = 3_days_ago, endDate = 3_days_ago, ... add dimensions, type ... rowLimit = maxRows, startRow = i * maxRows); i++; … // Do something with the response data. } while (response.rows.count() != 0); // Page through all result rows
Batas data
Selain kuota penggunaan API, metode Analisis Penelusuran mengekspos maksimum 50 ribu baris data per hari per jenis penelusuran (web, gambar, dan sebagainya--diurutkan berdasarkan klik).
Detail kueri
Anda dapat mengkueri data yang dikelompokkan berdasarkan halaman atau properti.
Dikelompokkan menurut halaman
Untuk jumlah akurat, Anda harus menghapus dimensi halaman dan kueri, seperti ini:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate
/endDate
: Pilih periode satu hari dengan memilih tanggal yang sama.dimensions
: Opsional, menyertakancountry
dan/ataudevice
.type
: Menghitung lebih dari setiap nilaitype
seperti yang diinginkan dalam kueri terpisah.aggregationType
: HarusbyPage
.
Untuk detail selengkapnya, termasuk informasi halaman dan/atau kueri, dengan kehilangan beberapa data, jalankan kueri seperti ini:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate
/endDate
: Pilih periode satu hari dengan memilih tanggal yang sama.dimensions
: Menyertakanpage
. Secara opsional, sertakan kombinasiquery
,country
, ataudevice
.type
: Menghitung lebih dari setiap nilaitype
seperti yang diinginkan dalam kueri terpisah.
Dikelompokkan menurut properti
Untuk jumlah akurat, Anda harus menghapus dimensi halaman dan kueri, seperti ini:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate
/endDate
: Pilih periode satu hari dengan memilih tanggal yang sama.dimensions
: Opsional, menyertakancountry
dan/ataudevice
.type
: Menghitung lebih dari setiap nilaitype
secara opsional seperti yang diinginkan dalam kueri terpisah.
Untuk detail selengkapnya, termasuk kueri, negara, dan/atau informasi perangkat, dengan kehilangan beberapa data, jalankan kueri seperti ini:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate
/endDate
: Pilih periode satu hari dengan memilih tanggal yang sama.dimensions
: Secara opsional, sertakan kombinasiquery
,country
, ataudevice
.type
: Menghitung lebih dari setiap nilaitype
seperti yang diinginkan dalam kueri terpisah.
Mengelompokkan hasil menurut halaman atau properti
Tayangan, klik, posisi, dan rasio klik-tayang dihitung secara berbeda saat mengelompokkan hasil menurut halaman, bukan berdasarkan properti. Pelajari lebih lanjut.
Mengapa saya kehilangan data saat meminta detail lebih lanjut?
Saat Anda mengelompokkan berdasarkan halaman dan/atau kueri, sistem kami dapat menghapus beberapa data agar dapat menghitung hasil dalam waktu yang wajar menggunakan jumlah resource komputasi yang wajar.
Mendapatkan data tampilan penelusuran
Tampilan penelusuran tidak tersedia sebagai kolom bersama dimensi lainnya. Oleh karena itu, jika ingin melihat informasi tampilan penelusuran untuk situs, Anda harus mengikuti proses ini:
- Tentukan
searchAppearance
sebagai satu-satunya dimensi, yang akan mengelompokkan semua data menurut jenis tampilan penelusuran tanpa dimensi lainnya. - Secara opsional, jalankan kueri kedua, dengan memfilter salah satu jenis tampilan penelusuran yang tercantum pada langkah 1, tambahkan dimensi yang diinginkan ke kueri (halaman, negara, kueri, dll.).
Untuk mengambil data tentang beberapa jenis tampilan penelusuran, Anda harus menjalankan langkah kedua satu kali per jenis tampilan penelusuran yang tercantum pada langkah 1.
Kueri pertama:
Dapatkan daftar jenis tampilan penelusuran di situs Anda.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "searchAppearance" ] }
Hasil:
Situs Anda memiliki jenis INSTANT_APP, AMP_BLUE_LINK, dan sebagainya.
"rows": [ { "keys": [ "INSTANT_APP" ], "clicks": 443024.0, "impressions": 4109826.0, "ctr": 0.10779629113251997, "position": 1.088168452873674 }, { "keys": [ "AMP_BLUE_LINK" ], "clicks": 429887.0, "impressions": 1.7090884E7, "ctr": 0.025152999692701676, "position": 7.313451603790653 },...
Kueri kedua:
Filter menurut salah satu jenis tampilan penelusuran yang ditemukan pada langkah 1, beserta dimensi apa pun yang Anda sukai (halaman, perangkat, dll.). Di sini, kita memfilter menurut AMP_BLUE_LINK.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "device" // and/or page, country, ... ], "dimensionFilterGroups": [ { "filters": [ { "dimension": "searchAppearance", "operator": "equals", "expression": "AMP_BLUE_LINK" } ] } ] }
Hasil:
Pengelompokan AMP_BLUE_LINK menurut jenis perangkat.
"rows": [ { "keys": [ "MOBILE" ], "clicks": 429887.0, "impressions": 1.7090783E7, "ctr": 0.025153148337323107, "position": 7.31339517914422 }, { "keys": [ "DESKTOP" ], "clicks": 0.0, "impressions": 66.0, "ctr": 0.0, "position": 12.257575757575758 }, ...