Validator Kueri Google Ads

Google Ads Query Validator 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 menemukan error sintaksis, ketidakcocokan kolom, dan masalah lainnya sejak awal proses pengembangan.

Manfaat

  • Pencegahan error: Menemukan kueri yang tidak valid sejak 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 resource terkait satu sama lain.
  • Proses debug kueri: Memberikan pesan error tertentu saat kueri tidak valid, yang 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 ditujukan untuk gagal.

Cara kerjanya

Query Validator mengurai kueri GAQL Anda berdasarkan skema Google Ads API dan aturan yang ditentukan dalam Google Ads Query Language. Alat 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 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 ini akan mengonfirmasinya. Jika masalah ditemukan, alat ini akan memberikan pesan error yang dirancang untuk membantu menentukan masalah, terkadang menawarkan saran perbaikan, seperti resource yang kompatibel untuk metrik tertentu.

Mulai

Untuk menggunakan Google Ads Query Validator:

  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 sukses menunjukkan bahwa kueri valid. Jika tidak, pesan error yang menjelaskan masalah akan ditampilkan. Pesan error akan memandu Anda untuk mengoreksi kueri. Misalnya, error ketidakcocokan kolom dapat mencantumkan resource alternatif yang *kompatibel* dengan metrik atau segmen yang ingin Anda kueri.

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