Bahasa Kueri Search Ads 360

Bahasa Kueri Search Ads 360 memungkinkan Anda membuat kueri penelusuran untuk mengambil data pelaporan dan metadata resource menggunakan Search Ads 360 Reporting API.

Layanan penelusuran

Anda dapat menggunakan Bahasa Kueri Search Ads 360 untuk membuat kueri API menggunakan:

SearchAds360Service

Gunakan layanan ini untuk membuat kueri resource serta atribut, segmen, dan metrik yang terkait. Ada dua metode, Search dan SearchStream.

Kueri SearchAds360Service menampilkan daftar instance SearchAds360Row:

  • Setiap baris mewakili resource.
  • Jika diminta, baris akan menyertakan atribut dan kolom metrik.
  • Jika Anda meminta segmen, baris tambahan akan disertakan untuk setiap tuple resource segmen.

Lihat Membuat laporan penelusuran untuk mengetahui informasi selengkapnya.

SearchAds360FieldService

Gunakan layanan ini untuk membuat kueri metadata tentang kolom dan resource yang tersedia. Layanan ini menyediakan katalog kolom yang dapat dikueri dengan detail tentang kompatibilitas dan jenisnya.

SearchAds360FieldService menampilkan daftar instance SearchAds360Field:

  • Setiap kolom berisi detail tentang kolom yang diminta.

Lihat Mengambil metadata resource untuk mempelajari lebih lanjut.

Contoh kueri dasar

Bagian berikut memberikan contoh kueri dasar yang dapat Anda sesuaikan untuk membuat kueri Anda sendiri.

Membuat kueri untuk atribut resource

Ini adalah kueri dasar untuk atribut resource campaign yang menampilkan ID, nama, dan status kampanye:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Setiap SearchAds360Row yang ditampilkan mewakili objek campaign.
  • Baris diisi dengan kolom yang dipilih (termasuk resource_name kampanye tertentu).
  • Urutan kueri menurut ID kampanye.

Lihat campaign untuk kolom lain yang tersedia yang dapat digunakan dalam kueri Anda.

Membuat kueri untuk metrik

Ini adalah kueri dasar untuk metrik yang terkait dengan atribut resource campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • Kueri menampilkan kampanye dengan status PAUSED dan lebih dari 1.000 tayangan iklan.
  • Setiap SearchAds360Row yang ditampilkan memiliki kolom metrics yang diisi dengan metrik yang dipilih.
  • Urutan kueri berdasarkan ID kampanye.

Lihat metrics untuk metrik lain yang tersedia, yang dapat Anda gunakan dalam kueri.

Kueri untuk segmen

Ini adalah kueri dasar untuk segmen yang terkait dengan atribut resource campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • Kueri menampilkan kampanye dengan status PAUSED dan lebih dari 1.000 tayangan iklan.
  • Mengelompokkan data berdasarkan tanggal.
  • Sebagai hasil dari segmentasi, setiap SearchAds360Row mewakili tuple kampanye dan segmen tanggal.
  • Urutan kueri menurut ID kampanye.

Lihat segments untuk mengetahui daftar segmen yang dapat Anda gunakan dalam kueri dan Segmentasi untuk mengetahui informasi selengkapnya tentang cara menyegmentasikan laporan.

Ini adalah kueri dasar tentang resource campaign yang menggabungkan atribut resource bidding_strategy, jika tersedia. Jenis resource terkait ini dikenal sebagai resource yang diatribusikan.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Kueri memilih atribut kampanye dan atribut terkait dari setiap kampanye yang dipilih.
  • Setiap SearchAds360Row yang ditampilkan mewakili objek campaign yang diisi dengan atribut kampanye yang dipilih, serta atribut strategi bidding yang dipilih, bidding_strategy.name.

Lihat campaign untuk mengetahui resource yang diatribusikan yang tersedia untuk kueri kampanye.

Kueri untuk metadata kolom

Anda dapat menggunakan SearchAds360FieldService untuk mengambil metadata kolom.

Berikut adalah kueri dasar untuk metadata kolom:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Ganti RESOURCE ATAU FIELD dengan resource (seperti, customer atau campaign) atau kolom (seperti, campaign.id, metrics.impressions, atau ad_group.id).

Lihat Mengambil metadata resource untuk mengetahui informasi selengkapnya tentang cara mengambil metadata kolom.

Pelajari lebih lanjut

Pelajari lebih lanjut cara membuat kueri di Search Ads 360 Reporting API: