الخميس 30 يوليو 2026
يقدّم الإصدار الأخير من Data Manager API ميزات تبسّط إدارة شرائح الجمهور، وتحسّن سير عمل نقل البيانات من خلال تحذيرات على مستوى الحقل، وتتيح بيانات أكثر دقة يقدّمها المستخدمون في "إحصاءات Google".
إزالة جميع أعضاء الجمهور
استخدِم طريقة
RemoveAllAudienceMembers
الجديدة لإزالة جميع الأعضاء من قوائم مستخدمين محدّدة في عملية واحدة.
تتيح لك المَعلمة الاختيارية removeAsOfTime استهداف الأعضاء الذين تمت إضافتهم قبل طابع زمني معيّن فقط.
ويكون ذلك مفيدًا بشكل خاص عندما تحتاج إلى إجراء إعادة تحميل كاملة (أو "استبدال الكل") لبيانات جمهورك، ما يتيح لك محو القائمة الحالية وملؤها بمجموعة جديدة من المستخدمين.
تحذيرات بشأن حقول نقل البيانات
تتضمّن الآن ردود واجهة Data Manager API على عمليات نقل البيانات تحذيرات تفصيلية على مستوى الحقل بشأن مشاكل التحقّق من صحة البيانات في الحقول الاختيارية. إذا رصدت واجهة برمجة التطبيقات مشاكل في التحقّق من صحة الحقول الاختيارية، سيتم قبول طلب نقل البيانات وستتم معالجة بقية بيانات النقل. ستستمر حالات تعذُّر التحقّق من صحة الحقول المطلوبة في إفشال الطلب بالكامل وفقًا لنموذج الفشل السريع.
إذا كان أي حقل اختياري تقدّمه غير صالح، سيتضمّن الردّ من
IngestEventsRequest
أو
IngestAudienceMembersRequest
الحقل field_warnings مع قائمة من عناصر
FieldWarning. يقدّم كل تحذير سببًا محدّدًا (WarningReason) ورسالة وصفية وموقع الحقل في الطلب الذي حدثت فيه المشكلة.
بيانات العناوين الإضافية لأحداث "إحصاءات Google"
يمكنك الآن تقديم معلومات إضافية عن عنوان المستخدم عند نقل الأحداث إلى وجهات "إحصاءات Google". بالإضافة إلى الحقول given_name وfamily_name وregion_code وpostal_code، يتيح مورد AddressInfo الآن ما يلي:
address_line(عنوان الشارع)city-
administrative_area(الولاية أو المقاطعة)
بالإضافة إلى ذلك، يمكنك الآن استخدام حقل البيانات المقدَّمة من المستخدم (user_data) الحالي لاستيفاء متطلبات المعرّفات للأحداث المتعددة المصادر المُرسَلة إلى مصادر بيانات المواقع الإلكترونية. يمنحك هذا خيارًا آخر عندما لا يكون لديك
ad_identifiers.gclid أو user_id أو
client_id لحدث متعدد المصادر.
البدء
-
تعرَّف على كيفية تنفيذ طريقة
RemoveAllAudienceMembersالجديدة لسير العمل: - راجِع قسم تحذيرات نقل البيانات في دليل فهم أخطاء واجهة برمجة التطبيقات للتعرّف على كيفية التحقّق من الردود بحثًا عن تحذيرات.
- ابدأ بإرسال الأحداث إلى "إحصاءات Google" باستخدام Data Manager API:
إنشاء عمليات الدمج بشكل أسرع باستخدام مهارات وكيل الذكاء الاصطناعي: طرحنا مؤخرًا مهارات جديدة لوكيل Data Manager API لمساعدتك في تسريع عمليات الدمج. يمكنك استكشاف المهارات الجديدة في مستودع Google Skills على GitHub للحصول على إرشادات أكثر دقة وكفاءة مباشرةً ضمن بيئة الترميز بمساعدة الذكاء الاصطناعي.
إذا كانت لديك أي أسئلة أو أردت مناقشة هذا المنشور، يُرجى التواصل معنا على خادم Discord الخاص بـ "منتدى Google للإعلانات والقياس". يمكنك أيضًا التواصل معنا من خلال صفحة الدعم إذا واجهت مشكلة أو كنت بحاجة إلى مساعدة بشأن واجهة برمجة التطبيقات.
إذا أردت أن تصبح شريك بيانات، يُرجى ملء نموذج إبداء الاهتمام بالشراكة.
- ليندسي فولتا، نيابةً عن فريق العمل لواجهة برمجة التطبيقات Data Manager API
التصنيفات: analytics، data-manager-api