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 dengan jenis yang sama.
Misalnya, jika Anda memiliki beberapa alamat email untuk seorang pengguna, sertakan
UserIdentifier terpisah untuk setiap alamat email. Demikian pula, jika Anda memiliki ID dengan
jenis yang berbeda 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, gabungkan 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 semua 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 memproses 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 memiliki
destinations yang sama.
Menggunakan validateOnly untuk memeriksa error kegagalan cepat
Kirim permintaan dengan validateOnly yang ditetapkan ke true untuk menangkap
error kegagalan cepat. 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 kesalahan 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 memberikan pemberitahuan tentang kuota
Untuk menghindari penolakan permintaan yang tidak terduga, siapkan pemberitahuan kuota dan pemantauan di konsol Google Cloud. Memantau penggunaan kuota membantu Anda melacak pola penggunaan 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 noninteraktif dan aman.
Untuk mengetahui detail tentang cara mengonfigurasi autentikasi untuk berbagai lingkungan produksi, lihat Men-deploy ke produksi.