Search Ads 360 Reporting API didasarkan pada platform modern dan memperkenalkan sejumlah konsep baru. Konsep ini dijelaskan di bagian berikut.
Resource
Objek resource menggantikan jenis laporan. Alih-alih meminta jenis laporan yang telah ditentukan, 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 menggunakan
SearchAds360Service
yang menyediakan dua metode, SearchStream dan Search, untuk menelusuri dan
mengambil data serta metrik pelaporan. Kedua metode penelusuran 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. Lihat Mengambil metadata resource untuk mempelajari
lebih lanjut.
Nama kolom
API ini memperkenalkan nama kolom bertingkat yang dipisahkan dengan notasi titik. Misalnya, campaign.id dan ad_group.id. Anda juga dapat membuat kolom 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 berbagai entity 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 tertentu yang paling sesuai dengan bisnis Anda. Lihat Bahasa Kueri Search Ads 360 untuk mempelajari lebih lanjut.
Permintaan GET
Di API baru, penelusuran memiliki layanannya sendiri (SearchAds360Service), tetapi permintaan GET masih ada di layanan khusus setiap entity. 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.
Yang baru
CustomColumnService
mengaktifkan kolom kustom. Jika 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. Di Search Ads 360 versi sebelumnya, akun pengelola merepresentasikan akun agensi dan akun sub-pengelola merepresentasikan akun pengiklan. Lihat 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.
Sebagai hasil dari perubahan hierarki akun, kolom yang terkait dengan konsep pengiklan/agensi telah diganti dengan alternatif yang sesuai untuk memberikan kesetaraan fungsi 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
pembuatan versi semantik. Ada versi utama dan minor,
difomatkan sebagai vMAJOR_MINOR. Lihat
Pembuatan Versi untuk mempelajari lebih lanjut.