استخدِم Data Manager API لإرسال الأحداث المقترَحة والأحداث المخصّصة في "إحصاءات Google".
اطّلِع على مقالة إرسال الأحداث لمزيد من التفاصيل.
إذا كنت بصدد الترقية من Measurement Protocol في "إحصاءات Google"، اطّلِع على الترقية من Measurement Protocol إلى Data Manager API للحصول على التعليمات.
حالات الاستخدام
في ما يلي بعض حالات الاستخدام لإرسال الأحداث المقترَحة والمخصّصة باستخدام Data Manager API:
ربط السلوك على الإنترنت بالسلوك خارج إطار الإنترنت
قياس التفاعلات من جهة العميل ومن جهة الخادم
إرسال الأحداث غير الناتجة عن التفاعلات الإلكترونية العادية للمستخدم، مثل الإحالات الناجحة غير الإلكترونية
إرسال الأحداث من الأجهزة والتطبيقات التي لا يتوفّر فيها التجميع التلقائي، مثل أكشاك البيع والساعات
البيانات المقدَّمة من المستخدم
يمكنك إرسال بيانات العملاء التابعة للطرف الأول، مثل عناوين البريد الإلكتروني المجزّأة وأرقام الهواتف والعناوين الجغرافية، في الحقل userData الخاص بـ Event. يساعد ذلك في تحسين قياس الإحالات الناجحة وتحديد المصدر وإنشاء شرائح الجمهور في "إحصاءات Google".
يُرجى مراعاة ما يلي عند إرسال البيانات المقدَّمة من المستخدم:
البيانات المُرسَلة مع الأحداث: في Data Manager API، يجب إرسال البيانات المقدَّمة من المستخدم كجزء من
Event. لا تتوفّر عمليات التحميل المستقلة التي لا تتضمّن حدثًا.التنسيق والتجزئة: يجب تسوية المعرّفات الشخصية (مثل عنوان البريد الإلكتروني ورقم الهاتف والاسم وعنوان الشارع) وتجزئتها باستخدام خوارزمية SHA-256 قبل التحميل. يتم تعديل الحقول الأخرى (مثل المدينة أو الولاية أو المقاطعة والرمز البريدي ورمز البلد) ولكن لا يتم تجزئتها. اتّبِع دليل تنسيق بيانات المستخدمين للاطّلاع على المتطلبات المحدّدة.
التشفير: يمكنك اختياريًا تشفير بيانات المستخدمين المجزّأة.
معرّف المستخدم: ننصح بتقديم
userIdإلى جانبuserDataكلما توفّر معرّف مستخدم متّسق.التنفيذ: راجِع مقالة إضافة البيانات المقدَّمة من المستخدِم للاطّلاع على تعليمات حول إنشاء الطلبات.
اعتبارات الدمج
يجب مراعاة ما يلي عند استخدام Data Manager API.
تجديد النشاط التسويقي
تتيح "إحصاءات Google" تجديد النشاط التسويقي على الجهاز نفسه عند تفعيل إشارات Google. لتجديد النشاط التسويقي على أجهزة متعددة، يجب توفُّر userId.
بالإضافة إلى ذلك، يمكنك إرسال البيانات المقدَّمة من المستخدِم لتفعيل ميزة مطابقة شرائح الجمهور التابعة للطرف الأول.
المعرّفات الإعلانية
تربط "إحصاءات Google" تلقائيًا معرّفات الإعلانات (مثل GBRAID أو WBRAID) التي يتم جمعها أثناء التفاعلات على الإنترنت مع أحداث Data Manager API باستخدام clientId أو appInstanceId.
إعدادات الخصوصية
تربط "إحصاءات Google" أحداث Data Manager API بالتفاعلات على الإنترنت باستخدام clientId أو appInstanceId من أجل تطبيق إعدادات خصوصية المستخدم، مثل "الإعلانات غير المخصّصة" و"الحدّ من تتبُّع الإعلانات".
يمكنك أيضًا تحديد إعدادات موافقة المستخدِم مباشرةً في كلّ حدث باستخدام العنصر
consent.
معلومات الموقع الجغرافي والجهاز
تضمّن "إحصاءات Google" تلقائيًا أحدث المعلومات الجغرافية ومعلومات الأجهزة
من وضع العلامات مع أحداث Data Manager API باستخدام clientId أو appInstanceId.
يضمن ذلك ظهور أحداث Data Manager API في التقارير التي تتضمّن سمات جغرافية وسمات الأجهزة.
إذا أردت أن يعرض حدث Data Manager API معلومات جغرافية ومعلومات عن الجهاز من جلسة محدّدة بدلاً من أحدث المعلومات الخاصة بـ clientId أو appInstanceId، أدرِج إدخالاً في additionalEventParameters مع ضبط parameterName على session_id وضبط value على معرّف الجلسة المحدّدة، وأرسِل الحدث في غضون 24 ساعة من بدء الجلسة.
يمكنك تقديم معلومات جغرافية ومعلومات عن الجهاز للأحداث باستخدام Data Manager API.
الدمج الكامل من خادم إلى خادم
مع أنّه من الممكن إرسال الأحداث إلى "إحصاءات Google" باستخدام Data Manager API فقط، قد لا تتوفّر سوى تقارير جزئية. الغرض من واجهة برمجة التطبيقات Data Manager API هو تحسين الأحداث الحالية التي يتم جمعها باستخدام علامة الموقع الشاملة (gtag) أو أداة "إدارة العلامات من Google" أو Firebase. بعض أسماء الأحداث والمَعلمات محجوزة للاستخدام من خلال عملية الجمع التلقائي، ولا يمكن إرسالها من خلال Data Manager API.
إنشاء الأحداث أو إعادة تسميتها
لا تؤدي الأحداث المُرسَلة باستخدام Data Manager API إلى تفعيل قواعد إنشاء الأحداث أو إعادة تسميتها. يجب أن يطبّق تطبيقك منطقًا لإرسال أحداث مخصّصة من خلال Data Manager API، على غرار القواعد التي تم ضبطها في واجهة مستخدم "إحصاءات Google".