> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تحليلات الطرف الثالث

> تتبع عدد مرات عرض الصفحة وأحداث التجارة الإلكترونية على صفحات Dodo Payments المستضافة باستخدام Google Analytics 4 وGoogle Tag Manager وMeta Pixel.

<Frame>
  <img src="https://mintcdn.com/dodopayments/OJISfHo1pPGtWHk9/images/analytics-cover.png?fit=max&auto=format&n=OJISfHo1pPGtWHk9&q=85&s=6f9b234fb9bb78755cd79b315e594826" alt="التكامل مع التحليلات" style={{ maxHeight: '500px', width: 'auto' }} width="2866" height="1436" data-path="images/analytics-cover.png" />
</Frame>

تتبع مسارات العملاء من واجهة متجر التسجيل حتى إكمال الشراء. يتكامل Dodo Payments مع Google Analytics 4 وGoogle Tag Manager وMeta Pixel لتوفير تحليلات شاملة عبر جميع صفحاتك المستضافة.

<Info>
  يتم تمكين تتبع التحليلات تلقائيًا على واجهة متجرك وصفحات الخروج وبوابة العملاء بعد إضافة معرفات التتبع في لوحة التحكم.
</Info>

<Warning>
  يمكن لمانعات الإعلانات في متصفحات العملاء أن تمنع عمل تتبع التحليلات لبعض الزوار.
</Warning>

## المنصات المدعومة

<CardGroup cols={3}>
  <Card title="Google Analytics 4" icon="chart-simple">
    عرض الصفحات وتتبع التجارة الإلكترونية باستخدام GA4.
  </Card>

  <Card title="Google Tag Manager" icon="tags">
    أضف وادِر علامات التسويق.
  </Card>

  <Card title="Meta Pixel" icon="meta">
    تتبع تحويلات إعلانات Facebook وInstagram.
  </Card>
</CardGroup>

## البدء

<Steps>
  <Step title="Open Business Settings">
    في لوحة تحكم Dodo Payments، انتقل إلى **الإعدادات → الأعمال** وانتقل إلى قسم **التحليلات**.
  </Step>

  <Step title="Enable Your Tracking Platform">
    فعّل المنصة التحليلية التي ترغب باستخدامها وأدخل معرف التتبع الخاص بك:

    * **Google Analytics**: أدخل معرف القياس (التنسيق: `G-XXXXXXXXXX`)
    * **Google Tag Manager**: أدخل معرف الحاوية (التنسيق: `GTM-XXXXXXX`)
    * **Meta Pixel**: أدخل معرف البكسل (رقمي، من 10 إلى 20 رقمًا)
  </Step>

  <Step title="Save Your Settings">
    انقر فوق **حفظ** لتطبيق إعدادات التتبع.
  </Step>

  <Step title="Verify Tracking">
    قم بزيارة واجهة متجرك أو أنشئ اختبار خروج للتحقق من تتبع الأحداث في لوحة تحليلاتك.
  </Step>
</Steps>

## Google Analytics 4

