Struktur dan klausa kueri

Kueri terdiri dari sejumlah klausa: SELECT, FROM, WHERE, ORDER BY, LIMIT, dan PARAMETERS.

Klausul menggunakan nama kolom, nama resource, operator, kondisi, dan pengurutan yang digabungkan menjadi satu permintaan kueri.

Secara dasar, untuk membuat kueri, Anda:

• Menetapkan resource tempat data akan diambil.
• Tambahkan kolom dan metrik untuk menentukan data yang ingin ditampilkan.
• Tambahkan segmen untuk mengelompokkan hasil Anda.
• Tambahkan resource yang diatribusikan untuk menggabungkan data resource terkait secara implisit.
• Memfilter, mengurutkan, dan membatasi hasil.

Klausa SELECT

Klausul SELECT:

• Merupakan klausa wajib dalam kueri.
• Menentukan kumpulan kolom yang akan diambil dalam permintaan.
• Mengambil daftar kolom resource, kolom kustom, variabel Floodlight kustom, kolom segmen, dan metrik yang dipisahkan koma, lalu menampilkan nilai dalam respons.

Contoh kueri ini menunjukkan cara memilih atribut resource campaign:

SELECT
  campaign.id,
  campaign.name
FROM campaign

Beberapa jenis kolom

Anda dapat meminta jenis kolom yang berbeda dalam permintaan yang sama.

Contoh kueri di bawah ini menampilkan satu kueri dengan kombinasi:

• Kolom resource: campaign.id, campaign.name, bidding_strategy.id, dan bidding_strategy.name.
• Kolom segmen: segments.device dan segments.date.
• Kolom metrik: metrics.impressions dan metrics.clicks.

SELECT
  campaign.id,
  campaign.name,
  bidding_strategy.id,
  bidding_strategy.name,
  segments.device,
  segments.date,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Lihat Segmentasi untuk mempelajari lebih lanjut cara menyegmentasi laporan penelusuran.

Kolom resource utama

Biasanya, Anda akan menyertakan kolom resource utama dalam klausa SELECT, tetapi ini bersifat opsional (tidak wajib).

Contoh kueri ini menggunakan kolom resource utama (ad_group.status) untuk hanya memfilter hasil.

SELECT campaign.id
FROM ad_group
WHERE ad_group.status = PAUSED

Variabel Floodlight kustom

Anda dapat menyertakan variabel Floodlight kustom dalam klausa SELECT menggunakan ID-nya.

Dalam contoh ini, kueri menyertakan variabel kustom dengan ID 123454321 untuk resource kampanye.

SELECT
  conversion_custom_metrics.id[123454321]
FROM campaign

SELECT
  conversion_custom_dimensions.id[123454321]
FROM campaign

Kolom kustom

Anda dapat menyertakan kolom kustom dalam klausa SELECT menggunakan ID-nya.

Dalam contoh ini, kueri menyertakan kolom kustom dengan ID 12345678 untuk resource kampanye.

SELECT
  custom_columns.id[12345678]
FROM campaign

Lihat cara mendapatkan ID kolom kustom.

Kolom metrik

Anda dapat memilih kolom metrik untuk resource tertentu tanpa menyertakan kolom lain dari resource dalam klausa SELECT.

Contoh kueri ini memilih metrik impressions dan clicks untuk resource campaign.

SELECT
  metrics.impressions,
  metrics.clicks
FROM campaign

Lihat metrics untuk melihat daftar kolom metrik yang dapat Anda gunakan dalam kueri.

Kolom segmen

Anda dapat memilih kolom segmen tanpa menentukan kolom resource atau metrik yang menyertainya dalam klausa SELECT.

Contoh kueri ini mengelompokkan hasil menurut perangkat.

SELECT segments.device
FROM campaign

Lihat segments untuk mengetahui daftar kolom segmen yang dapat Anda gunakan dalam kueri.

Kolom terlarang

Anda tidak dapat menggunakan kolom berikut dalam klausa SELECT:

• Kolom yang tidak dapat dipilih, yaitu kolom dengan atribut metadata Selectable yang ditandai sebagai false.
• Kolom berulang, yaitu kolom dengan atribut metadata Repeated ditandai sebagai true.
• Kolom yang tidak tersedia untuk resource yang ditentukan dalam klausa FROM. Atribut beberapa resource tidak dapat dipilih bersama. Beberapa resource hanya menyediakan subset dari semua metrik dan segmen.
• Segmen atau metrik yang tidak kompatibel. Lihat Segmentasi untuk informasi selengkapnya.

Lihat Dokumentasi referensi untuk mengetahui detail tempat menemukan informasi ini untuk setiap resource.

Klausa FROM

Klausul FROM:

• Merupakan klausa wajib untuk kueri ke SearchAds360Service (baik metode Search maupun SearchStream).
• Tidak boleh disertakan untuk kueri ke SearchAds360FieldService.
• Menentukan resource utama yang ditampilkan kueri.
• Hanya dapat menentukan satu resource.
• Menentukan kolom yang dapat Anda gunakan di semua klausa lain dalam kueri.

