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 berupa error, pastikan untuk menyertakan pesan error, bukan hanya
kode error numerik.
Galat otorisasi
Berikut beberapa error otorisasi yang sering 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 Anda. 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 jika 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 di 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 hal berikut:
Memverifikasi bahwa ID klik dibuat 6 jam sebelum konversi diupload. Mengaktifkan
layanan konversi API. Jika Anda
mengatribusikan konversi ke kunjungan tertentu, tunggu minimal 6 jam setelah
kunjungan sebelum mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika Anda mengupload lebih cepat dari 6 jam setelah kunjungan. Dalam kasus yang jarang terjadi, Anda mungkin perlu menunggu hingga 24 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 yang tidak dapat dicetak atau spasi ganda dalam
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 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.
"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 API Google 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.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-21 UTC.
[null,null,["Terakhir diperbarui pada 2024-12-21 UTC."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
