Pemecahan masalah

Jika Anda mengalami masalah saat menggunakan Search Ads 360 API, lihat bagian pemecahan masalah ini.

Jika ada masalah yang tidak dapat Anda atasi setelah membaca referensi di situs ini, hubungi dukungan dan siapkan informasi berikut:

• ID Agensi dan ID Pengiklan Search Ads 360 yang Anda coba akses

• Nomor Project dari Konsol API Google

• Nama pengguna Akun Google yang Anda gunakan untuk mengakses API.
  Ini adalah akun yang telah diberi izin untuk mengakses Search Ads 360, yang merupakan akun yang sama dengan yang Anda gunakan untuk menyiapkan otorisasi.

• Cuplikan kode permintaan Anda

• Respons JSON
  Jika responsnya adalah error, pastikan untuk menyertakan pesan error, bukan hanya kode error numerik.

Galat otorisasi

Berikut ini beberapa error otorisasi yang umum terjadi:

Pesan	Deskripsi
Access Not Configured. Please use Google API Console to activate the API for your project.	Error ini terjadi jika Anda belum mengaktifkan Search Ads 360 API untuk akun Anda. Pastikan Anda telah melakukan hal berikut: Buka Konsol Google API. Pilih project Anda. Jika Anda belum membuat project, lihat Membuat project untuk klien. Di sidebar di sebelah kiri, luaskan API & auth. Selanjutnya, klik API. Dalam daftar API, pastikan statusnya AKTIF untuk Search Ads 360 API.
Invalid grant	Error ini terjadi saat token refresh Anda tidak valid. Anda bisa mendapatkan token refresh dengan memanggil skrip utilitas Search Ads 360 sebagai berikut: sa360Api.py --login Pelajari lebih lanjut alur kerja yang direkomendasikan untuk otorisasi.
Invalid client no application name	Error ini terjadi jika Anda belum menentukan nama produk saat menyiapkan project di Konsol API Google. Untuk memperbaiki error ini, masukkan nama produk Anda di layar Izin Konsol API Google.
Jenis error otorisasi lainnya	Pastikan untuk menggunakan Akun Google yang telah diberi akses ke Search Ads 360 saat Anda login ke Konsol API Google untuk mengambil client ID dan secret klien, serta saat Anda mendapatkan token refresh.

Error upload konversi

Tabel berikut mencantumkan error yang mungkin Anda alami saat mengupload konversi. Perhatikan bahwa kode error heksadesimal tidak dapat diubah, sehingga Anda dapat menggunakannya dalam skrip Anda sendiri untuk mengidentifikasi error.

Kode error	Pesan	Deskripsi
0x00000101	Click ID '{ID}' is not found	ID klik yang Anda tentukan dalam permintaan update tidak valid. Upload ulang konversi setelah Anda melakukan tindakan berikut: Memverifikasi bahwa ID klik dibuat 4 jam sebelum konversi diupload. Mengaktifkan layanan konversi API. Jika Anda mengatribusikan konversi ke kunjungan tertentu, tunggu minimal 30 menit setelah kunjungan sebelum mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika Anda mengupload lebih cepat dari 30 menit setelah kunjungan. Dalam kasus yang jarang terjadi, Anda mungkin perlu menunggu hingga 4 jam sebelum Search Ads 360 dapat mengenali clickId. Mengonfirmasi bahwa klik berasal dari sumber yang valid seperti yang ditunjukkan oleh parameter gclsrc. Mengonfirmasi bahwa Anda telah menentukan pengiklan yang benar di kolom AdvertiserId. Memverifikasi bahwa ID klik Anda dibuat dalam 90 hari terakhir.
0x0000010E	Floodlight activity name '{name}' is not found	Nama aktivitas Floodlight yang ditentukan di kolom segmentationName salah atau belum tersedia. Jika Anda melihat error ini, periksa masalah umum berikut: Nama peka huruf besar/kecil, jadi pastikan permintaan Anda sama persis dengan huruf besar/kecil. Pastikan Anda tidak menyertakan karakter Unicode atau spasi ganda yang tidak dapat dicetak di nama aktivitas Floodlight. Pastikan Anda menentukan nama aktivitas Floodlight, bukan kolom Floodlight. Pastikan aktivitas Floodlight ada untuk pengiklan yang Anda tentukan di kolom advertiserId. (Mungkin Anda menentukan pengiklan yang salah.) Setelah membuat atau mengedit aktivitas Floodlight, tunggu beberapa jam sebelum mengupload konversi untuk aktivitas tersebut.
0x00000115	Custom dimension '{name}' is not found	Pastikan variabel Floodlight kustom yang Anda tentukan telah disiapkan sebagai dimensi (bukan metrik) untuk pengiklan yang terkait dengan clickId, criterionId, atau productGroupId yang Anda atribusikan untuk konversi tersebut.
0x00000116	Custom metric '{name}' is not found	Pastikan variabel Floodlight kustom yang Anda tentukan telah disiapkan sebagai metrik (bukan dimensi) untuk pengiklan yang terkait dengan clickId, criterionId, atau productGroupId yang Anda atribusikan untuk konversi.
0x0000011A	The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}	Seseorang telah mengupload konversi untuk cakupan dan ID konversi pengiklan yang sama yang ditentukan di kolom conversionId. "Advertiser Conversion ID" adalah ID yang Anda buat. Search Ads 360 mewajibkan ID ini bersifat unik untuk cakupan tertentu. ID konversi Search Ads 360 dibuat oleh Search Ads 360 dan dijamin unik.
0x0000011B	Advertiser conversion ID '{ID}' is not found	Permintaan update Anda mencoba memperbarui ID konversi pengiklan yang tidak ada. Pastikan Anda menentukan ID yang tepat.
0x0000011D	User does not have permission to view advertiser {advertiser ID}	Akun Google yang digunakan klien Anda tidak memiliki izin untuk melihat pengiklan yang ditentukan dalam permintaan. Saat Anda login ke Konsol Google API untuk mengambil client ID dan secret klien, serta saat Anda mendapatkan token refresh, pastikan untuk menggunakan Akun Google yang telah diberi akses ke pengiklan yang Anda tentukan.
0x0000011F	Advertiser conversion ID is already specified in this request	Dua atau beberapa konversi dalam permintaan menentukan cakupan dan ID konversi pengiklan yang sama. ID konversi pengiklan adalah ID yang Anda buat dan tentukan di kolom conversionId. Search Ads 360 mewajibkan ID ini harus unik untuk cakupan tertentu.
0x0000011E	The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)	ID atau nama aktivitas Floodlight yang Anda berikan tidak cocok dengan jenis konversi yang Anda tentukan.

Melaporkan kode respons dan pesan error

Jika Anda meminta laporan dan responsnya adalah pesan error, lihat Kode Respons di Search Ads 360 API dan Respons Error Standar untuk mengetahui informasi selengkapnya tentang error tersebut.

Data di UI Search Ads 360 tidak cocok dengan laporan yang ditampilkan oleh API

Data di UI Search Ads 360 harus cocok dengan data yang ditampilkan oleh API secara default. Jika Anda menetapkan includeRemovedEntities ke true dalam permintaan laporan, pastikan kotak centang Show removed juga dipilih di UI.