- Apakah ada batasan terkait konten yang dapat saya upload?
Ada beberapa batasan yang perlu diperhatikan:
- Permintaan
batchinsertdanbatchupdateindividual 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.
- Permintaan
- 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?
batchinsertdanbatchupdatememproses konversi dengan upaya terbaik: permintaan batch dapat menampilkan respons HTTP200 OK, sementara konversi individual dalam batch gagal. Selalu periksahasFailurespada respons dan periksa daftarerrors[]pada setiap objekConversionStatus: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 mempertahankanordinal,timestampMicros,floodlightActivityId, dan ID pengguna atau klik yang sama persis.NOT_FOUND(Coba lagi dengan penundaan): ID (gclid,dclid,matchId, ataumobileDeviceId) 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 konversiNOT_FOUNDsecara berkala (misalnya, setiap 1 hingga 3 jam, hingga 6 jam). JikaNOT_FOUNDtetap ada setelah 6 jam, lihat bagian berikut untuk mengetahui penyebab umum berdasarkan jenis ID.INVALID_ARGUMENTdanPERMISSION_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
5xxatau error kuota/batas kapasitas429, coba lagi permintaan menggunakan backoff eksponensial.Percobaan ulang dan penghapusan duplikat yang aman: Saat mencoba ulang konversi yang gagal dengan
INTERNALatauNOT_FOUND(atau setelah waktu tunggu HTTP5xxsaat hasilnya tidak diketahui), selalu kirimordinaldantimestampMicrosyang sama persis. Jika konversi sudah dicatat, Campaign Manager 360 akan otomatis menghapus duplikatnya berdasarkanordinal, ID pengguna, aktivitas Floodlight, dan tanggal konversi.- Apa artinya jika upload
mobileDeviceIdgagal karena errorNOT_FOUND? Penyebab paling umum error ini adalah:
mobileDeviceIdtidak valid.mobileDeviceIdtidak diketahui oleh Search Ads 360. Artinya, perangkat belum ditayangkan iklan oleh Campaign Manager 360.
- Apa artinya jika upload
gclidgagal karena errorNOT_FOUND? Penyebab paling umum error ini adalah:
gclidtidak valid.gclidtidak terkait dengan kampanye Search Ads 360 atau item baris YouTube Display & Video 360. Hal ini dapat terjadi jikagcliddikumpulkan 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
gclidterjadi terlalu lama di masa lalu. Konversi hanya dapat disisipkan untuk klik yang berusia hingga 60 hari. - Klik yang terkait dengan
gclidterjadi terlalu baru. Sebaiknya tunda upload konversi berbasisgclidselama 1 jam untuk memastikan bahwagcliddiproses dan tersedia untuk pencocokan.
- Apa artinya jika upload
dclidgagal karena errorNOT_FOUND? Penyebab paling umum error ini adalah:
dclidtidak valid.- Klik yang terkait dengan
dclidterjadi terlalu lama di masa lalu. Konversi hanya dapat disisipkan untuk klik yang berusia hingga 60 hari. - Klik yang terkait dengan
dclidterjadi terlalu baru. Sebaiknya tunda upload konversi berbasisdclidselama 1 jam untuk memastikan bahwadcliddiproses dan tersedia untuk pencocokan.
- Apa artinya jika upload
matchIdgagal karena errorNOT_FOUND? Penyebab paling umum error ini adalah:
matchIdtidak diketahui oleh Campaign Manager 360. Hal ini dapat terjadi jikamatchIddikumpulkan dari panggilan Floodlight yang tidak diteruskan dengan benar melalui Campaign Manager 360 (pastikan panggilan Floodlight Anda berfungsi dengan benar, termasuk parameter tagmatchId).- Panggilan Floodlight yang terkait dengan
matchIdtidak berisi cookie. Panggilan Floodlight harus berisi cookie / ID agar Campaign Manager 360 dapat menyimpanmatchIddengan benar (misalnya, pengguna mungkin telah memblokir cookie atau memilih tidak ikut). - Panggilan Floodlight yang terkait dengan
matchIdterjadi terlalu lama di masa lalu. Upload Konversi Offline harus dilakukan dalam waktu 60 hari setelah panggilan Floodlight yang berisimatchId. - Panggilan Floodlight yang terkait dengan
matchIdterjadi terlalu baru. Sebaiknya tunda upload konversi berbasismatchIdselama 2 jam untuk memastikan bahwamatchIddiproses 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
nonPersonalizedAdharus ditetapkan secara eksplisit kefalseuntuk mengaktifkan pembuatan daftar audiens.
Pertanyaan umum (FAQ)
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 2026-10-20 UTC.
[null,null,["Terakhir diperbarui pada 2026-10-20 UTC."],[],[]]