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
danSearchStream
.Kueri
SearchAds360Service
menampilkan daftar instanceSearchAds360Row
:- 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 instanceSearchAds360Field
:- 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 objekcampaign
. - 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 kolommetrics
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.
Kueri untuk atribut resource terkait
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 objekcampaign
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
ataucampaign
) atau kolom (seperti,campaign.id
,metrics.impressions
, atauad_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: