تكامل Google Analytics

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

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

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

تمكين User ID

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

ملاحظة

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

إعداد 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 Hardware ID (HWID) لإعداد User ID. يمكنك استخدام معرف مختلف، ولكن كن على علم بعدم وضع عناوين البريد الإلكتروني أو أي معلومات تعريف شخصية أخرى (PII) في User ID لأن هذا لا يتوافق مع سياسة خصوصية 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 الخاصة بك لتشمل 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

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

ملاحظة

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

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

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

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

إرسال إشعارات فورية إلى معرفات المستخدمين في GA

لإرسال إشعار فوري للمستخدمين من جمهور GA الخاص بك، استخدم One-Time Push وفي خطوة الجمهور (Audience) اختر استيراد شريحة (Import segment). قم بتحميل ملف CSV الذي قمت بتصديره من Google Analytics وقم بربط العمود الذي يحتوي على معرفات المستخدمين بحقل User ID. اعرف المزيد