Search Ads 360 Reporting API didasarkan pada platform modern dan memperkenalkan sejumlah konsep baru. Hal ini dijelaskan di bagian berikut.
Resource
Objek resource menggantikan jenis laporan. Daripada meminta jenis laporan yang telah ditentukan sebelumnya, kini Anda dapat membuat kueri semua resource menggunakan bahasa kueri mirip SQL yang baru. 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 akan melalui
SearchAds360Service yang menyediakan dua metode, SearchStream dan Search,
untuk menelusuri dan mengambil data dan metrik pelaporan. Kedua metode penelusuran
menampilkan semua objek SearchAds360Row yang cocok dengan kueri penelusuran Anda. Lihat artikel 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 di metode penelusuran SearchAds360Service. Lihat
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 menyusun 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 di
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. Ini adalah bahasa yang fleksibel dan mirip SQL yang memungkinkan Anda menentukan kueri untuk mengambil data pelaporan tertentu 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 di layanan spesifik setiap entitas. Misalnya, Anda
dapat 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 memungkinkan kolom kustom. Jika memiliki izin yang diperlukan, Anda dapat meminta resource CustomColumn yang dimiliki oleh akun mana pun dalam
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 datanya ingin Anda laporkan.
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 akun klien. Lihat
Header ID pelanggan login untuk
mengetahui informasi selengkapnya.
Pembuatan Versi
Search Ads 360 Reporting API menggunakan versi semantik.
Ada versi utama dan minor, yang diformat sebagai
vMAJOR_MINOR. Lihat Pembuatan Versi untuk mempelajari lebih lanjut.