Menulis dan menjalankan kueri

Membuat kueri

Catatan: Tidak semua pengguna dapat membuat dan mengedit kueri. Pelajari lebih lanjut kontrol akses di Ads Data Hub.

1. Buka tab Kueri di Ads Data Hub.
2. Klik + Buat kueri. Halaman Template kueri analisis akan terbuka.
3. Opsional: Lihat pratinjau SQL template dengan mengklik Luaskan.
4. Pilih template yang ingin Anda gunakan dengan mengklik Gunakan template, atau klik Kosong untuk memulai dari awal.
5. Masukkan nama untuk laporan Anda.
6. Tulis atau edit kueri menggunakan SQL yang kompatibel dengan BigQuery. Anda dapat menemukan tabel dan kolom yang tersedia serta menyisipkannya ke dalam SQL dari tab Tabel Google.
7. Opsional: Konfigurasi parameter.
8. Opsional: Konfigurasi ringkasan baris yang difilter.
9. Klik Simpan.

Parameter

Parameter membuat kueri lebih fleksibel. Misalnya, Anda mungkin ingin menjalankan kueri yang sama di berbagai kampanye. Daripada membuat kueri duplikat atau meng-hardcode ID kampanye sebelum setiap eksekusi, Anda dapat mengonfigurasi parameter yang menerima satu atau beberapa ID kampanye untuk dimasukkan dari kartu Jalankan saat Anda menjalankan kueri. Dengan menggunakan parameter, kode Anda tetap bersih, mengurangi kemungkinan terjadinya error saat pengeditan, dan memungkinkan kueri Anda digunakan kembali tanpa pengeditan. Parameter dicakup ke kueri tempat parameter dibuat, sehingga Anda dapat menggunakan kembali nama parameter dalam kueri lain.

Jenis parameter

Jenis parameter berikut diizinkan:

• int64
• float64
• bool
• string
• date
• timestamp
• array, dari jenis yang diizinkan

Membuat parameter

1. Buka kueri tersimpan, atau buat kueri baru.
2. Klik Properti > Parameter > Tambahkan parameter.
3. Masukkan nama di kolom Name. Anda akan menggunakan nama ini untuk mereferensikan parameter dalam teks kueri.
4. Gunakan menu drop-down untuk memilih jenis parameter.
   • Jika Anda memilih array, menu drop-down tambahan akan muncul. Pilih jenis array di menu drop-down.
5. Opsional: Ulangi langkah 2-4 hingga Anda menambahkan semua parameter yang diinginkan.
6. Klik Simpan

Menggunakan parameter

