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

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

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

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

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

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

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

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

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

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

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

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

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