Search Ads 360 Reporting API versi sebelumnya akan dihentikan dan dinonaktifkan pada 30 Juni 2024. Perhatikan bahwa Search Ads 360 Conversion API tidak terpengaruh dan akan terus didukung. Semua pengembangan pelaporan baru harus menggunakan Search Ads 360 Reporting API versi baru.

Mulai April 2024, error supportedApiVersion akan ditampilkan saat meminta laporan. Lihat detailnya di sini.

Sebaiknya migrasikan juga penerapan Search Ads 360 yang ada ke API baru. Lihat Memulai dan Panduan Migrasi Search Ads 360 Reporting API versi baru untuk mendapatkan informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Minta Laporan

Search Ads 360 Reporting API versi baru kini tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

Setelah menyiapkan aplikasi klien seperti yang dijelaskan di Aplikasi Pertama Saya, Anda dapat menggunakan Search Ads 360 API untuk meminta dan mendownload laporan. Anda dapat membuat salah satu jenis permintaan berikut:

Sinkron

Hanya memerlukan satu permintaan dan menampilkan laporan dalam respons berformat JSON. Permintaan sinkron:

Hanya dapat menampilkan laporan pengiklan dan akun mesin
Blokir klien Anda hingga Search Ads 360 membuat laporan

Jika Anda meminta laporan pengiklan atau akun mesin berukuran besar, kami merekomendasikan pendekatan asinkron.

Asinkron

Mengharuskan Anda untuk mengirim permintaan awal yang menentukan data yang diinginkan dalam laporan. Kemudian, Anda akan mengirimkan permintaan tambahan untuk melakukan polling di Search Ads 360. Setelah Search Ads 360 selesai membuat laporan, Anda akan mengirim permintaan untuk mendownload laporan sebagai satu atau beberapa file. Permintaan asinkron:

Dapat menampilkan jenis laporan apa pun
Membagi laporan berukuran sangat besar menjadi beberapa file
Memformat laporan sebagai CSV atau TSV

Model data: baris dan kolom

Search Ads 360 mengatur data dalam laporan ke dalam baris dan kolom. Jenis laporan yang Anda minta menentukan baris yang ditampilkan. Misalnya, jika Anda meminta laporan kata kunci, setiap baris akan berisi data tentang satu kata kunci. Lihat referensi Jenis Laporan untuk melihat daftar semua jenis laporan. Anda menentukan kolom yang diinginkan dalam laporan dengan menamai setiap kolom dalam permintaan laporan. Lihat referensi Jenis Laporan untuk mengetahui daftar kolom yang dapat ditampilkan untuk setiap jenis laporan.

Perilaku kolom

Perilaku kolom bergantung pada jenis data yang dimuat dalam kolom tersebut (referensi Jenis Laporan menampilkan perilaku setiap kolom):

Kolom atribut. Kolom atribut berisi data yang mengonfigurasi atau mengidentifikasi entitas dalam kampanye, seperti nama kampanye atau bid kata kunci. Search Ads 360 API selalu menampilkan nilai saat ini untuk kolom atribut, terlepas dari tanggal atau rentang tanggal yang ditentukan dalam permintaan. Misalnya, jika Anda mengubah bid kata kunci dari 2,00 menjadi 1,50 kemarin, lalu meminta laporan untuk data bulan lalu, laporan tersebut akan menampilkan nilai 1,50 untuk bid kata kunci tersebut.
Kolom metrik. Kolom metrik berisi data tentang performa kampanye, seperti jumlah klik pada iklan, jumlah kunjungan yang dicatat oleh tag Floodlight, atau pendapatan. Kecuali Anda menentukan rentang waktu satu hari, API akan menampilkan nilai gabungan untuk kolom metrik. Misalnya, jika Anda meminta laporan untuk data bulan lalu, API akan menampilkan total jumlah klik untuk bulan lalu.
Segmentasikan kolom. Kolom segmen membagi data menjadi baris terpisah. Misalnya, date adalah kolom segmen yang dapat Anda tentukan untuk berbagai jenis laporan. Jika Anda menentukan kolom date dalam laporan kata kunci dengan rentang tanggal 01-01-2013 hingga 07-01-2013, API akan menampilkan tujuh baris untuk setiap kata kunci, masing-masing sesuai dengan satu hari dan menampilkan metrik untuk hari tersebut. Lihat Laporan Tersegmentasi.

Mata Uang

Permintaan laporan Anda diperlukan untuk menentukan mata uang data moneter (baik atribut seperti dailyBudget dan metrik seperti cost). Anda dapat menentukan salah satu hal berikut:

Mata uang agensi, jika laporan dicakup ke akun agensi, pengiklan, atau mesin.
Mata uang pengiklan, jika laporan memiliki cakupan akun pengiklan atau mesin.
Mata uang akun mesin, jika laporan tercakup dalam akun mesin.
USD

Gunakan properti permintaan Reports.request.statisticsCurrency untuk menentukan mata uang.

Laporan itu sendiri akan menunjukkan mata uang di properti Reports.statisticsCurrencyCode.

Zona waktu

Metrik Search Ads 360 disimpan dalam tanggal tanpa zona waktu. Tanggal ini sesuai dengan zona waktu akun mesin untuk metrik mesin (seperti klik, tayangan iklan, dan kunjungan), serta zona waktu jaringan Campaign Manager untuk metrik konversi (seperti tindakan, transaksi, dan pendapatan). Jika setiap metrik dalam laporan berasal dari zona waktu yang sama, zona waktu tersebut akan ditampilkan dalam permintaan. Jika tidak, zona waktu tidak akan ditampilkan. Permintaan Anda dapat menetapkan Reports.request.verifySingleTimeZone: true untuk menggagalkan laporan yang menampilkan metrik dari lebih dari satu zona waktu.

Jika semua metrik yang ada dalam laporan berasal dari satu zona waktu, zona waktu tersebut akan ditampilkan dalam Reports.statisticsTimeZoneReports.