Pertanyaan umum (FAQ)

Apakah ada batasan terkait konten yang dapat saya upload?

Ada beberapa batasan yang perlu diperhatikan:

  • Permintaan batchinsert dan batchupdate individual dibatasi hingga 1.000 konversi.
  • Stempel waktu konversi paling lama 28 hari sejak waktu pengiriman.
  • Anda hanya dapat mengirimkan konversi ke konfigurasi Floodlight yang dapat diakses oleh profil pengguna Campaign Manager 360 Anda.
Haruskah saya menggunakan Campaign Manager 360 atau Search Ads 360 untuk mengupload konversi?

Lihat pusat bantuan Search Ads 360 untuk mengetahui perbandingan mendetail fitur yang ditawarkan oleh kedua produk.

Bagaimana jika saya menyisipkan konversi yang sama ke Campaign Manager 360 dan Search Ads 360?

Jika Anda menyisipkan konversi yang sama ke Campaign Manager 360 dan Search Ads 360, entri tersebut tidak akan dihapus duplikatnya. Gunakan aktivitas Floodlight terpisah dalam kasus ini.

API mana yang harus saya gunakan untuk mengupload konversi offline?

Sebaiknya gunakan Data Manager API untuk mendapatkan pengalaman developer yang lebih baik dan akses ke fitur tambahan.

Apa yang dimaksud dengan nilai ordinal dan bagaimana cara menggunakannya?

Nilai ordinal mengontrol cara konversi duplikat diproses. Jika beberapa konversi disisipkan dengan aktivitas Floodlight, ID konfigurasi Floodlight, ID pengguna, dan stempel waktu konversi yang sama, ordinal akan digunakan untuk menentukan apakah:

  • Konversi akan dihapus duplikatnya dan hanya satu yang akan dipertahankan. Hal ini terjadi jika semua konversi memiliki nilai ordinal yang sama.
  • Konversi diproses satu per satu dan semuanya berhasil. Hal ini terjadi jika semua konversi memiliki nilai ordinal yang berbeda.

Nilai itu sendiri tidak perlu bermakna. Secara umum, penggunaan nilai tetap (seperti 1) untuk semua konversi akan mengaktifkan penghapusan duplikat. Menggunakan nilai acak atau unik untuk setiap konversi akan menonaktifkannya.

Bagaimana cara menangani error dalam respons API, dan error mana yang harus saya coba ulang?

batchinsert dan batchupdate memproses konversi dengan upaya terbaik: permintaan batch dapat menampilkan respons HTTP 200 OK, sementara konversi individual dalam batch gagal. Selalu periksa hasFailures pada respons dan periksa daftar errors[] pada setiap objek ConversionStatus:

  • INTERNAL (Coba lagi): Terjadi error sementara di dalam sistem Google saat memproses konversi. Konversi tidak disisipkan atau diperbarui. Coba lagi konversi yang gagal menggunakan backoff eksponensial (misalnya, mulai setelah beberapa menit dan coba lagi selama beberapa jam), dengan mempertahankan ordinal, timestampMicros, floodlightActivityId, dan ID pengguna atau klik yang sama persis.
  • NOT_FOUND (Coba lagi dengan penundaan): ID (gclid, dclid, matchId, atau mobileDeviceId) atau konversi yang ada yang sedang diedit belum dapat ditemukan. Karena klik online, tag Floodlight, dan konversi dapat memerlukan waktu 1 hingga 2 jam untuk diproses dan diindeks, coba lagi konversi NOT_FOUND secara berkala (misalnya, setiap 1 hingga 3 jam, hingga 6 jam). Jika NOT_FOUND tetap ada setelah 6 jam, lihat bagian berikut untuk mengetahui penyebab umum berdasarkan jenis ID.
  • INVALID_ARGUMENT dan PERMISSION_DENIED (Jangan coba lagi): Data konversi tidak valid (misalnya, stempel waktu konversi lebih lama dari 28 hari atau kolom yang salah format) atau profil pengguna Anda tidak memiliki izin untuk konfigurasi Floodlight target. Jangan coba lagi konversi ini tanpa memperbaiki masalah pokoknya.

Jika seluruh permintaan HTTP gagal dengan error server 5xx atau error kuota/batas kapasitas 429, coba lagi permintaan menggunakan backoff eksponensial.

