Bahasa Kueri Search Ads 360

Bahasa Kueri Search Ads 360 memungkinkan Anda membuat kueri penelusuran untuk metadata resource dan data pelaporan 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 beserta atribut, segmen, dan layanan terkait dan metrik. Ada dua metode, Search dan SearchStream.

Kueri SearchAds360Service menampilkan daftar instance SearchAds360Row:

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

Lihat Membuat laporan penelusuran untuk 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 spesifikasi kompatibilitas dan jenisnya.

SearchAds360FieldService menampilkan daftar SearchAds360Field instance:

  • 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 dibuat kueri Anda sendiri.

Mengkueri 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 kolom resource_name).
  • Urutan kueri berdasarkan ID kampanye.

Lihat campaign untuk {i>field<i} lain yang tersedia, yang dapat Anda gunakan dalam kueri Anda.

Kueri untuk metrik

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

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 mengetahui metrik yang tersedia, dan dapat digunakan di kueri Anda.

Kueri untuk segmen

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

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 segmentasi, setiap SearchAds360Row mewakili tuple kampanye dan segmen tanggal.
  • Urutan kueri berdasarkan ID kampanye.

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

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

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

Lihat campaign untuk mengetahui resource atribusi mana yang tersedia untuk kueri kampanye.

Kueri untuk metadata kolom

Anda dapat menggunakan SearchAds360FieldService untuk mengambil metadata kolom.

Ini adalah kueri dasar untuk metadata kolom:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Ganti RESOURCE OR FIELD dengan salah satu sumber daya (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 kolom {i>metadata<i}.

Pelajari lebih lanjut

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