Menulis dan menjalankan kueri

Membuat kueri

  1. Buka tab Kueri di Ads Data Hub.
  2. Klik + Create query. Halaman Template kueri analisis akan terbuka.
  3. Opsional: Lihat pratinjau SQL template dengan mengklik Luaskan.
  4. Pilih template yang ingin digunakan 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 dan memasukkannya ke SQL dari tab Google Tables.
  7. Opsional: Konfigurasikan parameter.
  8. Opsional: Konfigurasikan ringkasan baris yang difilter.
  9. Klik Save.

Parameter

Parameter membuat kueri lebih fleksibel. Misalnya, Anda mungkin ingin menjalankan kueri yang sama pada kampanye yang berbeda. Daripada membuat kueri duplikat atau melakukan hardcode ID kampanye sebelum setiap eksekusi, Anda dapat mengonfigurasi parameter yang menerima satu atau beberapa ID kampanye untuk dimasukkan dari kartu Run saat Anda menjalankan kueri. Penggunaan parameter akan menjaga kode Anda tetap bersih, mengurangi peluang terjadinya error melalui pengeditan, dan memungkinkan kueri Anda digunakan kembali tanpa diedit. Parameter dicakup ke kueri tempat parameter tersebut dibuat, sehingga Anda dapat menggunakan kembali nama parameter dalam kueri lain.

Jenis-jenis parameter

Jenis parameter berikut diizinkan:

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array, dari jenis apa pun 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 Parameters. Masukkan nilai untuk setiap parameter yang telah Anda tetapkan.

Menghapus parameter

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

Parameter yang dicadangkan

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

start_date date

Tanggal mulai (termasuk) untuk tugas kueri. Parameter yang ditentukan pengguna dengan nama ini akan diabaikan dan diganti dengan nilai yang ditetapkan dalam dialog New job.

end_date date

Tanggal akhir (termasuk) untuk tugas kueri. Parameter yang ditentukan pengguna dengan nama ini akan diabaikan dan diganti dengan nilai yang ditetapkan dalam dialog New job.

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 New job.

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 generik. Meskipun data yang difilter tidak dapat dianalisis lebih lanjut, data tersebut memberikan ringkasan tentang berapa banyak data yang difilter dari hasil tersebut.

Mengedit kueri

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

Menjalankan kueri

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

  1. Buka tab Kueri di Ads Data Hub.
  2. Klik nama kueri yang ingin dijalankan.
  3. Klik Run.
    • Perkiraan jumlah byte yang akan digunakan kueri akan ditampilkan di bagian atas halaman.
  4. Pilih ID di kolom Data iklan dari. Nomor 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 pencocokan, pilih tabel pencocokan di kolom Match table from.
  6. Pilih mode privasi. Pelajari mode privasi lebih lanjut.
  7. Tentukan tempat untuk menyimpan hasil kueri di kolom Destination table.
  8. Masukkan tanggal mulai dan akhir untuk menentukan rentang tanggal kueri Anda.
  9. Masukkan zona waktu. Ini harus sesuai dengan zona waktu pintu pembelian.
  10. Opsional: Masukkan nilai untuk semua parameter.
  11. Klik Run.

Lihat hasil Anda

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

Pratinjau

Klik Preview di tugas yang sudah selesai. 20 hasil pertama akan muncul di bawah lowongan.

BigQuery

Hasil Anda diekspor ke BigQuery secara default. Klik View table untuk membuka BigQuery di jendela baru.

Spreadsheet dan Data Studio

Buka menu dropdown Explore dan pilih Explore with Sheets atau Explore with Data Studio dari opsi. Tindakan ini akan membuka data di jendela baru.