Catatan: Ada kolom pilihan Ya/Tidak pada setiap halaman resource di bagian Reference yang memfilter kolom resource, kolom segmen, dan kolom metrik yang tidak dapat digunakan saat resource ditentukan dalam klausa FROM.

Resource yang diatribusikan

Jika resource yang diatribusikan tersedia, resource tersebut akan digabungkan secara implisit dengan resource yang Anda tentukan dalam klausa FROM. Anda hanya perlu menambahkan atributnya ke klausa SELECT untuk menampilkan nilainya.

Contoh kueri ini menampilkan ID grup iklan dan ID kampanye, karena campaign adalah resource yang diatribusikan dari resource ad_group.

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

Catatan: Tidak semua resource memiliki resource yang diatribusikan. Bagian Reference menyertakan detail resource teratribusi yang tersedia dengan setiap resource.

Kolom resource_name

Kolom resource_name untuk resource utama dalam klausa FROM selalu ditampilkan.

Dalam contoh kueri ini, ad_group.resource_name akan disertakan dalam respons meskipun tidak dipilih secara eksplisit dalam kueri:

SELECT ad_group.id
FROM ad_group

Kolom resource_name dari resource dengan atribut ditampilkan saat setidaknya satu kolom dipilih.

Dalam contoh kueri ini, campaign.resource_name akan disertakan dalam respons karena campaign.id dipilih:

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

Catatan: Jika resource dalam klausa FROM mencantumkan resource lain sebagai segment, memilih atribut resource tersebut akan bertindak sebagai segmen.

Klausa WHERE

Klausul WHERE:

• Merupakan klausa opsional dalam kueri.
• Menentukan kondisi untuk memfilter dan mengelompokkan data untuk permintaan. Kondisi mengikuti pola ini: FIELD_NAME OPERATOR VALUE (dipisahkan oleh ruang kosong).
• Dapat menyertakan beberapa kondisi yang dipisahkan dengan pemisah AND.

Contoh kueri ini menunjukkan cara menggunakan klausa WHERE untuk menampilkan metrik impressions selama jangka waktu tertentu:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Lihat Segmentasi untuk mempelajari lebih lanjut cara menyegmentasi laporan penelusuran.

Lihat Rentang tanggal untuk mempelajari lebih lanjut cara menentukan rentang tanggal dalam kueri Anda.

Filter menurut kolom resource_name

Anda dapat menggunakan kolom resource_name untuk memfilter atau mengurutkan data.

Contoh kueri ini menggunakan kolom campaign.resource_name untuk memfilter hasil menurut kampanye tertentu:

SELECT
  campaign.id,
  campaign.name
FROM campaign
WHERE campaign.resource_name = 'customers/1234567/campaigns/987654'

Beberapa kondisi

Anda dapat menggabungkan beberapa kondisi untuk memfilter data.

Contoh kueri ini meminta jumlah metrik clicks untuk semua kampanye dengan metrik impressions di perangkat seluler selama 30 hari terakhir.

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  metrics.clicks
FROM campaign
WHERE metrics.impressions > 0
  AND segments.device = MOBILE
  AND segments.date DURING LAST_30_DAYS

Catatan: Pemisah AND hanya dapat digunakan di antara kondisi operator (WHERE segments.device != "DESKTOP" AND segments.device != "MOBILE"), dan bukan dalam kondisi operator tunggal (WHERE segments.device != "DESKTOP" AND "MOBILE").

Lihat Segmentasi untuk mempelajari lebih lanjut cara menyegmentasikan laporan.

Kepekaan huruf besar/kecil

Saat memfilter nilai string, sensitivitas huruf besar/kecil default setiap operator berperan penting dalam memfilter hasil Anda dengan benar.

Tabel berikut menunjukkan sensitivitas huruf besar/kecil default setiap operator.

Kepekaan huruf besar/kecil default
=/!=	Case sensitive
IN/NOT IN	Case sensitive
LIKE/NOT LIKE	Case insensitive
CONTAINS (...)	Case sensitive
REGEXP_MATCH/NOT REGEXP_MATCH	Case sensitive

Anda dapat menggunakan pengubah (?i) untuk mengubah sensitivitas default REGEXP_MATCH dan NOT REGEXP_MATCH menjadi tidak peka huruf besar/kecil, misalnya:

SELECT campaign.id
FROM campaign
WHERE campaign.name REGEXP_MATCH "(?i).*test.*"

Baca Referensi tata bahasa kueri untuk mengetahui daftar lengkap operator yang dapat Anda gunakan untuk memfilter data.

Segmen tanggal inti

Kolom segmen berikut dikenal sebagai segmen tanggal inti: segments.date, segments.week, segments.month, segments.quarter, dan segments.year.

Anda dapat menggunakan segmen tanggal inti dalam klausa WHERE untuk menentukan tanggal atau jangka waktu.

Contoh kueri ini menentukan DURING LAST_30_DAYS untuk kolom segments.date dalam klausa WHERE:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Lihat Segmentasi > Segmen tanggal inti untuk informasi mendetail tentang penggunaan segmen tanggal inti.

Pemfilteran terlarang

Pemfilteran tidak diizinkan:

