Struktur Reporting API Search Ads 360

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 atau CampaignCriterion 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 Iklan

Setiap pasangan AdGroupId / AdId bersifat unik secara global.
ID Kriteria GrupIklan Grup Iklan

Setiap pasangan AdGroupId / CriterionId bersifat unik secara global.
ID Kriteria Kampanye Kampanye

Setiap pasangan CampaignId / CriterionId bersifat unik secara global.
Ekstensi Iklan Kampanye

Setiap 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 dan SearchStream. 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 penelusuran SearchAds360Service. 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: