Membuat dan menjalankan laporan

Panduan ini mengajarkan cara membuat dan menjalankan laporan, serta cara melihat hasil.

Istilah Utama: Kueri adalah teks SQL yang menjadi dasar laporan. Laporan terdiri dari beberapa komponen, termasuk kueri, setelan input dan output, jadwal, dan detail eksekusi.

Membuat laporan

Analis dan pengguna super dapat membuat dan mengedit laporan. Pelajari lebih lanjut kontrol akses di Ads Data Hub.

Penting: Untuk mencegah hilangnya perubahan, klik Simpan setelah membuat pembaruan pada laporan, termasuk jadwal.

1. Di Ads Data Hub, buka halaman Laporan.
2. Klik + Buat laporan. Halaman Buat laporan baru akan terbuka.
   • Anda dapat memfilter template dengan menelusuri, memilih ikon produk, dan memilih opsi drop-down.
3. Pilih template, lalu klik Gunakan template, atau klik SQL untuk memulai dari awal.
   • Lihat pratinjau detail template dan SQL dengan mengklik expand_content Luaskan.
4. Untuk mengedit laporan, klik Edit kueri. Gunakan editor kueri untuk:
   • Sesuaikan laporan menggunakan SQL yang kompatibel dengan BigQuery.
   • Konfigurasi parameter di tab Properti.
   • Lihat daftar tabel dan kolom yang tersedia di tab Tabel Google.
   • Lihat daftar tabel pihak pertama yang diimpor dan skemanya di tab tabel pihak pertama.
   • Jalankan kueri SQL dengan mengklik Jalankan. Perhatikan bahwa eksekusi yang dimulai dari editor kueri SQL tidak berkontribusi pada histori eksekusi laporan, dan tidak akan ada di bagian Aktivitas terbaru di halaman Beranda.
   • Klik Selesai untuk mengonfirmasi perubahan pada kueri dan kembali ke halaman penyiapan laporan.
5. Masukkan nama untuk laporan Anda.
6. Jika berlaku, tetapkan nilai parameter di kartu Penyiapan.
7. Konfigurasi input dan output untuk tugas yang dijalankan pada laporan ini:
   • Pilih sumber data di kolom Data iklan dari. Ini harus berupa ID akun Ads Data Hub yang terkait dengan data iklan yang ingin Anda kueri. (Jika Anda ingin membuat kueri data sandbox, pilih ADH Sandbox Customer.)
   • Jika menggunakan tabel kecocokan, pilih tabel kecocokan di kolom Akun tabel kecocokan.
   • Pilih rentang tanggal dan zona waktu untuk laporan. Zona waktu laporan harus cocok dengan zona waktu akun iklan tertaut, seperti akun Google Ads. Catatan: Rentang tanggal kustom untuk pengujian kueri hanya didukung saat Anda menjalankan kueri dari layar editor SQL.
   • Opsional: Ubah setelan privasi Anda dan konfigurasi ringkasan baris yang difilter.
   • Pilih project, set data, dan tabel BigQuery tempat hasil laporan Anda harus disimpan.
8. Opsional: Tetapkan laporan Anda untuk dijalankan sesuai jadwal.
9. Klik Simpan.

---

Parameter

Parameter memungkinkan Anda menentukan cara menjalankan laporan tertentu. Saat menggunakan SQL untuk membuat laporan (atau saat mengedit SQL dari template laporan), parameter memungkinkan Anda menggunakan kembali kode SQL yang sama di seluruh laporan, dan menetapkan nilai parameter yang berbeda pada setiap salinan laporan. Misalnya, Anda dapat menjalankan dua laporan yang menggunakan kueri atau template SQL yang sama pada berbagai kumpulan ID kampanye dengan mengonfigurasi parameter dan menetapkan nilainya di bagian Penyiapan pada halaman detail laporan. Dengan menggunakan parameter, kode SQL Anda tetap bersih, mengurangi kemungkinan terjadinya error saat mengedit, dan memungkinkan kueri SQL yang sama digunakan kembali di seluruh laporan tanpa mengedit nilai dalam SQL itu sendiri.

Dalam contoh berikut, laporan berisi parameter bernama campaign_ids, yang menerima array ID kampanye int64:

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

  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

Jenis parameter

Jenis parameter berikut diizinkan:

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

Menambahkan parameter ke laporan

