يُرجى مراعاة أفضل الممارسات التالية عند استخدام Data Manager API.
إرسال جميع معرّفات المستخدمين
عند إرسال أفراد الجمهور أو الأحداث باستخدام UserData، عليك تضمين أكبر عدد ممكن من user_identifiers، بما في ذلك إرسال معرّفات متعدّدة من النوع نفسه.
على سبيل المثال، إذا كان لديك عناوين بريد إلكتروني متعددة لمستخدم واحد، أدرِج UserIdentifier منفصلاً لكل عنوان بريد إلكتروني. وبالمثل، إذا كانت لديك معرّفات من أنواع مختلفة لمستخدم واحد، مثل عناوين البريد الإلكتروني وأرقام الهواتف والعناوين، أضِف UserIdentifier منفصلاً لكل معرّف، وذلك بما لا يتجاوز الحد الأقصى لعدد المعرّفات.
تحسين الطلبات
للحدّ من احتمال تجاوز حدود الطلبات اليومية، يمكنك تجميع أكبر عدد ممكن من العناصر في كل طلب، وذلك بما لا يتجاوز الحدود المسموح بها لكل طلب.
على سبيل المثال، إذا أردت إضافة 10,000 مستخدم إلى شريحة جمهور، أضِف جميع المستخدمين البالغ عددهم 10,000 إلى القائمة audience_members في IngestAudienceMembersRequest واحدة. إنّ تجميع جميع الأعضاء البالغ عددهم 10,000 في طلب واحد أكثر فعالية من إرسال طلب منفصل لإضافة كل عضو من الجمهور.
إرسال طلبات متزامنة
لتقليل الوقت الإجمالي المطلوب لنقل البيانات، أرسِل طلبات متزامنة إلى IngestionService. ننصح بإرسال ما يصل إلى 10 طلبات في الوقت نفسه للحدّ من احتمال تجاوز الحدّ الأقصى لعدد الطلبات في الدقيقة.
يمكنك إرسال طلبات متزامنة حتى إذا كانت الطلبات تتضمّن
destinations نفسه.
الاطّلاع على بيانات التشخيص
يمكنك تسجيل request_id من كل IngestAudienceMembersResponse أو IngestEventsResponse وجمعه، واستخدام أرقام تعريف الطلبات للتحقّق من بيانات التشخيص.
نشر التطبيق في قناة الإصدار العلني
عند الانتقال من الاختبار المحلي إلى مهام العمل الإنتاجية، استخدِم بيانات الاعتماد التلقائية للتطبيق مع حساب خدمة مرفق أو Workload Identity Federation للمصادقة بشكل آمن وبدون الحاجة إلى التفاعل.
لمزيد من التفاصيل حول ضبط إعدادات المصادقة لبيئات الإنتاج المختلفة، اطّلِع على النشر في بيئة الإنتاج.