تكامل Google Analytics

تحتاج إلى مساعدة المطور

ستحتاج إلى مساعدة من فريق التطوير الخاص بك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.

تتيح لك ميزة معرف المستخدم (User ID) في Google Analytics جمع وتطبيق بيانات مستخدم شاملة عن طريق ربط مصادر بيانات متعددة بنفس المستخدمين. قم بربط Pushwoosh مع Google Analytics واستخدم بيانات GA لتقسيم الجمهور واستهداف حملات إشعارات الدفع الخاصة بك. دعنا نرى كيف يعمل ذلك.

تفعيل معرف المستخدم (User ID)

لتفعيل ميزة معرف المستخدم (User ID) في حساب Google Analytics الخاص بك، اتبع دليل Google: https://support.google.com/analytics/answer/3123666

ملاحظة

لا تنس إنشاء عرض تقارير معرف المستخدم (User ID) (كما هو موضح في الخطوة 3 من دليل GA حول تفعيل معرف المستخدم).

إعداد معرف المستخدم (User ID) في كود التتبع الخاص بك

ملاحظة

نحن متوافقون مع Google Tag Manager

نحن نشجع على استخدام Google Tag Manager (GTM) لدمج Pushwoosh SDK. الكود التالي يعتمد على GTM، ولكن من السهل تعديله ليعمل كـ Javascript بسيط على الصفحة.

دمج Pushwoosh Web SDK

لدمج Pushwoosh SDK في Google Tag Manager الخاص بك، اتبع دليل Web Push SDK.

إنشاء علامة معرف المستخدم (User ID) في GTM

أنشئ علامة HTML مخصصة (Custom HTML Tag) تعمل على مشغل كل الصفحات (All Pages). استخدم الكود التالي لإعداد معرف المستخدم (User ID) الذي يطابق بيانات المستخدم بين Pushwoosh و Google Analytics.

في المثال أدناه، نستخدم معرف جهاز Pushwoosh (HWID) لإعداد معرف المستخدم (User ID). يمكنك استخدام معرف مختلف، ولكن كن على علم بعدم وضع عناوين بريد إلكتروني أو أي معلومات أخرى يمكن التعرف عليها شخصيًا (PII) في معرف المستخدم لأن هذا لا يتوافق مع سياسة خصوصية Google Analytics.

JavaScript

<script>
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var registrationId = localStorage.deviceRegistrationId;
  var gaRegistered = registrationStatus === 'registered' ? registrationId : false;

  if (!gaRegistered) {
    var Pushwoosh = Pushwoosh || [];
    Pushwoosh.push(['onPermissionGranted', function(api) {
      api.getParams()
        .then(function(params) {
          var hwid = params.hwid;
          ga('set', 'userId', hwid);
          ga('send', 'pageview');
          localStorage.setItem('deviceRegistrationId', hwid);
          api.registerUser(hwid);
        })
    }])
};
</script>

إضافة معرف المستخدم (User ID) إلى علامة مشاهدة الصفحة (Page View)

عدّل علامة مشاهدة الصفحة (Page View tag) لتشمل معرف المستخدم (User ID) إذا كان معروفًا للمستخدم:

JavaScript

<script>
  var hwid = localStorage.deviceRegistrationId;
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var isNeedToTrackUser = hwid && registrationStatus === "registered";

  if (isNeedToTrackUser) {
    ga('set', 'userId', hwid);
  };
  ga('send', 'pageview');
</script>

الاختبار باستخدام تقرير تغطية معرف المستخدم (User ID)

لاختبار التكامل، استخدم “تقرير تغطية معرف المستخدم”: https://support.google.com/analytics/answer/3123670

ملاحظة

يرجى ملاحظة أن GA يستغرق حوالي يوم لمعالجة البيانات.

مستكشف المستخدم (User Explorer)

حدد عرض تقارير معرف المستخدم (User ID) الخاص بك في Google Analytics. أضف أي شرائح هناك لتقسيم جمهورك وتحليله.

يمكنك رؤية معرفات المستخدمين (User IDs) الخاصة بك معروضة في عمود “User ID”.

اضغط على زر تصدير (Export) وحدد خيار “CSV”.

إرسال إشعارات الدفع باستخدام معرفات مستخدمي GA

انتقل إلى علامة التبويب CSV Push في لوحة تحكم Pushwoosh الخاصة بك وقم بتحميل ملف CSV الذي تم تصديره في الخطوة السابقة.

حدد العمود الأول واختر “User ID” لنوع البيانات. حدد إعدادًا مسبقًا (preset) في حقل القائمة المنسدلة المقابل، وحدد التاريخ (إذا لزم الأمر)، وانقر على Woosh!

لقد أرسلت للتو إشعار دفع إلى المستخدمين من Google Analytics