# Facebook Pixel

* [كيفية استخدام Facebook Pixel في الصفحات المصغّرة ](#how-to-use-facebook-pixel-in-mini-landings)
* [كيفية إرسال الأحداث إلى Pixel من البوت](#how-to-send-events-to-pixel-from-the-bot) 
* [كيفية إضافة حساب ترويجي](#how-to-add-a-promotional-account)

## كيفية استخدام Facebook Pixel في الصفحات المصغّرة

{% embed url="<https://docs.salebot.ai/mini-landing#how-to-use-social-networking-pixels>" %}

## كيفية إرسال الأحداث إلى Pixel من البوت

لنقل الأحداث من سير عمل البوت، يجب أن يكون لديك حساب أعمال. يمكنك التسجيل [هنا](https://business.facebook.com)

### كيفية إنشاء بكسل جديد

![](/files/28d13e2c57b00a68f197b1f5e49e66879e25c55b)

اختر API Conversions

![](/files/ab2d4978ca233d7608cc4e2f540e64098a3d0ca4)

{% hint style="danger" %}
**انتباه!** إذا ظهرت النافذة التالية أثناء إعداد Conversion API، فمن الأفضل ترك الإعدادات والبدء من جديد.
{% endhint %}

![إذا ظهرت النافذة التالية أثناء إعداد Conversion API، فمن الأفضل ترك الإعدادات والبدء من جديد.](/files/26b4d12dcddce4af4a2a44fa2c95aa59eae9c346)

![](/files/d22e6f59233e023e0ef61cabc397ceb2420e084f)

اختر البكسل الذي تحتاجه

![](/files/9f5a9c00686fe572da765231f45af0d9817c555c)

أنشئ رمز وصول واحفظه في مكان آمن.

![](/files/0ec1e042f7335bdd70deae13042edb4439e5651c)

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

لنقل الأحداث إلى Facebook، يجب أن يكون لديك نطاقك الخاص مُعدًا في الصفحة المصغّرة، ويجب أن يكون معتمدًا على Facebook، ويجب تفعيل خيار «حفظ القيم من ملفات تعريف الارتباط إلى متغيرات العميل» على Facebook في إعدادات الصفحة المصغّرة:

![](https://lh4.googleusercontent.com/qu2QVQQLtGctNi1CWSeDJS7XmZCsYmbe7oEVukfSbjhFNCaY-XoymKBy1K3Gc8xk44mShIMGLjzhjS-4o07Pq_EpoWVhwOAxD9BTN8z1IyKXUfnfxyio-NEHcK1XkTOe1CcOzJwkPxgk7yeHSg)

الآن، سيكون هناك متغير مُعبّأ تلقائيًا **\_fbp** في بطاقة العميل الذي جاء من الصفحة المصغّرة. يمكن نقل هذا المتغير إلى Pixel مع الحدث

![](https://lh3.googleusercontent.com/RtPgefjbjtWeLOq5Dx9BECYp49TBwg0YjXpxzIqa93NOzoxWQY46PyIy1YFhCUJQbbhhwD9_5otW9nbm_5rBRVdxj8HfnIxb3VHDpkA9TwMo2p8D8JgV-MnT_4ZeptPxcyVJ0JHILNBNpulkcA)

تحتاج إلى ضبط الإعدادات التالية في الكتلة التي تحتاج من خلالها إلى نقل الحدث:

**رابط الدالة**: <https://store.salebot.ai/function/fb\\_pixel>

مثال على المعلمات: \
{ \
"pixel\_id": "#{pixel\_id}", \
"access\_token": "#{access\_token}", \
"event\_name": "Entered the bot", \
"event\_source\_url": "<https://my\\_best\\_site.com>", \
"action\_source": "chat", \
"fbp": "#{\_fbp}", \
"fbc": "#{\_fbc}" \
}

#### المعلمات الإلزامية:

**pixel\_id** - معرّف البكسل \
**access\_token** - رمز الوصول إلى API \
**event\_name** - اسم الحدث. يمكنك استخدام الأسماء القياسية (مثل Lead وPageView وPurchase وما إلى ذلك؛ انظر المزيد [**هنا**](https://developers.facebook.com/docs/facebook-pixel/implementation/conversion-tracking/#standard-events))، وكذلك أسماءك الخاصة (مثل: دخل إلى البوت) \
**event\_source\_url** - النطاق المعتمد على Facebook \
**fbp** - معرّف متصفح العميل

![](https://lh6.googleusercontent.com/hinCfhykXn0MlIWNs-To3nCggwTierkrQrY_IK5eefY3J-3-Yi5f16yeTfKaqO57fC_MhXmw_VKhiXRQV06ofie0gvZvTk4hntGdB9XZb-D4hx53OBlTWMQyuPFdJcEyc5btcqWP6hCsiekvBA)

#### المعلمات الاختيارية:

**action\_course** - (غير ذلك افتراضيًا) يتيح لك هذا الحقل تحديد المكان الذي حدثت فيه التحويلات بالضبط. تساعد المعلومات حول مكان حدوث الأحداث على التأكد من أن إعلاناتك تُعرض للجمهور المناسب. \
يمكنك تعيين القيم التالية في الحقل action\_source:

| القيمة              | الوصف                                                     |
| ------------------- | --------------------------------------------------------- |
| `البريد الإلكتروني` | تمت التحويلات عبر البريد الإلكتروني                       |
| `website`           | تمت التحويلات على موقع إلكتروني                           |
| `phone_call`        | تمت التحويلات عبر الهاتف                                  |
| `chat`              | تمت التحويلات عبر رسول أو رسالة SMS أو دردشة عبر الإنترنت |
| `physical_store`    | تمت التحويلات في المتجر الفعلي                            |
| `system_generated`  | حدث التحويل تلقائيًا، أي نتيجة لتجديد اشتراك شهري         |
| `other`             | حدث التحويل بطريقة أخرى                                   |

### كيفية اختبار الأحداث

للاختبار، تحتاج إلى إضافة المعلمة **test\_event\_code** مع النص المخزن في **رسائل الاختبار** علامة التبويب، إلى نص الطلب.

![](/files/0b14bfe89302f72cccf2723b53cb8f426717cf71)

{ \
"pixel\_id": "#{pixel\_id}", \
"access\_token": "#{access\_token}", \
"event\_name": "Entered the bot", \
"event\_source\_url": "<https://my\\_best\\_site.com>", \
"fbp": "#{\_fbp}", \
"fbс": "#{\_fbс}", \
"test\_event\_code": "TEST11421" \
}

{% hint style="warning" %}
**انتباه!** لا تنسَ حذف هذه المعلمة من الطلب عند إطلاق النسخة التجريبية!
{% endhint %}

#### معلمات اختيارية إضافية:

**fn** - الاسم الأول \
**ln** - اسم العائلة \
**البريد الإلكتروني** - البريد الإلكتروني للعميل \
**phone** - رقم هاتف العميل \
**fbc** - معرّف النقرة \
**gender** - جنس العميل (f - أنثى، m - ذكر) \
**country** - واضح من السياق \
**state** - واضح من السياق \
**city** - واضح من السياق \
**index** - الرمز البريدي للعميل \
**external\_id** - أي معرّف فريد للعميل، أي معرّف المستخدم أو معرّف ملفات تعريف الارتباط التابعة لجهة خارجية \
**client\_ip\_address** - عنوان IP الخاص بالعميل \
**client\_user\_agent** - وكيل المستخدم لمتصفح العميل

يمكنك أيضًا نقل معاملاتك الخاصة إلى Pixel (اختياري)، ولأجل ذلك تحتاج إلى إضافة معلمة إضافية **my\_params** وتحديد حقولك الخاصة فيها.

مثال: \
“my\_params”: {“value1”: “Hello”, “val2”: “Hi”}

#### مثال كامل:

{ \
"pixel\_id": "#{pixel\_id}", \
"access\_token": "#{access\_token}", \
"event\_name": "Entered the bot", \
"event\_source\_url": "<https://my\\_best\\_site.com>", \
"email": "<test@test.com>", \
"phone": "1234567890", \
"currency": "USD", \
"value": "142.52", \
"test\_event\_code": "TEST11421", \
"external\_id": "#{client\_id}", \
"fn": "#{name}", \
"gender": "m", \
"post\_index": "12345", \
"my\_params": {“value1”: “Hello”, “val2”: “Hi”} \
}

{% hint style="warning" %}
**انتباه!** لا تنسَ حذف هذه المعلمة من الطلب عند إطلاق النسخة التجريبية!
{% endhint %}

![](/files/acb5766f0e9005b5a5f357a0021a9eef9358778c)

## كيفية إضافة حساب ترويجي

أولًا، تحتاج إلى فتح الوصول إلى حسابك

![](/files/f31468e5f3590600636a89a126d9d662988f6f7d)

![](/files/03357fec5daa3f2f40882ec66d54cc3a1a2e17f2)

احفظ وانتقل إلى علامة التبويب الكيانات المرتبطة -> إضافة كيانات

![](/files/30919bbe388b75bf064f47d5c5eeee9ba78a1b33)

ثم أضف حسابك الترويجي


---

# 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/pixel.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.