Pembuat Kueri Google Ads

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

Manfaat

  • Kemudahan penggunaan: Menyederhanakan proses penulisan kueri GAQL, tanpa memerlukan pemahaman tentang sintaksis tertentu dan kolom yang tersedia.
  • Kemudahan penemuan: Membantu menjelajahi dan menemukan resource, kolom, segmen, dan metrik yang tersedia dalam model data Google Ads API.
  • Pengurangan error: Dengan menyediakan antarmuka terstruktur dan menu dropdown opsi yang valid, alat 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

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

  1. Pilih resource: Anda mulai dengan memilih resource utama dari tab Referensi untuk versi yang ingin Anda kueri. Resource ini akan berada dalam klausa FROM. Resource mewakili entity 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 membuat string kueri GAQL yang sesuai secara dinamis, menampilkan error, dan memfilter kombinasi kolom yang tidak kompatibel.
  3. Terapkan filter: Anda dapat menambahkan kondisi klausa WHERE untuk memfilter hasil. Builder membantu Anda memilih kolom, operator, dan nilai, sehingga memastikan sintaksis yang benar.
  4. Urutkan hasil: Tentukan urutan pengurutan 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, tetapi juga ditautkan ke API Explorer sehingga Anda dapat menguji kueri terhadap data akun Anda. Ada juga Query Validator terpisah tempat Anda dapat menempel 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.

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

Mulai

Ada dua cara untuk membuka Query Builder. Salah satu opsinya adalah membuka halaman tertentu di dokumen referensi pelaporan, dan opsi lainnya adalah menjelajahi dari halaman ringkasan Pembuat Kueri.

Dari dokumen referensi pelaporan

  1. Mulai dengan dokumen referensi pelaporan, dan pilih resource tertentu untuk memulai dalam daftar semua resource. Atau, buka resource langsung dari panel navigasi kiri.
  2. Klik Bantu saya membuat kueri, yang akan membawa Anda ke Query Builder untuk resource tertentu tersebut.

Dari halaman utama Pembuat Kueri

Buka bagian Pembuat Kueri dari dokumen referensi pelaporan dan pilih resource yang ingin Anda jelajahi.

Integrasi dengan alat lain

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

API Explorer

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

Query Validator

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