يُرجى مراعاة أفضل الممارسات التالية عند استخدام 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، واستخدِم أرقام تعريف الطلبات
للاطّلاع على بيانات التشخيص.
مراقبة الحصص وإرسال تنبيهات بشأنها
لتجنُّب رفض الطلبات بشكل غير متوقّع، يمكنك إعداد تنبيهات الحصص ومراقبتها في وحدة تحكّم Google Cloud. تساعدك مراقبة استخدام الحصة في تتبُّع أنماط الاستهلاك وتحسين تجميع الطلبات قبل أن يصل تطبيقك إلى الحدود اليومية أو الحدود لكل دقيقة.
النشر في قناة الإصدار العلني
عند الانتقال من الاختبار المحلي إلى أعباء العمل في مرحلة الإنتاج، استخدِم بيانات الاعتماد التلقائية للتطبيق مع حساب خدمة مرفق أو Workload Identity Federation للمصادقة بشكل غير تفاعلي وآمن.
لمعرفة تفاصيل حول ضبط المصادقة لبيئات التشغيل الفعلي المختلفة، يُرجى الاطّلاع على النشر في بيئة التشغيل الفعلي.