Percobaan ulang dan penghapusan duplikat yang aman: Saat mencoba ulang konversi yang gagal dengan INTERNAL atau NOT_FOUND (atau setelah waktu tunggu HTTP 5xx saat hasilnya tidak diketahui), selalu kirim ordinal dan timestampMicros yang sama persis. Jika konversi sudah dicatat, Campaign Manager 360 akan otomatis menghapus duplikatnya berdasarkan ordinal, ID pengguna, aktivitas Floodlight, dan tanggal konversi.

Apa artinya jika upload mobileDeviceId gagal karena error NOT_FOUND?

Penyebab paling umum error ini adalah:

  • mobileDeviceId tidak valid.
  • mobileDeviceId tidak diketahui oleh Search Ads 360. Artinya, perangkat belum ditayangkan iklan oleh Campaign Manager 360.
Apa artinya jika upload gclid gagal karena error NOT_FOUND?

Penyebab paling umum error ini adalah:

  • gclid tidak valid.
  • gclid tidak terkait dengan kampanye Search Ads 360 atau item baris YouTube Display & Video 360. Hal ini dapat terjadi jika gclid dikumpulkan dari pengalihan klik Google Ads yang tidak melewati Search Ads 360 (misalnya, klik pada ekstensi lokasi) atau dikumpulkan dari pengalihan klik iklan YouTube yang tidak terkait dengan item baris YouTube Display & Video 360.
  • Klik yang terkait dengan gclid terjadi terlalu lama di masa lalu. Konversi hanya dapat disisipkan untuk klik yang berusia hingga 60 hari.
  • Klik yang terkait dengan gclid terjadi terlalu baru. Sebaiknya tunda upload konversi berbasis gclid selama 1 jam untuk memastikan bahwa gclid diproses dan tersedia untuk pencocokan.
Apa artinya jika upload dclid gagal karena error NOT_FOUND?

Penyebab paling umum error ini adalah:

  • dclid tidak valid.
  • Klik yang terkait dengan dclid terjadi terlalu lama di masa lalu. Konversi hanya dapat disisipkan untuk klik yang berusia hingga 60 hari.
  • Klik yang terkait dengan dclid terjadi terlalu baru. Sebaiknya tunda upload konversi berbasis dclid selama 1 jam untuk memastikan bahwa dclid diproses dan tersedia untuk pencocokan.
Apa artinya jika upload matchId gagal karena error NOT_FOUND?

Penyebab paling umum error ini adalah:

  • matchId tidak diketahui oleh Campaign Manager 360. Hal ini dapat terjadi jika matchId dikumpulkan dari panggilan Floodlight yang tidak diteruskan dengan benar melalui Campaign Manager 360 (pastikan panggilan Floodlight Anda berfungsi dengan benar, termasuk parameter tag matchId).
  • Panggilan Floodlight yang terkait dengan matchId tidak berisi cookie. Panggilan Floodlight harus berisi cookie / ID agar Campaign Manager 360 dapat menyimpan matchId dengan benar (misalnya, pengguna mungkin telah memblokir cookie atau memilih tidak ikut).
  • Panggilan Floodlight yang terkait dengan matchId terjadi terlalu lama di masa lalu. Upload Konversi Offline harus dilakukan dalam waktu 60 hari setelah panggilan Floodlight yang berisi matchId.
  • Panggilan Floodlight yang terkait dengan matchId terjadi terlalu baru. Sebaiknya tunda upload konversi berbasis matchId selama 2 jam untuk memastikan bahwa matchId diproses dan tersedia untuk pencocokan.
Apakah konversi offline dengan stempel waktu sebelum pembuatan Aktivitas Floodlight disertakan dalam laporan?

Upload konversi offline dengan stempel waktu sebelum pembuatan Aktivitas Floodlight dapat dilaporkan sebagai tayangan Floodlight dan sebagai konversi yang tidak diatribusikan/diatribusikan, hingga 28 hari sebelum waktu pengiriman. Namun, perilaku ini tidak dijamin dan tidak boleh diandalkan. Praktik terbaiknya adalah membuat Aktivitas Floodlight sebelum stempel waktu paling awal dari konversi offline.

Izin apa yang diperlukan untuk menggunakan Penyisipan Konversi Offline untuk pembuatan daftar audiens?

Selain izin data pengguna iklan, kolom nonPersonalizedAd harus ditetapkan secara eksplisit ke false untuk mengaktifkan pembuatan daftar audiens.