Komponen utama Search Ads 360 Reporting API adalah resource dan layanan. Resource merepresentasikan entity Search Ads 360 dan Anda menggunakan layanan untuk mengambil entity Search Ads 360.
Hierarki objek
Akun Search Ads 360 adalah hierarki objek.
Resource tingkat teratas dari akun adalah pelanggan.
Setiap akun berisi satu atau beberapa kampanye aktif.
Setiap
Campaign
berisi satu atau beberapa grup iklan yang mengelompokkan iklan Anda ke dalam koleksi logis.Setiap
AdGroup
berisi satu atau beberapa iklan grup iklan.Anda dapat melampirkan satu atau beberapa
AdGroupCriterion
atauCampaignCriterion
ke grup iklan atau kampanye. Kriteria menentukan cara iklan dipicu.- Ada banyak jenis kriteria, seperti kata kunci, rentang usia, dan lokasi. Kriteria yang ditentukan di tingkat kampanye memengaruhi semua sumber daya lain di dalam kampanye. Anda juga dapat menentukan anggaran dan tanggal untuk seluruh kampanye.
Referensi
Resource mewakili entitas di akun Search Ads 360 Anda. Contoh
resource mencakup Customer
, Campaign
, dan AdGroup
.
ID Objek
Setiap objek di Search Ads 360 diidentifikasi oleh ID-nya sendiri. Beberapa ID bersifat unik secara global, yaitu di semua akun Search Ads 360, sedangkan yang lainnya hanya unik dalam cakupan terbatas.
Cakupan keunikan ID objek | |
---|---|
ID Anggaran | Global |
ID kampanye | Global |
Nomor Grup Iklan | Global |
ID iklan | Grup IklanSetiap pasangan AdGroupId / AdId bersifat unik secara global. |
ID Kriteria GrupIklan | Grup IklanSetiap pasangan AdGroupId / CriterionId bersifat unik secara global. |
ID Kriteria Kampanye | KampanyeSetiap pasangan CampaignId / CriterionId bersifat unik secara global. |
Ekstensi Iklan | KampanyeSetiap pasangan CampaignId / AdExtensionId bersifat unik secara global. |
ID Feed | Global |
ID Item Feed | Global |
ID Atribut Feed | Feed |
ID Pemetaan Feed | Global |
ID Label | Global |
ID DaftarPengguna | Global |
Aturan ID ini dapat berguna saat mendesain penyimpanan lokal untuk objek Search Ads 360 Anda.
Jenis objek
Beberapa objek dapat digunakan untuk beberapa jenis entity. Jika demikian, objek
akan berisi kolom type
yang menjelaskan kontennya. Misalnya, AdGroupAd
dapat merujuk ke iklan teks, iklan hotel, atau iklan lokal.
Anda dapat mengakses nilai jenis melalui kolom AdGroupAd.ad.type
. Nilainya
ditampilkan dalam enum AdType
.
Nama resource
Setiap resource diidentifikasi secara unik oleh string resource_name
yang
menghubungkan resource dan induknya ke dalam jalur.
Nama resource kampanye, misalnya, memiliki bentuk:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Kampanye dengan ID 987654
di akun Search Ads 360 dengan ID pelanggan
1234567
, memiliki resource_name
:
customers/1234567/campaigns/987654
Layanan
Layanan memungkinkan Anda mengambil entitas dan metadata Search Ads 360. Ada tiga jenis layanan:
- Layanan penelusuran
SearchAds360Service
adalah layanan tunggal dan terpadu untuk mengambil semua objek resource dan statistik performa. Class ini menyediakan dua metode:Search
danSearchStream
. Kedua metode tersebut memerlukan kueri yang menentukan resource untuk melakukan kueri, atribut resource dan metrik performa yang akan diambil, predikat yang digunakan untuk memfilter permintaan, dan segmen yang akan digunakan untuk menguraikan lebih lanjut statistik performa. Lihat artikel Membuat laporan penelusuran dan Bahasa Kueri Search Ads 360 untuk mengetahui informasi selengkapnya.- Layanan lapangan
SearchAds360FieldService
mengambil metadata tentang resource, seperti atribut yang tersedia untuk resource dan jenis datanya. Anda dapat meminta katalog resource, kolom resource, kunci segmentasi, dan metrik yang tersedia dalam metode penelusuranSearchAds360Service
. Baca Mengambil metadata resource untuk mempelajari lebih lanjut.- Layanan khusus entitas
Layanan ini menyediakan metode permintaan
GET
yang mengambil satu instance resource. Hal ini berguna untuk memeriksa struktur resource.Contoh layanan khusus entitas mencakup:
- CustomColumnService yang menampilkan kolom kustom yang diminta secara mendetail.