Perhatikan praktik terbaik berikut saat menggunakan Data Manager API.
Mengirim semua ID pengguna
Baik saat mengirim anggota audiens atau peristiwa dengan UserData, sertakan sebanyak mungkin
user_identifiers, termasuk mengirim beberapa ID dari
jenis yang sama.
Misalnya, jika Anda memiliki beberapa alamat email untuk satu pengguna, sertakan
UserIdentifier terpisah untuk setiap alamat email. Demikian pula, jika Anda memiliki ID dari
berbagai jenis untuk pengguna, seperti alamat email, nomor telepon, dan
alamat, tambahkan UserIdentifier terpisah untuk setiap ID, hingga
jumlah ID maksimum.
Mengoptimalkan permintaan
Untuk mengurangi kemungkinan terlampauinya batas permintaan harian, buat batch sebanyak mungkin item dalam setiap permintaan, hingga batas per permintaan.
Misalnya, jika Anda ingin menambahkan 10.000 anggota audiens ke audiens, tambahkan semua
10.000 anggota dalam daftar audience_members dalam satu
IngestAudienceMembersRequest. Mengelompokkan 10.000 anggota dalam satu permintaan lebih efisien daripada mengirim permintaan terpisah untuk menambahkan setiap anggota audiens.
Mengirim permintaan serentak
Untuk mengurangi keseluruhan waktu yang diperlukan untuk menyerap data, kirim permintaan serentak ke IngestionService. Sebaiknya kirim hingga 10 permintaan secara serentak untuk mengurangi kemungkinan melampaui batas permintaan per menit.
Anda dapat mengirim permintaan serentak meskipun permintaan tersebut memiliki destinations yang sama.
Menggunakan validateOnly untuk memeriksa error fast-fail
Kirim permintaan dengan validateOnly yang ditetapkan ke true untuk menangkap
error fast-fail. Data Manager API menjalankan pemeriksaan validasi yang sama
seperti permintaan reguler, tetapi tidak menyerap atau menghapus data apa pun.
Permintaan khusus validasi yang berhasil tidak menjamin bahwa tidak akan ada error selama pemrosesan, jadi terus periksa diagnostik setelah Anda mengirim permintaan reguler.
Periksa diagnostik
Ambil dan kumpulkan request_id dari setiap
IngestAudienceMembersResponse atau
IngestEventsResponse, dan gunakan ID permintaan untuk
memeriksa diagnostik.
Memantau dan memberi tahu kuota
Untuk menghindari penolakan permintaan yang tidak terduga, siapkan peringatan kuota dan pemantauan di Konsol Google Cloud. Pemantauan penggunaan kuota membantu Anda melacak pola konsumsi dan mengoptimalkan pengelompokan permintaan sebelum aplikasi Anda mencapai batas harian atau per menit.
Men-deploy ke produksi
Saat beralih dari pengujian lokal ke workload produksi, gunakan Kredensial Default Aplikasi dengan akun layanan terlampir atau Workload Identity Federation untuk melakukan autentikasi secara non-interaktif dan aman.
Untuk mengetahui detail tentang cara mengonfigurasi autentikasi untuk berbagai lingkungan produksi, lihat Men-deploy ke produksi.