# Google Analytics

* [أي إصدار من التحليلات يجب استخدامه](#which-version-of-the-analytics-to-use) 
* [كيفية إنشاء خاصية وضبطها على صفحة هبوط مصغّرة ](#how-to-create-and-set-a-property-on-a-mini-landing)
* [كيفية مشاركة معرّف عميل Google (\_ga) من صفحة الهبوط المصغّرة مع المتغيرات](#how-to-share-google-client-id-_ga-from-the-mini-landing-with-variables) 
* [كيفية نقل بيانات GA من Salebot](#how-to-transfer-ga-data-from-salebot) 
* [كيفية إعداد أهداف الأحداث ](#how-to-configure-event-goals)
* [كيفية نقل الأحداث ](#how-to-transfer-events)
* [كيفية استخدام طلبات من نوع مشاهدة الصفحة (t:pageview)](#how-to-use-requests-of-the-page-view-type-t-pageview) 
* [كيفية استخدام التجارة الإلكترونية](#how-to-use-e-commerce) 
* [درس فيديو](#video-tutorial)

## أي إصدار من التحليلات يجب استخدامه

{% hint style="warning" %}
لا يعمل التكامل مع Google Analytics إلا مع إصدار Universal Analytics.
{% endhint %}

يتم إنشاء الخصائص الجديدة افتراضيًا في إصدار GA4. سيتم تجاهل طلباتنا.

تحتاج إلى إنشاء التحليلات مع تشغيل المفتاح (كما هو موضح في لقطة الشاشة أدناه)

![](https://lh6.googleusercontent.com/Op7DykeJFlC4pQfxEonkY3UVIwm6ovCB80C-p6TJCsgEv-tw4UNIkyxySmZwUOa6jFDrItQb5ZdQx47-sXFwDEmSYK6-dSVhRh0rBnuYN7PXIB-_QUYqwwPVOofMrR9Zg-WzLPnWMIV1qNCa5A)

![](https://lh6.googleusercontent.com/sNoqcFTjekH2SnOsfUr1l_gXOYexOAcyLt7vq1xEJ5JKVD28z_iArTJpk8Mw_OujMRdS3OvvNwzq8tRzwUS1DWz-jRfhHZ4wSErG6g1O8VBe0XQuyDB4vg6lrqLc_kTDtSyDogGoX29SxVh5xw)

## كيفية إنشاء خاصية وضبطها على صفحة هبوط مصغّرة

أنشئ خاصية على <https://analytics.google.com/>

انتقل إلى معلومات التتبع -> رمز التتبع

![](https://lh3.googleusercontent.com/mYXiIfwXUgjnZg3HjFsk8UzOnwoWgs-9qgMTZJJv3Fky4miW3flXYSBW83n6fjR-3uZZpaYlgjXDis8CO8TDrpxGtjyQLVe4iARbYJRf88qF5qF-VcIn_AJc8ND4p6f2G7V3dhaGCW708CUQqg)

انسخ الرمز والصقه في قسم الرأس من صفحة الهبوط المصغّرة

![](https://lh6.googleusercontent.com/BNpAF4ovJ-fB0bsidS7hbuZ1GmlyLotWlPIltMGiTXjF-nSkQE0LgRHgcZLc2wez8yZb6nyoKaRApAd1mLOXEMJhJzaudNnVUjNCRRhfT7-E_-teFsd9gCySEYNvFcjuxFl18gNVCvBUsl37Wg)

![](https://lh4.googleusercontent.com/P0rvT-N9D4km0VVgQqDGQyk4mPHcPZ4JY6t_9lYAskp-Bw5i8oKpu4wIRGCEkxuHkuwUB1XkjFwaxzjTBkAJLU6AzV1R9hc1SjRMIyPyyRYzA1ADC2hQlrKHZoGA-4iGEq8e2LOpbSlBJRkkiA)

لتسهيل العمل لاحقًا، يُنصح بإضافة الخصائص إلى صفحات الهبوط المصغّرة باستخدام Google Tag Manager، لكنه ليس إلزاميًا.

بعد ذلك تحتاج إلى العثور على معرّف التتبع في إعدادات الخاصية

![](https://lh3.googleusercontent.com/ktAxc04sJjD2SDzn5BpOefD55vlF1FNjm89_pnVowPzDriQnDsSM5vHEk3Yo7yEvMCeuiSdLuqLKuJIbvKqIHWjCqDcDuYCbZ-ClPCRewJW4CV5-SX8WRMaTYHaqGaGgqtGB1NoSVyFiIh34lw)

انسخ معرّف التتبع، ثم افتح إعدادات المشروع على Salebot واحفظ المعرّف في ثوابت المشروع تحت اسم **google\_tracking\_id**:

![](https://lh3.googleusercontent.com/Ybz6q-G3jFKq4gbFnBVuHkXJwhgzFUR3lObBP8k0ieZ0dQbowAmmj2Z2PgZttJlx8QF1byct4zrin8kO1U7gh1uk4V2hiAAfAcBSgn3M3e9rosj2uVTBQzfb9eJ_jQ5_ACgPbd8KnbKOG7o11g)

## كيفية مشاركة معرّف عميل Google (\_ga) من صفحة الهبوط المصغّرة مع المتغيرات

لمشاركة معرّف العميل، تحتاج إلى تحديد خيار Google Client ID(\_ga) في إعدادات صفحة الهبوط المصغّرة. بعد إطلاق البوت سيظهر المتغير **\_ga** .

![](https://lh5.googleusercontent.com/IZ9wQ5-EAigL_jwMn3FPQ48_ad2teURPG9Kjylr8pLkYmafreiKc4iY6KlmjdeZ9xztiNteyogcN-w8PmtJxYKfT1lA_ytUJXkhv_I7va3NHNEgSJrbRvPdWI4VcmvUqrTbKdVZiQXZLFsMYfw)

## كيفية نقل بيانات GA من Salebot

أثناء استدعاء الدالة لنقل البيانات إلى Google Analytics، يتم مشاركة بعض المعلمات **يتم**، وتُعرض المعلومات أدناه لإعطاء فكرة عامة عن كيفية عمل الدالة.

بالنسبة للدوال **ga\_pageview** و **ga\_transaction\_pageview** يتم نقل المعلمة “t”: “pageview”

بالنسبة للدوال **ga\_event** و **ga\_transaction\_event** يتم نقل المعلمة “t”: “event”

بالنسبة للدوال **ga\_transaction\_pageview** و **ga\_transaction\_event** ويتم أيضًا نقل المعلمة “pa” بالقيمة “purchase” بشكل إضافي.

كما أنه عند استدعاء جميع الدوال، يتم نقل المعلمة **cid** تلقائيًا - وهي معرّف العميل للتحليلات. إذا دخل المستخدم إلى البوت من صفحة الهبوط المصغّرة، كما هو موضح أعلاه، فسيتم حفظ المعرّف تلقائيًا في متغيرات المشروع، ضمن المتغير **\_ga**

![](https://lh5.googleusercontent.com/ckT9oGxRsFH-BmaOGxlYiZ0iKKUnlxMx_qglqF2F-x0U2x1xJZXVKiothDGanpu9bB3BQOgm_Ubc0VMoM2fw-A30SK_eKebRaCZ7AkLm7pQKMYKBWTm7xW7IbM3sO4jtatcvG1cSY4UH2k6GPw)

إذا لم تحتوِ بطاقة العميل على هذا المتغير، فسيتم إنشاؤه تلقائيًا كسلسلة عشوائية من الأرقام، ولكن في هذه الحالة يُنصح بنقل مصدر الزيارات في الإعدادات المتقدمة (موضح أدناه - كيفية إعادة تعريف المصدر)

## كيفية إعادة تعريف المصدر

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

`'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'`

الوثائق الخاصة بالمعلمات:

{% embed url="<https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#trafficsources>" %}

## كيفية استخدام طلبات من نوع الأحداث (t:events)

تُستخدم في Google Analytics لأحداث معينة. يمكنك إعداد الأهداف في GA، وهي تُفعَّل عند حدوث أحداث معينة (أي ليس من الضروري أن تكون كل الأحداث المشتركة هدفًا).

يمكنك العثور على الأحداث في قسم السلوك -> الأحداث -> أهم الأحداث

![](https://lh4.googleusercontent.com/Fqs4mjmTrDlvO-mNQlH9xRC3qjYM42DnnyRjRkMxPDTISx9_fYimuq-XdJqSLqaoLfuFfK7k1ItNwVG5xxIlljh_iufFPb3wiE0r2m57OI36Jx6ECwj-kWFzqy9MVEQa_5Up_YnSerTkeJbUAQ)

## كيفية إعداد أهداف الأحداث

يمكنك إعداد أهداف لخطوات سير العمل المهمة واستخدامها لتتبع التحويلات بين الخطوات. يتم إعداد الأهداف في قسم التحويلات -> الأهداف

![](https://lh5.googleusercontent.com/jgwnuIXv9cuUnYXOtztAPuS9wm3_hrN-todKsF3-yevJKEv2256sO_gfwVeSTakXm863eh86dF0DtN3-HSq_qkB33BcMbd-JJVUXP8kSV7oOgMRyR9vFpRppac75r9EdTe3qE5aXgqDOjLxrwA)

![](https://lh6.googleusercontent.com/bWiI3wGWMm2fa5SBnSNJnwKIB-tOqLMLHNYk8kLDny5Rmm2BRCoCVXl0P2JDlCtnTyq3pZr5Fq5ryfdOKBacbqLPnQn-hlkq9MhKi65MR3_CMnyza2wHK1fGA_1g8jWZ7TSQDZ0Y2Q_hv3sETA)

## كيفية نقل الأحداث

لنقل حدث في GA، تحتاج عند الانتقال إلى مرحلة مختلفة إلى استدعاء الدالة **ga\_event()** مع المعلمات المطلوبة في حقل الآلة الحاسبة.

**ga\_event (‘category’, ‘event action’**, ‘label’, ‘event value’, ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’)

#### توضيح للمعلمات الواردة في المثال أعلاه:

**category** - فئة الحدث (معلمة إلزامية) \
**event action** - معلمة إلزامية \
**label** - تسمية الحدث يتم نقل قيمة الحدث كأعداد صحيحة وتُكتب بالعملة المضبوطة في إعدادات الاكتساب \
**القاموس مع المعلمات الإضافية**؛ مثال: '{"ti":"#{order\_id}", "tr":"25", "tcc":"#{promocode}"}'

#### مثال على استدعاء الدالة:

ga\_event('sale', 'list viewing’) \
ga\_event('Salebot', 'Enter bot', '#{tag}', '100', '{"ti":"#{order\_id}", "tr":"#{price}", "tcc":"#{promocode}"}') \
ga\_event('Salebot', 'Enter bot', '#{tag}', '100') \
ga\_event('Salebot', 'Enter bot', "", '20')

## كيفية استخدام طلبات من نوع مشاهدة الصفحة (t:pageview)

من خلال نقل بيانات مشاهدة الصفحة، فإنك تحاكي زيارة من مستخدم صفحة الويب. لعرض تقرير قياسي عن الصفحات، انتقل إلى السلوك -> محتوى الموقع

![](https://lh5.googleusercontent.com/HEHn4m4mwUEgViVeUJ-eTRMu60FL2uvcAfqEoGSIjZmCsAyaQxr_L-9TlfyhfW9UaAh6TEFuhEUPQ_iPIC1DJ2E1sSkZv9vbVDJ_zxxckYZuvy3nDoJDScWxOwnBSPZCEbEVjrbd8tFajKW-eA)

إذا قمت بإعداد هدف لزيارة الصفحات، يمكنك الحصول على سير عمل افتراضي لتتبع فرع البوت دون مغادرة Google Analytics.

![](https://lh5.googleusercontent.com/CxeTY_FRy3uY4SxmZhteQG6yqbDgD9mswRXmDqMA5lUwwET_flZvSXLxdgBflNCc7Jlq8hhmqjMge5grqDw4g16iHfyRHjbRBLHwLZck45CHxU6KMDZ97q2ZJJyKNHlxDVh7SLF7YIkDl0-fhw)

مثال على الإعداد:

![](https://lh4.googleusercontent.com/L81lDP7gdVcb9hEqdCoGcm4DJ7PAmrY2LQK1VguoI7rwdLBQYWD3VXXbVe1Namb-t-TSZPI_z0QSknXsuFfu-_K34ojnj7tQgmeBluWclBPE0S1z-2pN9mRXrbBX4VYRWbZsRNP9zRL6snBA-A)

الـ **الميزة** في هذه الطريقة هي التمثيل البصري لحركة سير العمل دون الحاجة إلى مغادرة Analytics.

الـ **العيب**، مع ذلك، هو أنك في الأساس تنقل معلمة واحدة فقط - وهي زيارة كتلة. لا يمكن نقل بيانات إضافية مثل Label أو Value، كما في طلبات Event، بهذه الطريقة.

لنقل بيانات مشاهدة الصفحة في GA عند الانتقال إلى كتلة، من الضروري استدعاء الدالة **ga\_pageview(**) مع المعلمات المطلوبة في حقل الآلة الحاسبة.

**ga\_pageview(‘URL page path’, ‘title’**, ‘{“parameter name”: “value”, “parameter name 2”: “value 3”}’)

#### توضيح للمعلمات الواردة في المثال أعلاه:

**URL page path** - الجزء من عنوان URL الذي يحتوي على المسار \
**title** - عنوان الصفحة/المستند \
**قاموس مع معلمات إضافية** بهذا الهيكل: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

#### مثال على استدعاء الدالة:

ga\_pageview('/start, 'Entry point') \
ga\_pageview('/pay', ‘Sale’, '{"cd1": "High Scores"}')

لنقل المعلمات الإضافية، راجع الوثائق المرتبطة أدناه. هناك يمكنك العثور على جميع المعلمات الممكنة مع أوصاف مفصلة:

{% embed url="<https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#content>" %}

## كيفية استخدام التجارة الإلكترونية

إعداد التجارة الإلكترونية في تبويب All Web Site Data

![](https://lh3.googleusercontent.com/0Fx6Qq2BMLYClrpGe03igYTkpJnx9bLjwVSX0oeDRgQAasheRsYrpo31oXa5HaMTscnpxloIJZvrtA_ajMVMigNAor9ukwVVguvxGd_A6iNO8uhTViBenW2xbZfRLFZVYl2x2YY4l1eC-LbcSQ)

{% hint style="warning" %}
يجب إرسال معلمات التجارة الإلكترونية كطلبات موجودة (pageview, event)
{% endhint %}

هناك دالتان لهذا الغرض: **ga\_transaction\_pageview** و **ga\_transaction\_event**. المزيد عنهما أدناه.

### الدالة ga\_transaction\_pageview

المعلمات الإلزامية مكتوبة بخط عريض:

**ga\_transaction\_pageview('transaction id', 'total income’, 'URL page path', ‘title’**, 'list of products’, 'dictionary of additional parameters’)

#### توضيح للمعلمات الواردة في المثال أعلاه:

**transaction id** - المعرّف الفريد للمعاملة \
**total income** - إجمالي الدخل المرتبط بالمعاملة \
**URL page path** - الجزء من عنوان URL الذي يحتوي على المسار \
**title** - عنوان الصفحة/المستند \
**list of products** - مصفوفة المنتجات بهذا الهيكل: '\[\["id", "name", "price", "amount"], \["id", "name", "price", "amount"]]' \
**قاموس مع معلمات إضافية** بهذا الهيكل: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

#### مثال على استدعاء الدالة:

ga\_transaction\_pageview('#{order\_id}', '2200', '/send', ‘Received’, '\[\["222", "Rate1", "1200", "1"], \["223", "AdditionalRate", "1000", "1"]]')\
\
ga\_transaction\_pageview('123', '100', '/pay', 'Payed', '', '{"cd": "High Scores", "cs":"#{utm\_source}", "cm":"#{utm\_medium}", "cn":"#{utm\_campaign}"}' )

تكون مصفوفة المنتجات كما يلي: **مصفوفة من مصفوفات**:

'\[\["product\_id", "product name", "product price", "amount of products"], \["product\_id", "product name", "product price", "amount of products"]]'

يجب أن يحتوي كل منتج على 4 معلمات، وتكون المصفوفة بالكامل بين علامات اقتباس مفردة (‘)، والمعلمات داخلها بين علامات اقتباس مزدوجة (“)

### الدالة ga\_transaction\_event

المعلمات الإلزامية مكتوبة بخط عريض:

**ga\_transaction\_event('transaction id', 'transaction income’, 'event category', ‘event action’, ‘event tag'**, 'event importance', 'list of products’, 'additional parameters’)

#### توضيح للمعلمات الواردة في المثال أعلاه:

**transaction id** - المعرّف الفريد للمعاملة \
**total income** - إجمالي الدخل المرتبط بالمعاملة \
**event category, event action, event tag** - معلمات إلزامية\
**event importance** - تُنقل كأعداد صحيحة وتُكتب بالعملة نفسها المضبوطة في إعدادات العرض\
**list of products** - مصفوفة المنتجات بهذا الهيكل: '\[\["id", "name", "price", "amount"], \["id", "name", "price", "amount"]]' \
**قاموس مع معلمات إضافية** بهذا الهيكل: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

#### مثال على استدعاء الدالة:

ga\_transaction\_event('1244', '121.2', 'category1',  'action', 'tag', '10', '\[\["11", "Product1", "1.2", "1"], \["22", "Product2", "120", "1"]]')

ga\_transaction\_event('1244', '1.2', 'category1',  'action', '', '', '\[\["11", "Product1", "1.20", "1"]]')

ga\_transaction\_event('1244', '121.2', 'category1',  'action', 'tag', '10', '\[\["11", "Product1", "1.2", "1"], \["22", "Product2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm\_source}", "cm":"#{utm\_medium}", "cn":"#{utm\_campaign}"}' )

تكون مصفوفة المنتجات كما يلي: **مصفوفة من مصفوفات**:

'\[\["product\_id", "product name", "product price", "amount of products"], \["product\_id", "product name", "product price", "amount of products"]]'

يجب أن يحتوي كل منتج على 4 معلمات، وتكون المصفوفة بالكامل بين علامات اقتباس مفردة (‘)، والمعلمات داخلها بين علامات اقتباس مزدوجة (“)

###

## درس فيديو


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/integrations/other/analytics/google.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.