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