1. Buka laporan tersimpan, atau buat laporan baru.
2. Klik Edit kueri.
3. Di bagian Properti, klik Tambahkan parameter.
4. Masukkan nama di kolom Name. Anda akan menggunakan nama ini untuk mereferensikan parameter dalam teks laporan.
5. Gunakan menu drop-down untuk memilih jenis parameter.
   • Jika Anda memilih jenis array, menu drop-down tambahan akan muncul. Pilih jenis array di menu drop-down ini.
6. Dalam kueri SQL, tambahkan parameter menggunakan format parameter SQL standar: @PARAMETER_NAME. Lihat contoh yang mengikuti langkah-langkah ini.
7. Klik Selesai, lalu klik Simpan.

Menggunakan parameter

1. Buka laporan yang telah dikonfigurasi parameternya.
2. Di panel Penyiapan, masukkan nilai untuk setiap parameter yang telah Anda tentukan
3. Klik Simpan untuk mempertahankan nilai parameter.

Menghapus parameter

1. Buka laporan yang telah dikonfigurasi parameternya.
2. Klik Edit query untuk membuka editor SQL.
3. Di bagian Properti, klik hapus Hapus di samping parameter yang ingin Anda hapus.
4. Klik Selesai, lalu klik Simpan.

Parameter yang dicadangkan

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

start_date	date Tanggal mulai (inklusif) untuk tugas laporan. 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 laporan. 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 laporan. 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 laporan, seperti dalam klausa WHERE, Anda dapat menggunakan time_zone agar sesuai dengan zona waktu yang ditetapkan di Pekerjaan 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

Catatan: Ringkasan baris yang difilter tidak diperlukan saat Anda menggunakan mode derau. Pelajari manfaat menggunakan derau, bukan pemeriksaan perbedaan.

Ringkasan baris yang difilter menghitung data yang difilter karena pemeriksaan perbedaan. Data dari baris yang difilter dijumlahkan dan ditambahkan ke baris umum. Meskipun data yang difilter tidak dapat dianalisis lebih lanjut, data tersebut memberikan ringkasan jumlah data yang difilter dari hasil. Untuk kueri yang menggunakan mode privasi pemeriksaan perbedaan, Ads Data Hub akan otomatis mengaktifkan dan mengonfigurasi ringkasan baris yang difilter. Saat Anda mengedit kueri, Ads Data Hub akan otomatis menyesuaikan konfigurasi berdasarkan kolom yang dipilih. Untuk mempelajari ringkasan baris yang difilter lebih lanjut, atau untuk mengonfigurasi ringkasan baris yang difilter secara manual, lihat Ringkasan baris yang difilter.

---

Mengedit laporan

1. Di Ads Data Hub, buka halaman Laporan.
2. Klik nama laporan yang ingin Anda edit.
3. Buat perubahan pada laporan. Misalnya, edit SQL, kelola nilai parameter, atau tetapkan jadwal.
4. Klik Simpan.

---

Menjalankan laporan

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

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

1. Di Ads Data Hub, buka halaman Laporan.
2. Klik nama laporan yang ingin Anda jalankan.
3. Klik Run.

Menjalankan laporan sesuai jadwal

1. Di Ads Data Hub, buka halaman Laporan.
2. Klik nama laporan yang ingin Anda jadwalkan.
   • Untuk menetapkan jadwal laporan baru, buat laporan, lalu klik Simpan.
3. Klik + Setel jadwal.
4. Di panel Jadwalkan, klik tombol Jadwalkan laporan ini untuk dijalankan dengan detail di bawah ke posisi aktif.
5. Di bagian Frekuensi, pilih interval dan waktu, lalu masukkan zona waktu.
   • Untuk menggunakan ekspresi cron, klik tombol Tetapkan jadwal menggunakan ekspresi cron ke posisi aktif, lalu masukkan ekspresi di kotak.
6. Klik Selesai.
7. Klik Simpan untuk menerapkan perubahan pada laporan.

Untuk menampilkan tugas terjadwal di halaman Beranda, pilih Siapa saja dari daftar filter Pemilik.

---

Melihat hasil penelusuran Anda

Setelah laporan selesai dijalankan, Anda dapat melihat pratinjau hasilnya di halaman detail laporan. Untuk melihat hasilnya di lain waktu, buka laporan dari halaman Beranda. 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 drop-down Jelajahi, lalu pilih Jelajahi dengan Spreadsheet atau Jelajahi dengan Data Studio dari opsi. Tindakan ini akan membuka data di jendela baru.