Pembuat Kueri Google Ads

Pembuat Kueri Google Ads adalah alat interaktif yang dirancang untuk membantu Anda membuat dan memvalidasi kueri menggunakan Bahasa Kueri Google Ads (GAQL). Baik Anda baru mengenal GAQL maupun pengguna berpengalaman, Pembuat Kueri dapat menyederhanakan proses pengambilan data yang tepat yang Anda butuhkan dari Google Ads API.

Manfaat

  • Kemudahan penggunaan: Menyederhanakan proses penulisan kueri GAQL, tanpa perlu memahami sintaksis tertentu dan kolom yang tersedia.
  • Visibilitas: Membantu menjelajahi dan menemukan resource, kolom, segmen, dan metrik yang tersedia dalam model data Google Ads API.
  • Mengurangi error: Dengan menyediakan antarmuka terstruktur dan menu drop-down berisi opsi yang valid, fitur ini membantu mencegah error sintaksis dan salah ketik, sehingga memastikan kueri yang dihasilkan valid.
  • Pembuatan kueri yang lebih cepat: Mempercepat proses pengembangan dengan mengotomatiskan pembuatan string kueri.
  • Validasi: Alat ini ditautkan dengan API Explorer dan Query Validator, untuk memeriksa kueri terhadap aturan API sebelum dieksekusi.

Cara kerjanya

Pembuat Kueri Google Ads menyediakan antarmuka yang mudah digunakan untuk menyusun kueri GAQL secara visual. Berikut alur kerja dasarnya:

  1. Pilih resource: Mulailah dengan memilih resource utama dari tab Referensi untuk versi yang ingin Anda buat kuerinya. Resource ini ditempatkan dalam klausa FROM. Resource mewakili entitas dalam Google Ads, seperti campaign, ad_group, atau keyword_view. Builder mencantumkan semua resource yang tersedia.
  2. Pilih kolom: Setelah resource dipilih, alat ini akan menampilkan semua kolom yang dapat dipilih, termasuk atribut, segmen, dan metrik yang terkait dengan resource tersebut dan resource yang diatribusikan (dapat digabungkan secara implisit). Anda dapat mencentang kotak untuk menyertakan kolom dalam klausa SELECT. Saat Anda membuat pilihan, alat ini akan secara dinamis membuat string kueri GAQL yang sesuai, menampilkan error, dan memfilter kombinasi kolom yang tidak kompatibel.
  3. Terapkan filter: Tambahkan kondisi klausa WHERE untuk memfilter hasil. Builder membantu Anda memilih kolom, operator, dan nilai, sehingga memastikan sintaksis yang benar.
  4. Mengurutkan hasil: Tentukan tata urutan menggunakan klausa ORDER BY.
  5. Tetapkan batas: Tambahkan klausa LIMIT untuk mengontrol jumlah hasil yang ditampilkan.
  6. Validasi: Alat ini secara inheren memandu Anda menuju kombinasi kolom yang valid, dan juga menautkan ke API Explorer sehingga Anda dapat menguji kueri terhadap data akun Anda. Ada juga Query Validator terpisah tempat Anda dapat menempelkan dan memeriksa kueri GAQL yang ditulis secara manual.
  7. Ekspor: Setelah puas dengan kueri Anda, salin dan tempel string GAQL yang telah diuji dan benar secara sintaksis ke dalam permintaan klien GoogleAdsService.Search atau SearchStream Anda.

Builder memastikan bahwa kolom, segmen, dan metrik yang dipilih kompatibel dan dapat digunakan bersama dalam satu kueri, dengan merujuk pada metadata yang mendasari Google Ads API.

Mulai

Ada dua cara untuk membuka Query Builder: melalui halaman tertentu di dokumen referensi pelaporan, atau menjelajahi dari halaman ringkasan Query Builder.

Dari dokumen referensi pelaporan

  1. Mulailah dengan dokumen referensi pelaporan, dan pilih referensi tertentu untuk memulai di daftar semua referensi. Atau, buka langsung resource dari panel navigasi kiri.
  2. Klik Help me build a query, yang akan mengarahkan Anda ke Query Builder untuk resource tertentu tersebut.

Dari halaman utama Pembuat Kueri

Buka bagian Pembuat Kueri pada dokumen referensi pelaporan dan pilih resource yang ingin Anda pelajari.

Integrasi dengan alat lain

Pembuat Kueri terintegrasi dengan alat lain di Toolkit Developer Google Ads API. Anda dapat mengambil kueri yang dibuat di Pembuat Kueri dan mengujinya di API Explorer atau memvalidasinya dengan validator kueri.

Penjelajah API

Setelah membuat kueri, klik Try in API Explorer untuk membuka kueri Anda di API Explorer. Kueri Anda akan otomatis diisi dalam isi permintaan, lalu Anda dapat menguji kueri dengan menjalankannya terhadap data akun Anda. Lihat API Explorer untuk mengetahui informasi selengkapnya tentang alat tersebut.

Validator Kueri

Saat Anda mengklik Masukkan atau edit kueri, Validator Kueri akan terbuka. Gunakan Validator Kueri untuk memvalidasi sintaksis kueri Anda. Setiap kueri yang dibuat sepenuhnya melalui Pembuat Kueri sudah memiliki sintaksis yang benar, tetapi jika Anda sudah memahami resource yang dikueri, validator kueri menyediakan cara cepat untuk memasukkan kueri dan memeriksa validitasnya. Lihat Query Validator untuk mengetahui informasi selengkapnya tentang alat tersebut.