Halaman ini diterjemahkan oleh Cloud Translation API.

Mendapatkan data performa Anda

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, menyertakan country dan/atau device.
type: Menghitung lebih dari setiap nilai type seperti yang diinginkan dalam kueri terpisah.
aggregationType: Harus byPage.

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: Menyertakan 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 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, menyertakan country dan/atau device.
type: Menghitung lebih dari setiap nilai type 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 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?

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