Membuat dan menjalankan laporan

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

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

Membuat laporan

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

Penting: Untuk mencegah hilangnya perubahan, klik Simpan setelah melakukan 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.
   • Konfigurasikan parameter di tab Properti.
   • Lihat daftar tabel dan kolom yang tersedia di tab Tabel Google.
   • Lihat daftar tabel pihak pertama yang diimpor dan skema tabelnya di tab tabel pihak pertama.
   • Jalankan kueri SQL dengan mengklik Run. Perhatikan bahwa eksekusi yang dimulai dari editor kueri SQL tidak berkontribusi pada histori eksekusi laporan, dan tidak akan muncul 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 parameter value di kartu Penyiapan.
7. Konfigurasikan input dan output untuk tugas yang dijalankan di laporan ini:
   • Pilih sumber data di kolom Data iklan dari. ID ini harus berupa ID akun Ads Data Hub yang dikaitkan dengan data iklan yang ingin Anda kueri. (Jika Anda ingin membuat kueri data sandbox, pilih ADH Sandbox Customer.)
   • Jika menggunakan tabel pencocokan, pilih tabel pencocokan di kolom Akun tabel pencocokan.
   • Pilih rentang tanggal dan zona waktu untuk laporan. Zona waktu laporan harus sesuai 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 dan konfigurasikan ringkasan baris yang difilter.
   • Pilih project, set data, dan tabel BigQuery tempat hasil laporan Anda akan disimpan.
8. Opsional: Tetapkan laporan Anda untuk dijalankan sesuai jadwal.
9. Klik Simpan.

---

Parameter

Parameter memungkinkan Anda menentukan cara laporan tertentu dijalankan. 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 membagikan kueri atau template SQL yang sama pada kumpulan ID kampanye yang berbeda dengan mengonfigurasi parameter dan menetapkan nilainya di bagian Penyiapan pada halaman detail laporan. Penggunaan parameter akan menjaga kode SQL Anda tetap bersih, mengurangi kemungkinan terjadinya error melalui pengeditan, dan memungkinkan penggunaan kembali kueri SQL yang sama di seluruh laporan tanpa mengedit nilai di SQL itu sendiri.

Dalam contoh berikut, laporan berisi parameter yang disebut campaign_ids, yang menerima array dari 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-jenis parameter

Jenis parameter berikut diizinkan:

• int64
• float64
• bool
• string
• date
• timestamp
• array (dari jenis apa pun 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 Nama. 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 parameternya telah dikonfigurasi.
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 parameternya telah dikonfigurasi.
2. Klik Edit kueri untuk membuka editor SQL.
3. Di bagian Properties, klik hapus Delete di samping parameter yang ingin dihapus.
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 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 Tugas 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 Tugas 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 Tugas baru. Tips: Untuk mencegah perbedaan saat menggunakan zona waktu dalam laporan Anda, seperti dalam klausa WHERE, Anda dapat menggunakan time_zone untuk mencocokkan zona waktu yang ditetapkan di Tugas baru. Penting juga untuk menggunakan zona waktu yang sama dengan sumber data.

---

Ringkasan baris yang difilter

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

Baris yang difilter meringkas data yang difilter karena perbedaan pemeriksaan. Data dari baris yang difilter dijumlahkan dan ditambahkan ke baris generik. Meskipun data yang difilter tidak dapat dianalisis lebih lanjut, data tersebut memberikan ringkasan jumlah data yang difilter dari hasil. Untuk kueri yang menggunakan fitur perbedaan dalam pemeriksaan mode privasi, Ads Data Hub 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 mengonfigurasinya 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 di data sebenarnya. Pelajari lebih lanjut praktik terbaik untuk menulis kueri di Ads Data Hub

Sebelum menjalankan laporan, pastikan Anda telah memberikan izin akun layanan dataEditor ke set data yang akan berisi output join Anda. 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 + Tetapkan jadwal.
4. Di panel Jadwal, klik tombol Jadwalkan laporan ini untuk dijalankan dengan detail di bawah ke posisi aktif.
5. Di bagian Frequency, pilih interval dan waktu, lalu masukkan zona waktu.
   • Sebagai gantinya, 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 Home, pilih Anyone dari daftar filter Owner.

---

Melihat hasil

Setelah laporan selesai berjalan, 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 Preview di dalam tugas yang sudah selesai. 20 hasil pertama akan muncul di bawah tugas.

BigQuery

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

Spreadsheet dan Data Studio

Buka menu drop-down Explore, lalu pilih Explore with Sheets atau Explore with Data Studio dari opsi. Tindakan ini akan membuka data di jendela baru.