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 resource di situs ini, hubungi dukungan dan siapkan informasi berikut:

• ID Agensi Search Ads 360 dan ID Pengiklan 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 adalah beberapa error otorisasi yang umum ditemukan:

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 Anda. Pada sidebar di sebelah kiri, luaskan APIs & amp; auth. Selanjutnya, klik API. Dalam daftar API, pastikan statusnya AKTIF untuk Search Ads 360 API.
Invalid grant	Error ini terjadi jika token refresh Anda tidak valid. Anda dapat memperoleh token refresh dengan memanggil skrip utilitas Search Ads 360 sebagai berikut: sa360Api.py --login Pelajari lebih lanjut alur kerja otorisasi yang direkomendasikan.
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 pada 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 rahasia 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 hal berikut: Memverifikasi bahwa ID klik dibuat 4 jam sebelum konversi diupload. Mengaktifkan layanan konversi API. Jika Anda mengatribusikan konversi ke kunjungan tertentu, tunggu setidaknya 30 menit setelah kunjungan sebelum Anda mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika Anda mengupload lebih cepat dari 30 menit setelah kunjungan. Terkadang, Anda mungkin perlu menunggu hingga 4 jam sebelum Search Ads 360 dapat mengenali clickId. Dikonfirmasi bahwa klik berasal dari sumber yang valid seperti yang ditunjukkan oleh parameter gclsrc. Kami mengonfirmasi bahwa Anda telah menetapkan pengiklan yang benar di kolom AdvertiserId. Verifikasi bahwa ID klik telah dibuat dalam 90 hari terakhir.
0x0000010E	Floodlight activity name '{name}' is not found	Nama aktivitas Floodlight yang ditentukan dalam 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 dalam nama aktivitas Floodlight. Pastikan Anda menentukan nama aktivitas Floodlight, bukan kolom Floodlight. Pastikan aktivitas Floodlight tersedia untuk pengiklan yang Anda tentukan di kolom advertiserId. (Mungkin Anda menetapkan pengiklan yang salah.) Setelah Anda 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.
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. "ID konversi pengiklan" adalah ID yang Anda buat. Search Ads 360 mengharuskan ID ini 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 memasukkan 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 API Google untuk mengambil client ID dan rahasia klien, dan saat Anda memperoleh token refresh, pastikan untuk menggunakan Akun Google yang telah diberikan 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 mengharuskan ID ini 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 telah 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 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.