Dalam teks kueri, gunakan format parameter SQL standar, yaitu mendahului nama parameter dengan @. Dalam contoh berikut, kueri berisi parameter yang disebut @campaign_ids:

  /* Parameters:
  * @campaign_ids (ARRAY of INT64): A list of campaign IDs
  *   to conduct analysis on */

  WITH user_reach AS (
  SELECT 
    user_id,
    count(*) AS num_views
  FROM 
    adh.google_ads_impressions
  WHERE 
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY 
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM 
    user_reach

Saat Anda menjalankan kueri, dialog Tugas baru akan berisi kolom Parameter. Masukkan nilai untuk setiap parameter yang telah Anda tetapkan.

Menghapus parameter

1. Buka kueri yang memiliki parameter yang ingin Anda hapus.
2. Buka tab Properti.
3. Di kartu Parameter, Klik hapus Hapus di samping parameter yang ingin dihapus.
4. Klik Simpan.

Parameter yang dicadangkan

Tabel berikut mencantumkan parameter yang dicadangkan oleh Ads Data Hub. Anda dapat menggunakan parameter ini dalam kueri, tetapi Anda tidak dapat membuat parameter dengan nama yang sama dengan parameter yang dicadangkan.

start_date	date Tanggal mulai (inklusif) untuk tugas kueri. Parameter yang ditentukan pengguna dengan nama ini akan diabaikan dan diganti dengan nilai yang ditetapkan dalam dialog Pekerjaan baru.
end_date	date Tanggal akhir (inklusif) untuk tugas kueri. Parameter yang ditentukan pengguna dengan nama ini akan diabaikan dan diganti dengan nilai yang ditetapkan dalam dialog Pekerjaan baru.
time_zone	string Zona waktu untuk tugas kueri. Parameter yang ditentukan pengguna dengan nama ini akan diabaikan dan diganti dengan nilai yang ditetapkan dalam dialog Pekerjaan baru. Tips: Untuk mencegah perbedaan saat menggunakan zona waktu dalam kueri, seperti dalam klausa WHERE, Anda dapat menggunakan time_zone agar sesuai dengan zona waktu yang ditetapkan di Tugas baru. Anda juga harus menggunakan zona waktu yang sama dengan sumber data.
params	string Namespace untuk penamaan tabel yang diekspor. Gunakan format berikut untuk membuat placeholder dalam kueri, lalu berikan nama tabel saat Anda menjalankan laporan: params.TABLE_NAME (jangan gunakan @ di depannya yang digunakan oleh parameter lain). Untuk mengetahui informasi selengkapnya dan contoh penggunaan parameter ini, lihat Mengekspor beberapa tabel menggunakan satu kueri.

Ringkasan baris yang difilter

Ringkasan baris yang difilter menghitung data yang difilter karena pemeriksaan privasi. Data dari baris yang difilter dijumlahkan dan ditambahkan ke baris umum. Meskipun data yang difilter tidak dapat dianalisis lebih lanjut, data tersebut memberikan ringkasan tentang jumlah data yang difilter dari hasil.

Catatan: Persyaratan agregasi berlaku untuk ringkasan baris yang difilter itu sendiri. Jika ringkasan baris yang difilter yang dihasilkan berada di bawah persyaratan agregasi, ringkasan baris yang difilter itu sendiri akan difilter.

Mengedit kueri

1. Buka tab Kueri di Ads Data Hub.
2. Klik nama kueri yang ingin Anda edit.
3. Edit kueri.
4. Klik Simpan.

Menjalankan kueri

Poin Penting: Anda harus menulis dan menguji kueri menggunakan sandbox sebelum menjalankannya pada data sebenarnya. Pelajari lebih lanjut praktik terbaik untuk menulis kueri di Ads Data Hub

Sebelum menjalankan kueri, pastikan Anda telah memberikan izin dataEditor akun layanan ke set data yang akan berisi output gabungan. Pelajari lebih lanjut kontrol akses di BigQuery.

1. Buka tab Kueri di Ads Data Hub.
2. Klik nama kueri yang ingin Anda jalankan.
3. Klik Run.
   • Perkiraan jumlah byte yang akan digunakan kueri ditampilkan di bagian atas halaman.
4. Pilih ID di kolom Data iklan dari. Ini harus berupa ID akun yang terkait dengan data iklan yang ingin Anda kueri. (Jika Anda ingin membuat kueri data sandbox, pilih ADH Sandbox Customer.)
5. Jika menggunakan tabel kecocokan, pilih tabel kecocokan di kolom Tabel kecocokan dari.
6. Pilih mode privasi. Pelajari lebih lanjut mode privasi.
7. Tentukan tempat hasil kueri Anda harus disimpan di kolom Tabel tujuan.
8. Masukkan tanggal mulai dan akhir untuk menentukan rentang tanggal kueri Anda.
9. Masukkan zona waktu. Waktu ini harus cocok dengan zona waktu pintu masuk pembelian.
10. Opsional: Masukkan nilai untuk parameter apa pun.
11. Klik Run.

Melihat hasil penelusuran Anda

Setelah kueri selesai berjalan, Anda dapat melihat pratinjau hasilnya di halaman "Jobs". Anda juga dapat menjelajahi data di BigQuery, Spreadsheet, atau Data Studio.

Pratinjau

Klik Pratinjau dalam tugas yang telah selesai. 20 hasil pertama akan muncul di bawah tugas.

BigQuery

Hasil Anda diekspor ke BigQuery secara default. Klik Lihat tabel untuk membuka BigQuery di jendela baru.

Spreadsheet dan Data Studio

Buka menu dropdown Jelajahi, lalu pilih Jelajahi dengan Spreadsheet atau Jelajahi dengan Data Studio dari opsi. Tindakan ini akan membuka data di jendela baru.