Halaman ini diterjemahkan oleh Cloud Translation API.

Mendapatkan data kinerja Anda

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

Anda harus memilih informasi yang diinginkan dalam data Anda: jenis penelusuran yang mana (web, gambar, video, dll.) dan dimensi apa (halaman, kueri, negara, atau perangkat), serta apakah akan mengelompokkan hasil menurut halaman atau properti. Saat membuat kueri untuk halaman dan/atau string kueri, 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 ini. Menjalankan kueri harian 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. 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 ingin Anda.

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 maksimal 50 ribu baris data per hari per jenis penelusuran (web, gambar, dan sebagainya, yang diurutkan berdasarkan klik).

Detail kueri

Anda dapat membuat kueri untuk 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 baik, 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: Menyertakan page. Secara opsional, sertakan kombinasi query, country, atau device.
type: Menghitung lebih dari setiap nilai type seperti yang diinginkan dalam kueri terpisah.

Dikelompokkan berdasarkan properti

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"

startDate / endDate: Pilih periode satu hari dengan memilih tanggal yang sama.
dimensions: Secara opsional, sertakan country dan/atau device.
type: Jika perlu, sebutkan di atas setiap nilai type seperti yang diinginkan 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: Menghitung lebih dari setiap nilai type 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?

Ketika Anda mengelompokkan berdasarkan halaman dan/atau kueri, sistem kami mungkin menghapus beberapa data agar dapat menghitung hasil dalam waktu yang wajar menggunakan jumlah sumber daya 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, Anda harus mengikuti proses berikut:

Tentukan searchAppearance sebagai satu-satunya dimensi, yang akan mengelompokkan semua data menurut jenis tampilan penelusuran tanpa dimensi lain.
Jika perlu, jalankan kueri kedua, yang memfilter menurut salah satu jenis tampilan penelusuran yang tercantum di langkah 1, dengan menambahkan 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 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
  },
...