Search Ads 360 Reporting API didasarkan pada platform modern dan memperkenalkan sejumlah konsep baru. Hal ini dijelaskan di bagian berikut.
Referensi
Objek resource menggantikan jenis laporan. Daripada meminta jenis laporan yang telah ditentukan, kini Anda dapat membuat kueri semua resource menggunakan bahasa kueri baru yang mirip SQL. Lihat struktur Search Ads 360 Reporting API untuk mempelajari lebih lanjut.
Pelaporan penelusuran
Penelusuran memiliki layanannya sendiri di API baru. Layanan Penelusuran menggantikan layanan Laporan lama. Semua kueri melewati
SearchAds360Service yang menyediakan dua metode, SearchStream dan Search,
untuk menelusuri serta mengambil data dan metrik pelaporan. Kedua metode penelusuran tersebut menampilkan semua objek SearchAds360Row yang cocok dengan kueri penelusuran Anda. Lihat
Membuat laporan penelusuran untuk mengetahui
informasi selengkapnya.
Metadata resource
SearchAds360FieldService memungkinkan Anda meminta katalog secara dinamis untuk resource, kolom resource, kunci segmentasi, dan metrik yang tersedia dalam
metode penelusuran SearchAds360Service. Baca bagian Mengambil metadata resource untuk mempelajari lebih lanjut.
Nama kolom
API memperkenalkan nama kolom bertingkat yang dipisahkan dengan notasi titik. Misalnya, campaign.id
dan ad_group.id. Anda juga dapat membuat bertingkat lebih lanjut, misalnya
ad_group.campaign.id. Lihat struktur Search Ads 360 Reporting API untuk mempelajari lebih lanjut.
Pelaporan di Search Ads 360 API versi sebelumnya didasarkan pada kolom terpisah pada entity yang berbeda untuk konsep yang serupa. Misalnya, laporan campaign dan adgroup menyertakan kolom campaignId
terpisah.
Bahasa kueri
API ini memperkenalkan Bahasa Kueri Search Ads 360. Bahasa ini fleksibel dan mirip SQL yang memungkinkan Anda menentukan kueri untuk mengambil data pelaporan spesifik yang paling sesuai dengan bisnis Anda. Lihat Bahasa Kueri Search Ads 360 untuk mempelajari lebih lanjut.
Mendapatkan permintaan
Di API baru, penelusuran memiliki layanannya sendiri (SearchAds360Service), tetapi
permintaan GET masih ada pada layanan spesifik masing-masing entitas. Misalnya, Anda
bisa mendapatkan informasi kolom kustom dari CustomColumnService. Lihat
Perubahan format di Search Ads 360 Reporting API untuk mempelajari lebih lanjut.
Kolom kustom
Di Search Ads 360 versi baru, kolom formula dan konversi kustom disebut kolom kustom. Pelajari kolom kustom lebih lanjut. CustomColumnService
baru akan mengaktifkan kolom kustom. Asalkan memiliki izin yang diperlukan, Anda dapat meminta resource CustomColumn yang dimiliki oleh akun mana pun di
hierarki akun.
Pengelolaan akun
Search Ads 360 versi baru mengatur akun ke dalam hierarki akun pengelola, akun sub-pengelola, dan akun klien. Akun pengelola merepresentasikan akun agensi, dan akun sub-pengelola mewakili akun pengiklan di Search Ads 360 versi sebelumnya. Lihat artikel Tentang akun pengelola Search Ads 360 untuk mempelajari lebih lanjut.
Anda dapat membuat kueri hierarki akun, lalu mengirimkan permintaan untuk setiap akun yang ingin Anda laporkan datanya.
Akibat perubahan hierarki akun, kolom yang terkait dengan konsep pengiklan/agensi telah diganti dengan alternatif yang sesuai untuk memberikan paritas fungsional jika memungkinkan. Lihat Pemetaan kolom untuk mengetahui daftar kolom yang terpengaruh dan penggantinya.
Header ID pelanggan login
login-customer-id adalah header baru yang diperlukan saat menggunakan akun pengelola untuk mengakses akun sub-pengelola atau klien. Lihat Header ID pelanggan login untuk informasi selengkapnya.
Pembuatan versi
Search Ads 360 Reporting API menggunakan pembuatan versi semantik.
Ada versi utama dan minor, dengan format
vMAJOR_MINOR. Lihat Pembuatan Versi untuk mempelajari lebih lanjut.