أفضل الممارسات

يُرجى مراعاة أفضل الممارسات التالية عند استخدام Data Manager API.

إرسال جميع معرّفات المستخدمين

عند إرسال بيانات أعضاء الجمهور أو الأحداث باستخدام UserData، عليك تضمين أكبر عدد ممكن من user_identifiers، بما في ذلك إرسال معرّفات متعدّدة من النوع نفسه.

على سبيل المثال، إذا كان لديك عدة عناوين بريد إلكتروني لمستخدم واحد، أدرِج UserIdentifier منفصلاً لكل عنوان بريد إلكتروني. وبالمثل، إذا كان لديك معرّفات من أنواع مختلفة لمستخدم واحد، مثل عناوين البريد الإلكتروني وأرقام الهواتف والعناوين، أضِف UserIdentifier منفصلاً لكل معرّف، بما يصل إلى الحد الأقصى لعدد المعرّفات.

تحسين الطلبات

للحدّ من احتمال تجاوز حدود الطلبات اليومية، عليك تجميع أكبر عدد ممكن من العناصر في كل طلب، بما لا يتجاوز الحدود المسموح بها لكل طلب.

على سبيل المثال، إذا أردت إضافة 10,000 مستخدم إلى شريحة جمهور، أضِف جميع المستخدمين البالغ عددهم 10,000 إلى audience_members القائمة في IngestAudienceMembersRequest واحدة. إنّ تجميع كل الأعضاء البالغ عددهم 10,000 في طلب واحد أكثر فعالية من إرسال طلب منفصل لإضافة كل عضو من الجمهور.

إرسال طلبات متزامنة

لتقليل الوقت الإجمالي المطلوب لنقل البيانات، أرسِل طلبات متزامنة إلى IngestionService. ننصح بإرسال ما يصل إلى 10 طلبات في الوقت نفسه لتقليل احتمال تجاوز الحدّ الأقصى لعدد الطلبات في الدقيقة.

يمكنك إرسال طلبات متزامنة حتى إذا كانت الطلبات تتضمّن destinations نفسه.

الاطّلاع على بيانات التشخيص

يمكنك تسجيل request_id وجمعه من كل IngestAudienceMembersResponse أو IngestEventsResponse، واستخدام أرقام تعريف الطلبات للتحقّق من بيانات التشخيص.