# كيفية تمرير المعلمات ووسوم UTM

{% hint style="info" %}
تقوم منصات مثل Instagram وFacebook وWhatsApp وTelegram بتطبيق هذه الآلية من خلال `visit_key` المعلمة.
{% endhint %}

**دعم الروابط العميقة**\
تدعم معظم تطبيقات المراسلة (مثل Instagram وFacebook وTelegram) الروابط العميقة. ومع ذلك، لا تدعمها تطبيقات أخرى.

**حل بديل لـWhatsApp**\
على الرغم من أن WhatsApp لا يدعم الروابط العميقة بشكلٍ أصلي، يمكنك مع ذلك تمرير المعلمات وعلامات UTM. وللقيام بذلك، أدرِج متغيرًا خاصًا في نص الرسالة المعبأ مسبقًا الذي يظهر للمستخدم بعد النقر على الرابط. (سيتم تناول هذه الطريقة بالتفصيل لاحقًا.)

**تخزين المعلمات**\
يتم حفظ جميع المعلمات الممررة كمتغيرات عميل داخل النظام.

**بنية المعلمات وأنواعها**\
المعلمة هي **زوج اسم-قيمة**. وبحسب مصدرها، يمكن أن تكون المعلمات:

* **ثابتة:** أنت تحدد القيمة الدقيقة التي سيتم إرسالها.
  * **مثال:** `utm_term=webinar1` (حيث `utm_term` هو الاسم و `webinar1` هي القيمة الثابتة).
* **ديناميكية:** تقوم منصة الإعلانات (مثل Google Ads وFacebook Ads) بإدراج البيانات ذات الصلة تلقائيًا عند لحظة النقر.
  * **مثال:** `term={keyword}` — هنا، يتم استبدال العنصر النائب `{keyword}` ديناميكيًا بعبارة البحث الفعلية التي أدت إلى ظهور الإعلان.

#### كيفية استخدام هذه المعلمات على موقع

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

**للحصول على رابط موقعك**، انتقل إلى **"Sites"** .

<div data-with-frame="true"><figure><img src="/files/df9c7678d89f828c4acd772012573f83071334b2" alt="" width="563"><figcaption></figcaption></figure></div>

مثال على إضافة علامات UTM إلى رابط موقع:

`https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration`

سيتم تمرير المعلمات والوسوم إلى الروبوت وحفظها كمتغيرات عميل.

<div data-with-frame="true"><figure><img src="/files/15645b9161768c5077dfcf061cb33510463c330c" alt=""><figcaption></figcaption></figure></div>

#### كيفية استخدام هذه المعلمات بدون موقع

يمكنك استخدام **روابط وكيلة** لتمرير المعلمات مباشرةً. بمجرد تشغيل الروبوت عبر مثل هذا الرابط، سيتم حفظ جميع البيانات المنقولة كمتغيرات صفقة.

**يجب أن يكون تنسيق الرابط مع المعلمات كما يلي:**

**بنية رابط الوكيل**

يتكون رابط الوكيل المزوّد بمعلمات من جزأين:

1. **عنوان URL الأساسي** (رابط الوكيل نفسه): `https://mavibot.ai/r/mavibot_1`
2. **سلسلة الاستعلام** (معلماتك): `?param1=value1&param2=value2`

**مثال: إضافة علامات UTM إلى رابط Telegram**

إليك مثال على رابط مباشر من موقع إلى Telegram مع معلمات UTM:

<https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor>

<div data-with-frame="true"><figure><img src="/files/e117c5b89962735db92296792302e9c28b417033" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/93327ea9dc3dc2a437f1df5acbbdc75cb6aaadf2" alt=""><figcaption></figcaption></figure></div>

**روابط المراسلة المباشرة في "Sites"**

يعرض هذا القسم روابط قابلة للنقر لجميع تطبيقات المراسلة المدمجة مع نظامك.

## ميزات WhatsApp

نظرًا لأن WhatsApp لا يدعم الروابط العميقة، يجب أن تضيف متغيرًا خاصًا إلى رسالة فتح الروبوت. سيستخدم الروبوت هذا المتغير لتحديد المعلمات التي تم تشغيل WhatsApp بها.

**المتغير: `#{visit_key}`**

عندما ينقر المستخدم على رابط WhatsApp الخاص بك، سيتم استبدال هذا العنصر النائب تلقائيًا برمز رقمي فريد يحتوي على المعلمات الممررة.

<div data-with-frame="true"><figure><img src="/files/5dab38a0c444fc9bd11541859fe5f186ba4c00d1" alt=""><figcaption></figcaption></figure></div>

"Sites" → Site → Site page settings → Messengers → WhatsApp settings

عندما ينتقل المستخدم إلى WhatsApp من موقعك (أو عبر رابط مراسلة من إعدادات الموقع)، يتم `#{visit_key}` استبدال العنصر النائب برمز رقمي فريد.