• Pada kolom segmen yang tidak dipilih, kecuali untuk segmen tanggal inti.
• Di kolom jenis pesan apa pun, kecuali primitif (misalnya, Int64Value, StringValue, dll.).
• Pada atribut kolom berulang dari jenis pesan apa pun, kecuali primitif (misalnya, Int64Value, StringValue, dll.).

Klausa ORDER BY

Klausul ORDER BY:

• Merupakan klausa opsional dalam kueri.
• Menentukan urutan tampilan hasil. Pengurutan mengikuti pola ini: FIELD_NAME ORDERING_OPTION (dipisahkan oleh spasi kosong).
• Memungkinkan dua opsi: ASC (menaik) atau DESC (menurun). Nilai defaultnya menaik.

Contoh kueri ini mengurutkan kampanye berdasarkan jumlah klik dalam urutan menurun (tertinggi ke terendah):

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
ORDER BY metrics.clicks DESC

Beberapa pemesanan

Anda dapat menentukan beberapa kolom dalam klausa ORDER BY menggunakan daftar yang dipisahkan koma. Hasilnya akan diurutkan dengan urutan yang sama seperti yang Anda tentukan dalam kueri.

Contoh kueri ini memilih data grup iklan, dan mengurutkan hasilnya dalam urutan menaik menurut nama kampanye, lalu dalam urutan menurun menurut jumlah tayangan, dan kemudian dalam urutan menurun menurut jumlah klik:

SELECT
  campaign.name,
  ad_group.name,
  metrics.impressions,
  metrics.clicks
FROM ad_group
ORDER BY
  campaign.name,
  metrics.impressions DESC,
  metrics.clicks DESC

Menggabungkan pengurutan dan batas

Anda dapat menggunakan klausa ORDER BY yang dikombinasikan dengan klausa LIMIT untuk menyaring hasil.

Contoh kueri ini menampilkan lima kampanye dengan tayangan tertinggi selama 30 hari terakhir:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Pemesanan terlarang

Pengurutan tidak diizinkan:

• Berdasarkan atribut resource yang tidak dipilih.
• Berdasarkan metrik yang tidak dipilih.
• Menurut segmen yang tidak dipilih.
• Untuk jenis kolom ini:
  • MESSAGE
  • Kolom berulang
  • Atribut kolom berulang.

Klausa LIMIT

Klausul LIMIT:

• Merupakan klausa opsional dalam kueri.
• Memungkinkan Anda membatasi jumlah hasil yang ditampilkan kueri.

Klausa ini berguna, misalnya, jika Anda hanya tertarik pada sampel atau ringkasan hasil.

Contoh kueri ini membatasi jumlah total hasil hingga 50:

SELECT
  campaign.name,
  ad_group.name,
  segments.device,
  metrics.impressions
FROM ad_group
ORDER BY metrics.impressions DESC
LIMIT 50

Klausul PARAMETERS

Klausa PARAMETERS memungkinkan Anda menentukan parameter meta untuk permintaan.

Sertakan draf

Parameter include_drafts mengontrol apakah entity draf disertakan dalam hasil atau tidak. Defaultnya adalah false. Tetapkan ke true untuk menyertakan entity draf.

Contoh kueri ini menampilkan kampanye draf dan kampanye reguler:

SELECT campaign.name
FROM campaign
PARAMETERS include_drafts=true

Hapus resource_name yang batal dipilih

Parameter omit_unselected_resource_names memungkinkan Anda mengecualikan kolom resource_name dari semua resource yang tidak diminta secara eksplisit dalam klausa SELECT Anda. Nilai default-nya adalah false. Jika Anda menetapkan parameter ini ke true, sebaiknya minta secara eksplisit nama resource dari resource utama dan resource apa pun yang diatribusikan dalam klausa SELECT.

Contoh kueri ini tidak menampilkan kolom campaign.resource_name maupun kolom customer.resource_name, karena kolom tersebut tidak disertakan dalam klausa SELECT:

SELECT
  campaign.name,
  customer.id
FROM campaign
PARAMETERS omit_unselected_resource_names = true

Contoh kueri ini menampilkan kolom campaign.resource_name, karena diminta secara eksplisit dalam klausa SELECT:

SELECT
  campaign.name,
  campaign.resource_name
FROM campaign
PARAMETERS omit_unselected_resource_names = true

Mengubah mata uang yang digunakan dalam metrik

Parameter metrics_currency memungkinkan Anda menentukan mata uang yang akan digunakan saat menghitung metrik yang disertakan dalam klausa SELECT. Setelan defaultnya adalah menggunakan mata uang lokal untuk akun. Jika menetapkan parameter ini, Anda harus menggunakan kode mata uang 3 karakter ISO 4217. Misalnya: USD, EUR.

Contoh kueri ini menampilkan metrik cost_micros dalam mata uang lokal akun.

SELECT
  campaign.name,
  metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"

Contoh kueri ini menampilkan metrik cost_micros dalam peso Cile (CLP).

SELECT
  campaign.name,
  metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"
PARAMETERS metrics_currency = "CLP"

Pelajari lebih lanjut

• Tata bahasa kueri