يوفر [Google Analytics 4](https://marketingplatform.google.com/about/analytics/) تحليلات ويب شاملة مع قدرات تتبع التجارة الإلكترونية. مع تكامل Dodo Payments، يمكنك تتبع رحلة العميل الكاملة من تصفح متجرك حتى إتمام الشراء.

### أضف معرف قياس Google Analytics الخاص بك

1. في Google Analytics، انتقل إلى **المسؤول** → **تيارات البيانات** → حدد تيار الويب الخاص بك
2. انسخ **معرف القياس** (يبدأ بـ `G-`)
3. في لوحة تحكم Dodo Payments، انتقل إلى **الإعدادات** → **الأعمال** → **التحليلات**
4. فعل **تحليلات جوجل** والصق معرف القياس الخاص بك
5. انقر **حفظ**

<Tip>
  إذا لم يكن لديك ملكية في Google Analytics بعد، فاتبع [دليل إعداد Google](https://support.google.com/analytics/answer/9304153) لإنشاء واحدة.
</Tip>

### الأحداث المتتبعة في Google Analytics

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

#### أحداث واجهة المتجر

| الحدث            | الوصف                                          |
| ---------------- | ---------------------------------------------- |
| `view_item_list` | يتم تشغيله عند تحميل صفحة المتجر مع المنتجات   |
| `select_item`    | يتم تشغيله عند نقر العميل على منتج لبدء الخروج |

#### أحداث الخروج

| الحدث               | الوصف                                        |
| ------------------- | -------------------------------------------- |
| `view_item`         | يتم تشغيله عند تحميل صفحة الخروج             |
| `view_cart`         | يتم تشغيله عند تحميل الخروج وعند تحديد متغير |
| `apply_discount`\*  | يتم تشغيله عند تطبيق رمز خصم صالح بنجاح      |
| `remove_discount`\* | يتم تشغيله عند إزالة رمز خصم                 |
| `add_payment_info`  | يتم تشغيله عند تقديم العميل نموذج الدفع      |
| `purchase`          | يتم تشغيله عند نجاح الدفع                    |

<Note>
  `apply_discount` و`remove_discount` هما أحداث مخصصة غير مدرجة ضمن [أحداث التجارة الإلكترونية القياسية في Google Analytics](https://support.google.com/analytics/answer/9267735).
</Note>

### استخدام GA4 مع الخروج المتراكب/المضمن

لتتبع أحداث Google Analytics في الخروج المتراكب أو المضمن على موقعك الخاص، تحتاج إلى تثبيت كود تتبع Google Analytics على موقعك حيث يتم تضمين الخروج.

بمجرد التثبيت، سيتم إرسال جميع أحداث التتبع المذكورة أعلاه تلقائيًا إلى حساب Google Analytics الخاص بك — لا حاجة لتكوين إضافي.

## Google Tag Manager

يسمح لك [Google Tag Manager](https://marketingplatform.google.com/about/tag-manager/) بإدارة علامات التسويق والتحليلات بدون تعديل الكود. سيتم تشغيل العلامات الموزعة عبر GTM على جميع صفحات Dodo Payments المستضافة.

### أضف معرف حاوية GTM

1. في Google Tag Manager، انسخ **معرف الحاوية** (يبدأ بـ `GTM-`)
2. في لوحة تحكم Dodo Payments، انتقل إلى **الإعدادات** → **الأعمال** → **التحليلات**
3. فعل **Google Tag Manager** والصق معرف الحاوية الخاص بك
4. انقر **حفظ**

<Info>
  عند استخدام GTM، يمكنك تكوين تتبع إضافي (مثل تحويلات إعلانات Google) مباشرة في حاوية GTM الخاصة بك. يحقن تكامل Dodo Payments كلًا من سكربت GTM ونسخة noscript لتحقيق أقصى توافق.
</Info>

### استخدام GTM مع الخروج المتراكب/المضمن

لخروج متراكب أو مضمن في موقعك، ثَبّت GTM على موقعك الخاص. سترث صفحة الخروج تكوين GTM الخاص بك وتطلق الأحداث داخل الإطار المضمن.

## Meta Pixel

[Meta Pixel](https://www.facebook.com/business/tools/meta-pixel/) يتتبع إجراءات العملاء على متجرك لقياس فعالية حملاتك الإعلانية على Facebook وInstagram. تتبع التحويلات من النقر على الإعلان حتى إكمال الشراء.

### أضف معرف Meta Pixel الخاص بك

1. في [مدير أحداث Meta](https://www.facebook.com/events_manager2/)، قم بإنشاء أو تحديد Pixel الخاص بك
2. انسخ **معرف البكسل** (رقمي، عادةً 15-16 رقمًا)
3. في لوحة تحكم Dodo Payments، انتقل إلى **الإعدادات** → **الأعمال** → **التحليلات**
4. فعل **Meta Pixel** والصق معرف البكسل الخاص بك
5. انقر **حفظ**

<Tip>
  اتبع [دليل إعداد البكسل](https://www.facebook.com/business/help/952192354843755) الخاص بMeta إذا لم تنشئ بكسل بعد.
</Tip>

### الأحداث المتتبعة مع Meta Pixel

نقوم بتتبع الأحداث التالية التي تظهر في [Meta Events Manager](https://www.facebook.com/events_manager2/). يتم إرسال بيانات الحدث بما في ذلك معرفات المحتوى والقيم والعملة مع كل حدث.

<Note>
  قد لا تظهر الأحداث فورًا في Meta Events Manager — قد يكون هناك تأخير لعدة دقائق.
</Note>

#### أحداث واجهة المتجر

| الحدث              | الوصف                                          |
| ------------------ | ---------------------------------------------- |
| `PageView`         | يتم تشغيله عند تحميل صفحة المتجر               |
| `ViewContent`      | يتم تشغيله عند تحميل المتجر مع المنتجات        |
| `InitiateCheckout` | يتم تشغيله عند نقر العميل على منتج لبدء الخروج |

#### أحداث الخروج

| الحدث              | الوصف                                        |
| ------------------ | -------------------------------------------- |
| `PageView`         | يتم تشغيله عند تحميل صفحة الخروج             |
| `AddToCart`        | يتم تشغيله عند تحميل الخروج وعند تحديد متغير |
| `ApplyDiscount`\*  | يتم تشغيله عند تطبيق رمز خصم صالح بنجاح      |
| `RemoveDiscount`\* | يتم تشغيله عند إزالة رمز خصم                 |
| `AddPaymentInfo`   | يتم تشغيله عند تقديم العميل نموذج الدفع      |
| `Purchase`         | يتم تشغيله عند نجاح الدفع                    |

<Note>
  `ApplyDiscount` و`RemoveDiscount` هما أحداث مخصصة غير مدرجة ضمن [الأحداث القياسية لMeta](https://developers.facebook.com/docs/meta-pixel/reference#standard-events).
</Note>

## مرجع الأحداث الكامل

يوضح هذا الجدول جميع الأحداث المتتبعة عبر Google Analytics 4 وMeta Pixel:

| الزناد                      | حدث GA4            | حدث Meta Pixel     | الموقع       |
| --------------------------- | ------------------ | ------------------ | ------------ |
| تحميل صفحة المتجر           | `view_item_list`   | `ViewContent`      | واجهة المتجر |
| نقر العميل على منتج         | `select_item`      | `InitiateCheckout` | واجهة المتجر |
| تحميل صفحة الخروج           | `view_item`        | `AddToCart`        | الخروج       |
| تم عرض السلة/تم تحديد متغير | `view_cart`        | -                  | الخروج       |
| تم تطبيق رمز خصم            | `apply_discount`   | `ApplyDiscount`    | الخروج       |
| تم إزالة رمز خصم            | `remove_discount`  | `RemoveDiscount`   | الخروج       |
| تم تقديم نموذج الدفع        | `add_payment_info` | `AddPaymentInfo`   | الخروج       |
| تم نجاح الدفع               | `purchase`         | `Purchase`         | الخروج       |

## تغطية المنصات

يتوفر تتبع التحليلات عبر مختلف واجهات Dodo Payments:

| الواجهة                | Google Analytics 4 | Google Tag Manager | Meta Pixel |
| ---------------------- | ------------------ | ------------------ | ---------- |
| واجهة المتجر           | نعم                | نعم                | نعم        |
| الخروج (مستضاف)        | نعم                | نعم                | نعم        |
| الخروج (متراكب/مضمن)\* | نعم                | نعم                | نعم        |
| بوابة العملاء          | نعم                | نعم                | لا         |

<Info>
  \*بالنسبة للخروج المتراكب والمضمن، ثَبّت كود التتبع على موقعك الخاص للحصول على نسب تتبع كاملة. سيتم تتبع الأحداث من الخروج المضمن تلقائيًا.
</Info>

## بيانات الحدث المضمنة

يشتمل كل حدث تتبع على بيانات تجارة إلكترونية ذات صلة لمساعدتك في تحليل سلوك العملاء:

### بيانات المنتج

* معرف المنتج
* اسم المنتج
* السعر
* العملة
* الكمية

### بيانات المعاملة (أحداث الشراء)

* معرف المعاملة/الدفع
* إجمالي المبلغ
* مبلغ الضريبة
* العملة
* الخصم المطبق

### بيانات العميل

* معرف العميل (للعملاء العائدين)
* البريد الإلكتروني (مشفّر للخصوصية عند الاقتضاء)

## أفضل الممارسات

<AccordionGroup>
  <Accordion title="Test Your Integration">
    بعد إضافة معرفات التتبع، قم بزيارة واجهة متجرك وأكمل اختبار خروج للتحقق من ظهور الأحداث في لوحات تحليلك. استخدم تقارير الوقت الفعلي في Google Analytics أو ميزة تجارب الاختبار في Meta Events Manager.
  </Accordion>

  <Accordion title="Use UTM Parameters">
    أضف معلمات UTM إلى روابط التسويق الخاصة بك لتتبع الحملات التي تحقق التحويلات. يحتفظ Dodo Payments بمعلمات UTM طوال تدفق الخروج.
  </Accordion>

  <Accordion title="Set Up Conversion Goals">
    في Google Analytics، أنشئ أحداث تحويل لـ `purchase` لتتبع معدل التحويل لديك. في Meta Ads Manager، استخدم حدث `Purchase` كهدف تحسين للحملات.
  </Accordion>

  <Accordion title="Enable Enhanced E-commerce">
    إذا كنت تستخدم Google Tag Manager، فكر في إعداد تقارير التجارة الإلكترونية المحسّنة لتحليل مسار التحويل بالتفصيل وقياسات أداء المنتج.
  </Accordion>
</AccordionGroup>

## استكشاف المشاكل وإصلاحها

<AccordionGroup>
  <Accordion title="Events not appearing in Google Analytics">
    * تحقق من صحة معرف القياس (التنسيق: `G-XXXXXXXXXX`)
    * راجع تقارير الوقت الفعلي في Google Analytics — تظهر الأحداث هناك أولًا
    * تأكد من تمكين التبديل في إعدادات Dodo Payments
    * انتظر بضع دقائق فقد تكون هناك تأخيرات في المعالجة
    * اختبر في نافذة تصفح خاصة لاستبعاد مانعات الإعلانات
  </Accordion>

  <Accordion title="Events not appearing in Meta Events Manager">
    * تحقق من صحة معرف البكسل (رقمي، من 10 إلى 20 رقمًا)
    * استخدم امتداد Meta Pixel Helper في المتصفح للتصحيح
    * افحص علامة تبويب الأحداث التجريبية في Events Manager
    * قد تستغرق الأحداث عدة دقائق للظهور
    * تأكد من تعطيل مانعات الإعلانات أثناء الاختبار
  </Accordion>

  <Accordion title="GTM tags not firing">
    * تأكد من صحة معرف الحاوية (التنسيق: `GTM-XXXXXXX`)
    * استخدم وضع المعاينة في GTM لتصحيح إطلاق العلامات
    * تحقق من تكوين الزناد بشكل صحيح في حاوية GTM
    * تأكد من نشر الحاوية (وليس فقط بحالة مسودة)
  </Accordion>

  <Accordion title="Overlay/Inline checkout not tracking">
    * ثَبّت كود التتبع على موقعك أولًا
    * تأكد من تحميل التتبع قبل فتح النافذة المنبثقة للخروج
    * تحقق من وحدة تحكم المتصفح لأية أخطاء JavaScript
    * تحقق من تكوين التتبع عبر النطاقات إذا كنت تستخدم GA4
  </Accordion>

  <Accordion title="Purchase events showing wrong amounts">
    * يتم إرسال المبالغ بأصغر وحدة للعملة (السنت)
    * تأكد من تكوين أداة التحليلات لعرض العملة الصحيحة
    * تحقق مما إذا كانت الضرائب مشمولة/مستثناة كما هو متوقع
  </Accordion>
</AccordionGroup>

## الموارد ذات الصلة

<CardGroup cols={2}>
  <Card title="Segment Integration" icon="chart-line" href="/integrations/segment">
    أرسل أحداث الدفع إلى Segment من أجل تحليلات متقدمة وتكامل CDP.
  </Card>

  <Card title="Dub Integration" icon="https://mintcdn.com/dodopayments/LYWHtNbGSpS1P01t/images/logos/dub.svg?fit=max&auto=format&n=LYWHtNbGSpS1P01t&q=85&s=c36ca87c0811f65b3d8a4a79e4a34242" href="/integrations/dub" width="64" height="64" data-path="images/logos/dub.svg">
    تتبع تحويلات المبيعات ونسب الإحالة مع Dub.
  </Card>

  <Card title="Customer.io Integration" icon="envelope" href="/integrations/customer-io">
    أطلق حملات بريد إلكتروني آلية بناءً على أحداث الدفع.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developer-resources/webhooks">
    أنشئ تكاملات تحليلات مخصصة باستخدام أحداث الويب هوك.
  </Card>
</CardGroup>