Pembuat Kueri Google Ads

Pembuat Kueri Google Ads adalah alat interaktif yang dirancang untuk membantu Anda membuat dan memvalidasi kueri secara interaktif menggunakan Bahasa Kueri Google Ads (GAQL). Baik Anda baru menggunakan GAQL atau 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 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.
  • Mengurangi error: Dengan menyediakan antarmuka terstruktur dan menu drop-down opsi yang valid, fitur ini membantu mencegah error sintaksis dan kesalahan 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: Anda mulai dengan memilih resource utama dari tab Referensi untuk versi yang ingin Anda kueri. Resource ini akan berada dalam klausa FROM. Resource mewakili entitas dalam Google Ads, seperti campaign, ad_group, atau keyword_view. Pembangun 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. Penyusun membantu Anda memilih kolom, operator, dan nilai, sambil memastikan sintaksis yang benar.
  4. Urutkan hasil: Tentukan urutan pengurutan menggunakan klausa ORDER BY.
  5. Menetapkan 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 menautkan ke API Explorer sehingga Anda dapat menguji kueri terhadap data akun Anda. Ada juga [Validator Kueri](link to page) terpisah tempat Anda dapat menempel dan memeriksa kueri GAQL yang ditulis secara manual.
  7. Mengekspor: Setelah puas dengan kueri, salin dan tempel string GAQL yang telah diuji dan benar secara sintaksis ke 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 pada metadata pokok Google Ads API.

Mulai

Ada dua cara untuk membuka Pembuat Kueri. Salah satu opsi 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 di daftar semua resource. Atau, buka resource langsung dari panel navigasi kiri.
  2. Klik Bantu buat kueri, yang akan mengarahkan Anda ke Pembuat Kueri untuk resource tertentu tersebut.

Dari halaman ringkasan Query Builder

Buka bagian Query Builder di dokumen referensi pelaporan dan pilih resource yang ingin Anda jelajahi.

Integrasi dengan alat lain

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

Penjelajah API

Setelah membuat kueri, klik Try in API Explorer untuk membuka kueri di API Explorer. Kueri Anda akan otomatis diisi di 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. Kueri apa pun yang dibuat sepenuhnya melalui Pembuat Kueri akan memiliki sintaksis yang benar, tetapi jika Anda sudah memahami resource yang Anda kueri, Validator Kueri akan memberikan cara cepat untuk memasukkan kueri dan memeriksa validitasnya. Lihat Validator Kueri untuk mengetahui informasi selengkapnya tentang alat tersebut.