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.

Telusuri layanan

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 metriknya yang terkait. Ada dua metode, Search dan SearchStream.

Kueri SearchAds360Service menampilkan daftar instance SearchAds360Row:

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

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 detail tentang kompatibilitas dan jenisnya.

SearchAds360FieldService menampilkan daftar instance SearchAds360Field:

  • Setiap kolom berisi detail tentang kolom yang diminta.

Baca bagian Mengambil metadata resource untuk mempelajari lebih lanjut.

Contoh kueri dasar

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

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).
  • Kueri mengurutkan berdasarkan ID kampanye.

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

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.
  • Setiap SearchAds360Row yang ditampilkan memiliki kolom metrics yang diisi dengan metrik yang dipilih.
  • Kueri mengurutkan berdasarkan ID kampanye.

Lihat metrics untuk metrik lain yang tersedia yang dapat Anda gunakan di 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.
  • Ini mengelompokkan data berdasarkan tanggal.
  • Sebagai hasil dari segmentasi tersebut, setiap SearchAds360Row mewakili tuple kampanye dan segmen tanggal.
  • Kueri mengurutkan berdasarkan ID kampanye.

Lihat segments untuk melihat daftar segmen yang dapat Anda gunakan dalam kueri dan Segmentasi untuk informasi lebih lanjut tentang segmentasi laporan Anda.

Ini adalah kueri dasar pada 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 teratribusi 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 REFERENSI ATAU KOLOM dengan resource (seperti, customer atau campaign) atau kolom (seperti, campaign.id, metrics.impressions, atau ad_group.id).

Baca bagian Mengambil metadata resource untuk mengetahui informasi lebih lanjut tentang cara mengambil metadata kolom.

Pelajari lebih lanjut

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