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

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

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

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

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

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

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

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

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

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

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

في ما يلي بعض حالات استخدام إرسال الأحداث المقترَحة والمخصّصة من خلال 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".

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