Struktur Reporting API Search Ads 360

Komponen utama Search Ads 360 Reporting API adalah resource dan layanan. Resource mewakili entitas Search Ads 360 dan Anda menggunakan layanan untuk mengambil entitas Search Ads 360.

Hierarki objek

Akun Search Ads 360 adalah hierarki objek.

  • Resource tingkat teratas 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 resource lain dalam kampanye. Anda juga dapat menentukan anggaran dan tanggal seluruh kampanye.

Resource

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 dengan ID-nya sendiri. Beberapa ID bersifat unik secara global, yaitu di semua akun Search Ads 360, sementara ID lainnya hanya bersifat 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 AdGroupCriterion Grup Iklan

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

Setiap pasangan CampaignId / CriterionId 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 Daftar Pengguna 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 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 menggabungkan resource dan induknya ke dalam sebuah jalur.

Misalnya, nama resource kampanye 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 terpadu tunggal untuk mengambil semua objek resource dan statistik performa. Class ini menyediakan dua metode: Search dan SearchStream. Kedua metode ini memerlukan kueri yang menentukan resource yang akan dikueri, atribut resource dan metrik performa yang akan diambil, predikat yang akan digunakan untuk memfilter permintaan, serta segmen yang akan digunakan untuk memperinci statistik performa lebih lanjut. Lihat 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 untuk resource, kolom resource, kunci segmentasi, dan metrik yang tersedia dalam metode penelusuran SearchAds360Service. Lihat 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 meliputi: