Pemecahan masalah

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

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

  • ID Agensi dan ID Pengiklan Search Ads 360 yang ingin Anda 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 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 API Google.

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

  3. Di sidebar di sisi kiri, luaskan API & auth. Selanjutnya, klik APIs. 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 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 insert atau update tidak valid. Upload ulang konversi setelah Anda melakukan hal berikut:

  • Memastikan 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 Anda mengupload konversi. Search Ads 360 mungkin tidak mengenali clickID kunjungan jika Anda menguploadnya kurang 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.

  • Memverifikasi bahwa ID klik Anda dibuat dalam 90 hari terakhir.

0x00000106 Either a click ID or keyword ID is required

Konversi tidak menentukan atribusinya. Tentukan kolom clickId, atau kolom customerId, campaignId, adGroupId, dan criterionId yang mengidentifikasi kata kunci.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Tentukan segmentationType: "FLOODLIGHT" dan aktivitas Floodlight di kolom segmentationName atau segmentationId.

Saat Anda mengedit konversi yang dicatat Search Ads 360 melalui tag Floodlight, aktivitas Floodlight diperlukan untuk mengidentifikasi konversi.

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/kecilnya.
  • 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 memiliki ID klik atau kata kunci dalam permintaan Anda.
  • 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.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

Permintaan update Anda tidak menentukan kolom conversionId. conversionId diperlukan untuk mengidentifikasi konversi yang ingin Anda edit. Lihat Penghentian dsConversionId.

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 mewajibkan ID ini harus 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. Periksa masalah umum berikut:

  • Pastikan Anda menentukan ID yang tepat di kolom conversionId. Untuk konversi yang diupload melalui API, ini adalah conversionId yang Anda tentukan saat menyisipkan konversi. Untuk konversi yang dicatat melalui tag Floodlight, ini adalah ID pesanan Floodlight.
  • Pastikan conversionTimestamp adalah stempel waktu konversi yang ada, dalam milidetik Epoch UTC. Stempel waktu yang dikonversi dari zona waktu lokal, atau yang ditentukan dalam detik, bukan milidetik, tidak cocok dengan konversi yang ada.
  • Untuk konversi yang dicatat melalui tag Floodlight, pastikan Anda menentukan aktivitas Floodlight konversi di kolom segmentationName atau segmentationId, dan konversi tersebut terjadi dalam 28 hari terakhir.
0x0000011D User does not have permission to view advertiser {advertiser ID}

Akun Google yang digunakan klien Anda tidak memiliki izin untuk melihat pengiklan yang memiliki ID klik atau kata kunci dalam permintaan.

Saat Anda login ke Konsol API Google untuk mengambil client ID dan rahasia klien, serta saat Anda mendapatkan token refresh, pastikan untuk menggunakan Akun Google yang telah diberi akses ke pengiklan tersebut.

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.

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp lebih awal daripada waktu klik yang Anda tentukan di kolom clickId. Pastikan stempel waktu ditentukan dalam milidetik Epoch UTC, bukan dalam detik atau dalam zona waktu lokal.

0x00000125 Conversion age is older than the max supported age

Permintaan update Anda mencoba mengedit konversi yang sudah terlalu lama untuk diedit. Konversi yang dicatat Search Ads 360 melalui tag Floodlight hanya dapat diedit dalam waktu 28 hari sejak conversionTimestamp.

0x00000126 Service internal error

Coba lagi permintaan Anda setelah beberapa saat. Error ini kemungkinan bersifat sementara. Hubungi dukungan SA360 jika error ini berlanjut.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 tidak dapat menemukan ID pelanggan yang Anda tentukan di kolom customerId . Tentukan ID pelanggan Search Ads 360 versi baru untuk akun klien yang berisi kata kunci, misalnya 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 tidak dapat menemukan kata kunci yang diidentifikasi oleh kolom customerId, campaignId, adGroupId, dan criterionId. Pastikan keempat ID tersebut adalah ID Search Ads 360 versi baru dan kata kunci tersebut termasuk dalam grup iklan, kampanye, dan akun klien yang Anda tentukan.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Konversi yang diatribusikan ke kata kunci harus menentukan customerId, campaignId, adGroupId, dan criterionId. Pesan tersebut menyebutkan ID yang tidak ada. Lihat Mengatribusikan konversi ke kata kunci saja.

0x0000012F Editing a click ID older than 60 days is not supported.

Permintaan update Anda menentukan clickId yang dibuat lebih dari 60 hari yang lalu. Konversi hanya dapat diedit dalam waktu 60 hari setelah klik.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

Permintaan update Anda menentukan kolom dsConversionId yang tidak digunakan lagi, atau meneruskan ID konversi Search Ads 360 di kolom conversionId. Identifikasi konversi berdasarkan ID konversi pengiklannya. Lihat Penghentian dsConversionId.

Kode respons laporan 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 dicentang di UI.