<div data-with-frame="true"><figure><img src="/files/0582f3aeb8eadad2a5e124c45f04849a610db422" alt="" width="375"><figcaption></figcaption></figure></div>

## الاشتراك في Instagram

**تطور تتبع المعلمات**

* **الطريقة السابقة (`#{visit_key}`):**
* الـ `#{visit_key}` كان المتغير يُستخدم بوضعه في **"Initial WhatsApp message"**. وقد أتاح لك ذلك تتبع معلمات التشغيل لتفاعلات Instagram.
* **الطريقة الحالية (الروابط العميقة مع معلمات الإحالة):**

يمكنك الآن تمرير معلمات الإحالة مباشرةً عبر الروابط العميقة في Instagram، مما يوفر مرونة وتحكمًا أكبر.

**فوائد استخدام معلمات الإحالة:**

باستخدام معلمات الإحالة، يمكنك:

* **تتبع الحملات** من خلال ربط النقرات بمصادر أو قنوات محددة.
* **إسناد المستخدمين** من خلال ربط زائر Instagram بجلسة أو حساب في تطبيقك الخارجي.
* **تخصيص المسارات** من خلال توجيه المستخدمين إلى محتوى مستهدف أو ميزات محددة داخل حساب Instagram الخاص بك.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>الرابط العميق لـInstagram</p></figcaption></figure>

يتم إرسال المعلمة REF\_PARAM إلى الخادم عبر webhook.

مثال: <https://ig.me/m/mavibotai?ref=mavi>

يمكنك نسخ الرابط إلى روبوت Instagram الخاص بك في قسم "Channels".

يبدو الرابط كالتالي: <https://ig.me/m/\\>\<account\_login\_instagram> \*

<div data-with-frame="true"><figure><img src="/files/fba10b0fa071d7c6f7b3629c7688264eeb7bff1e" alt=""><figcaption></figcaption></figure></div>

يبدو الرابط كالتالي: <https://ig.me/m/\\>\<account\_login\_instagram>\*

أضف المعلمة إلى الرابط المنسوخ:?ref=\<your parameter>&#x20;

بعد ذلك، يمكنك استخدام الرابط مع معلمة ref لإدخال المستخدمين إلى botanic في Instagram.

سيتم تمرير المعلمة فقط عند أول تواصل للمستخدم مع حسابك (الروبوت) للمرة الأولى.

## علامات UTM في قسم Analytics

يمكنك عرض إحصاءات علامات UTM في قسم "Analytics"

انتقل إلى قسم "Analytics" وحدد تبويب "Clients".

<div data-with-frame="true"><figure><img src="/files/b3df16a0e871e8993db00ccf588e5de469a88f7a" alt="" width="563"><figcaption></figcaption></figure></div>

انقر على زر "Add widget".

<div data-with-frame="true"><figure><img src="/files/e2217470bb3a7225640653dae755f49a38423b66" alt="" width="563"><figcaption></figcaption></figure></div>

الـ **منشئ الودجات** سيفتح النافذة.

1. حدد **علامات UTM** .
2. انقر على **"Add a value"** الزر.

<div data-with-frame="true"><figure><img src="/files/0a4174fb50c05560406be8e7b2c47a627d97aa8a" alt="" width="375"><figcaption></figcaption></figure></div>

ستظهر إعدادات إضافية لقيم علامات UTM. انقر على الحقل **"Select a tag"**.

<div data-with-frame="true"><figure><img src="/files/a7cba2299a632f4f65c5a22368f11619efe4ba34" alt="" width="563"><figcaption></figcaption></figure></div>

واختر الوسم الذي تريد عرض الإحصاءات له.

<div data-with-frame="true"><figure><img src="/files/5be65ef34a32eb5dddf53c9aa70e6cabd19d15b4" alt="" width="325"><figcaption></figcaption></figure></div>

إذا كنت تريد إضافة عدة وسوم أو كلها، فانقر على "Add a value" مرة أخرى.

<div data-with-frame="true"><figure><img src="/files/ae86549894d3791b8735641a3da495326be68bc7" alt="" width="563"><figcaption></figcaption></figure></div>

لا تنسَ تحديد الفترة والإعدادات الأخرى، وتأكد من حفظها.

ثم أضف العدد المطلوب من الوسوم، وبعد ذلك انقر على زر "Save".&#x20;

<div data-with-frame="true"><figure><img src="/files/8efe7d7d9ff5012b1022757598077d343963b1f5" alt="" width="375"><figcaption></figcaption></figure></div>

بعد ذلك تحتاج إلى النقر على زر "Add a widget".

<div data-with-frame="true"><figure><img src="/files/a3d48f983acc589fd94c1bf678b3f0cb9d385907" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
اقرأ المزيد عن كيفية العمل مع التحليلات في المقال " [تحليلات MaviBot](/doc/ar/thlylat-mavibot.md)"
{% endhint %}


---

# 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/websites/almwaqa/tags.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.