Mendapatkan data kinerja Anda

Anda dapat membuat kueri data performa dengan cepat, dan tanpa melebihi kuota, dengan menjalankan kueri harian untuk data selama satu hari.

Anda harus memilih informasi yang Anda inginkan dalam data: jenis penelusuran yang mana (web, gambar, video, dll.) dan dimensi mana (halaman, kueri, negara, atau perangkat), serta apakah akan mengelompokkan hasil menurut halaman atau properti. Saat membuat kueri untuk string halaman dan/atau kueri, beberapa data mungkin dihapus (ini alasannya).

Ringkasan

Sebaiknya jalankan kueri setiap hari untuk data selama satu hari menggunakan salah satu gaya kueri yang dijelaskan di bawah. Menjalankan kueri harian selama satu hari data tidak boleh melebihi kuota harian. 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. Catatan: data tampilan penelusuran (AMP, link biru, hasil multimedia, dan sebagainya) harus dikueri menggunakan proses dua langkah.
Lakukan halaman pada hasil dengan menjalankan kembali kueri yang sama, dengan meningkatkan nilai startRow sebanyak 25.000 dalam permintaan hingga Anda mencapai halaman terakhir (respons dengan 0 baris).
Jika ingin, jalankan kueri yang sama dengan parameter type lain.

Berikut adalah contoh kode semu untuk satu kueri. Anda dapat menjalankannya sekali per hari 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 Search Analytics menampilkan maksimal 50 ribu baris data per hari per jenis penelusuran (web, gambar, dan lain-lain yang diurutkan menurut klik).

Detail kueri

Anda dapat membuat kueri data yang dikelompokkan menurut halaman atau properti.

Dikelompokkan menurut halaman

Untuk jumlah yang akurat, Anda harus menghapus dimensi kueri dan halaman, 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: Secara opsional, sertakan country dan/atau device.
type: Menghitung lebih dari setiap nilai type seperti yang diinginkan dalam kueri terpisah.
aggregationType: Harus byPage.

Untuk detail yang lebih lengkap, termasuk informasi halaman dan/atau kueri, dengan mengorbankan 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: Sertakan page. Secara opsional, sertakan kombinasi query, country, atau device.
type: Menghitung lebih dari setiap nilai type seperti yang diinginkan dalam kueri terpisah.

Dikelompokkan menurut properti

Untuk mendapatkan jumlah yang 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: Secara opsional, sertakan country dan/atau device.
type: Secara opsional, enumerasi setiap nilai type sesuai keinginan dalam kueri terpisah.

Untuk mengetahui detail yang lebih lengkap, termasuk informasi kueri, negara, dan/atau perangkat, dengan mengorbankan 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 kombinasi query, country, atau device.
type: Mengurutkan setiap nilai type sesuai keinginan 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 menurut 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 dengan dimensi lainnya. Oleh karena itu, jika ingin melihat informasi tampilan penelusuran untuk situs Anda, Anda harus mengikuti proses ini:

Tentukan searchAppearance sebagai satu-satunya dimensi, yang akan mengelompokkan semua data menurut jenis tampilan penelusuran tanpa dimensi lain.
Atau, jalankan kueri kedua, filter menurut salah satu jenis tampilan penelusuran yang tercantum di 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 di 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 di langkah 1, beserta dimensi yang Anda inginkan (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"
        }
      ]
    }
  ]
}