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:

  1. Buka Konsol Google API.

  2. Pilih project Anda. Jika Anda belum membuat project, lihat Membuat project untuk klien Anda.

  3. 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.

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 Tampilkan yang dihapus juga dipilih di UI.