الأحداث المقترَحة والمخصّصة في "إحصاءات Google"

استخدِم Data Manager API لإرسال الأحداث المقترَحة والأحداث المخصّصة في "إحصاءات Google".

إرسال الأحداث المقترَحة والمخصّصة

إذا كنت تُجري ترقية من Measurement Protocol في "إحصاءات Google"، اطّلِع على الترقية من Measurement Protocol إلى Data Manager API للحصول على التعليمات.

نظرة عامة على سير العمل

لإرسال بيانات الأحداث باستخدام Data Manager API، أكمِل الخطوات التالية:

  1. إعداد الوجهات: حدِّد عناصر Destination لحقل destinations في طلب نقل البيانات من أجل تحديد الحساب المستهدَف ووجهة الإحالة الناجحة أو الحدث. يُرجى الاطّلاع على إعداد الوجهات لمعرفة التفاصيل.

  2. إعداد بيانات الأحداث والمعرّفات: أنشئ كل Event وضمِّن أي حقول ومعرّفات مطلوبة. يجب تسوية أي معلومات اتصال للمستخدمين وتجزئتها باستخدام خوارزمية SHA-256 في userData وفقًا لإرشادات التنسيق، وتشفيرها اختياريًا. لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد بيانات الأحداث.

  3. إنشاء طلب نقل البيانات وإرساله: أرسِل طلب events.ingest يحتوي على destinations وسجلات Event وencryptionInfo في حال تشفير userData. استخدِم validateOnly: true لاختبار الحمولة بحثًا عن أخطاء الفشل السريع قبل إرسال بيانات الإنتاج. يُرجى الاطّلاع على إرسال الأحداث لمعرفة متطلبات الحقول وعينات التعليمات البرمجية.

  4. التحقّق من حالة الطلب وبيانات التشخيص: يمكنك التحقّق من حالة المعالجة غير المتزامنة ومراجعة بيانات التشخيص باستخدام requestStatus.retrieve.

حالات الاستخدام

في ما يلي بعض حالات الاستخدام لإرسال الأحداث المقترَحة والمخصّصة من خلال Data Manager API:

  • ربط السلوك على الإنترنت بالسلوك خارج إطار الإنترنت

  • قياس التفاعلات من جهة العميل ومن جهة الخادم

  • إرسال الأحداث غير الناتجة عن التفاعلات الإلكترونية العادية للمستخدم، مثل الإحالات الناجحة غير الإلكترونية

  • يمكنك إرسال الأحداث من الأجهزة والتطبيقات التي لا يتوفّر فيها الجمع التلقائي، مثل أجهزة kiosk والساعات.

البيانات المقدَّمة من المستخدم

يمكنك إرسال بيانات عملاء الطرف الأول، مثل عناوين البريد الإلكتروني وأرقام الهواتف والعناوين الجغرافية المجزّأة، في حقل 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".

التالي
إرسال الأحداث