Validator Kueri Google Ads

Validator Kueri Google Ads adalah alat interaktif yang dirancang untuk membantu developer membuat dan memverifikasi kueri Google Ads Query Language (GAQL) sebelum mengintegrasikannya ke dalam aplikasi. Alat ini memungkinkan Anda memasukkan string kueri GAQL dan menerima masukan langsung tentang validitasnya, sehingga membantu mendeteksi error sintaksis, ketidakcocokan kolom, dan masalah lainnya sejak awal proses pengembangan.

Manfaat

  • Pencegahan error: Menemukan kueri tidak valid lebih awal, sebelum diintegrasikan ke dalam aplikasi, sehingga mengurangi error runtime dan kegagalan panggilan API.
  • Pengembangan yang lebih cepat: Memungkinkan pengujian dan proses debug pernyataan GAQL yang cepat tanpa overhead siklus permintaan dan respons API lengkap.
  • Memahami batasan GAQL: Membantu developer mempelajari aturan kompleks tentang kolom mana yang kompatibel dan bagaimana hubungan antar-resource.
  • Men-debug kueri: Memberikan pesan error tertentu saat kueri tidak valid, sering kali lebih mendetail daripada error API umum, dan terkadang menyarankan alternatif yang valid.
  • Efisiensi resource: Menghindari panggilan API yang tidak perlu dengan kueri yang pasti gagal.

Cara kerjanya

Validator Kueri mengurai kueri GAQL Anda berdasarkan skema Google Ads API dan aturan yang ditentukan dalam Bahasa Kueri Google Ads. Fungsi ini menggunakan metadata, yang sebagian besar dapat diakses dari GoogleAdsFieldService, untuk melakukan pemeriksaan, termasuk:

  1. Sintaksis dan struktur: Memastikan kueri mengikuti tata bahasa GAQL yang benar, termasuk penggunaan dan urutan klausa yang tepat seperti SELECT, FROM, WHERE, ORDER BY, dan LIMIT.
  2. Validitas kolom: Memeriksa apakah semua kolom yang ditentukan (resource, segmen, metrik) ada dan dieja dengan benar.
  3. Kompatibilitas resource: Memverifikasi bahwa kolom yang dipilih dalam klausa SELECT kompatibel dengan resource utama yang ditentukan dalam klausa FROM.
  4. Kompatibilitas segmen dan metrik: Memastikan bahwa segmen dan metrik yang digunakan bersama dalam kueri yang sama kompatibel satu sama lain dan dengan resource dalam klausa FROM.
  5. Persyaratan klausa: Memvalidasi aturan seperti persyaratan untuk kolom tertentu yang digunakan dalam klausa WHERE atau ORDER BY agar juga ada dalam klausa SELECT.
  6. Penggunaan operator: Memeriksa penggunaan operator yang benar dalam kondisi klausa WHERE.

Jika kueri valid, alat akan mengonfirmasinya. Jika masalah ditemukan, alat ini akan memberikan pesan error yang dirancang untuk membantu menunjukkan masalah, terkadang menawarkan saran perbaikan, seperti resource yang kompatibel untuk metrik tertentu.

Mulai

Untuk menggunakan Validator Kueri Google Ads:

  1. Buka Query Validator.
  2. Masukkan kueri GAQL Anda.
  3. Klik tombol Validasi Kueri.
  4. Tinjau pesan validasi yang muncul di bawah widget Query Validator. Pesan berhasil menunjukkan bahwa kueri valid. Jika tidak, pesan error yang menjelaskan masalah akan ditampilkan. Pesan error akan memandu Anda memperbaiki kueri. Misalnya, error ketidakcocokan kolom dapat mencantumkan resource alternatif yang *kompatibel* dengan metrik atau segmen yang coba Anda kueri.

Untuk penjelasan yang lebih mendalam tentang konsep dan validasi GAQL, Anda juga dapat melihat panduan video GAQL.