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

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

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

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

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

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

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

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

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

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

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