# تكامل Google Analytics

<Aside type="caution" icon="setting" title="تحتاج إلى مساعدة المطور">
 ستحتاج إلى مساعدة من فريق التطوير الخاص بك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.
</Aside>

تتيح لك ميزة [User ID (معرف المستخدم)](https://support.google.com/analytics/answer/3123662?authuser=1) في Google Analytics جمع وتطبيق بيانات مستخدم شاملة عن طريق ربط مصادر بيانات متعددة بنفس المستخدمين.
اربط Pushwoosh مع Google Analytics واستخدم بيانات GA لتقسيم الجمهور واستهداف حملات الإشعارات الفورية (push notifications). لنرى كيف يعمل ذلك.

## تمكين User ID

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

<Aside type="note">
لا تنس إنشاء عرض تقارير User ID (كما هو موضح في _الخطوة 3_ من دليل GA حول تمكين User ID).
</Aside>

## إعداد User ID في كود التتبع الخاص بك

<Aside type="note">
 نحن متوافقون مع Google Tag Manager

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

## دمج Pushwoosh Web SDK

لدمج Pushwoosh SDK في Google Tag Manager الخاص بك، اتبع [دليل Web Push SDK](/ar/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30#installing-from-google-tag-manager).

## إنشاء علامة 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](https://policies.google.com/privacy).

```javascript title="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>
```

<img src="/integrations-google-analytics-integration-1.webp" alt="علامة HTML مخصصة في Google Tag Manager لإعداد User ID"/>

## إضافة User ID إلى علامة Page View

عدّل **علامة Page View** الخاصة بك لتشمل User ID إذا كان معروفًا للمستخدم:

```javascript title="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>
```

<img src="/integrations-google-analytics-integration-2.webp" alt="تكوين علامة Page View مع User ID"/>

## الاختبار باستخدام تقرير تغطية User ID

لاختبار التكامل، استخدم "تقرير تغطية User ID":\
[https://support.google.com/analytics/answer/3123670](https://support.google.com/analytics/answer/3123670)

<Aside type="note">
يرجى ملاحظة أن GA يستغرق حوالي يوم لمعالجة البيانات.
</Aside>

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

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

<img src="/integrations-google-analytics-integration-3.webp" alt="زر شريحة جديدة لتقسيم الجمهور إلى شرائح"/>

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

<img src="/integrations-google-analytics-integration-4.webp" alt="عمود User ID يعرض معرفات المستخدمين"/>

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

لإرسال إشعار فوري للمستخدمين من جمهور GA الخاص بك، استخدم [One-Time Push](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) وفي خطوة **الجمهور (Audience)** اختر **استيراد شريحة (Import segment)**. قم بتحميل ملف CSV الذي قمت بتصديره من Google Analytics وقم بربط العمود الذي يحتوي على معرفات المستخدمين بحقل User ID. [اعرف المزيد](/ar/product/audience-data-and-segmentation/segmentation/create-segments/by-import/#how-to-import-a-segment)