تكامل 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

أنشئ 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. أضف أي شرائح (segments) هناك لتقسيم جمهورك وتحليله.

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

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

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