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

# تحويلات ميتا ونماذج العملاء

> اربط تطبيق Meta Conversions API، استقبل نماذج فيسبوك وإنستغرام داخل النوافذ، وأرسل التحويلات اللاحقة من مسار.

أول رسالة من إعلان واتساب أو ماسنجر أو إنستغرام ترسل **Lead submitted** إلى ميتا من نفسها. ميتا تحسب تكرار نفس معرّف الحدث عميلاً واحداً لنحو 48 ساعة. نموذج فيسبوك، والعميل المؤهل، والبيع، تصل إلى ميتا فقط عندما يقول مسار منشور ذلك.

**Meta Conversions API** يحفظ نموذج العميل داخل كرزون، ويرسل تحويلاً لاحقاً أو يضيف الشخص إلى جمهور ميتا.

يشرح هذا الدليل الربط، أين تظهر النماذج، وأي إجراء يرسل كل نوع من التحويل.

أسماء المشغّل والإجراءات في منشئ المسار تظهر بالإنجليزية كما هي أدناه.

## قبل أن تبدأ

* تطبيق **Meta Conversions API** مثبّت من [المتجر](https://docs.karzoun.chat/ar/help-center/guides/store/overview.md) ثم مربوط من **الإعدادات ← التطبيقات** حتى تظهر شارة **متصل**. المسار العام في [تثبيت تطبيق وربطه](https://docs.karzoun.chat/ar/help-center/guides/automations/apps/install-connect.md).
* رمز مجموعة البيانات (Dataset) من أحداث ميتا، منفصل عن رمز الصفحة.
* لإعلانات واتساب: قناة [واتساب](https://docs.karzoun.chat/ar/help-center/guides/channels/whatsapp.md) مربوطة.
* لنماذج العملاء: صفحة فيسبوك مربوطة من القنوات. النموذج الذي يُعبَّأ من حساب إنستغرام المرتبط بتلك الصفحة يصل معها. لا حاجة لرمز صفحة داخل تطبيق التحويلات.
* للجمهور: رمز إعلانات يستطيع تعديل قوائم العملاء، ومعرّف الجمهور من مدير إعلانات ميتا.

| الحقل عند الربط | لماذا |
| - | - |
| `pixelId` | معرّف مجموعة البيانات التي تستقبل تحويل العميل |
| `accessToken` | رمز تلك المجموعة. ليس رمز الصفحة |
| `adsAccessToken` | رمز يستطيع إضافة شخص إلى جمهور أو إزالته |
| `currency` | العملة الافتراضية، مثل `SAR` |
| `testEventCode` | رمز اختبار ميتا. اتركه فارغاً بعد انتهاء التجربة |

## ماذا يصل، وأين تفتحه؟

نموذج فيسبوك أو إنستغرام لا يُنشأ من **إنشاء نافذة**. عند ربط صفحة فيسبوك يسحب كرزون نماذج العملاء التي ما زالت لدى ميتا (حتى 90 يوماً)، ثم يستقبل الجديد على نفس عنوان صفحة فيسبوك. تظهر النماذج في **النوافذ المنبثقة ← نماذج فيسبوك**.

اسم النموذج يفتح [صفحة الإدخالات](https://docs.karzoun.chat/ar/help-center/guides/popups/submissions.md) نفسها. كل عميل صف واحد. كل سؤال عمود واحد بترتيب النموذج، ثم الحملة والإعلان ورابط يفتح الإعلان ومصدر مدفوع أو عضوي.

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

من صف النموذج يمكنك فتح الإدخالات أو أرشفة الصف. **تعديل** و**تثبيت الكود** و**تكرار** و**حذف** غير متاحة لهذا النوع.

> [!NOTE]
>
> وصول النموذج لا يرسل حدث Lead إلى ميتا. الإرسال يتم لاحقاً من إجراء تحويل داخل مسار.

## ماذا تبني في المسار؟

| في المنتقي | متى يُطلق أو ماذا يفعل |
| - | - |
| **Customer → Pipeline stage changed** | عندما تنتقل جهة الاتصال إلى مرحلة أخرى في [خط العميل المحتمل](https://docs.karzoun.chat/ar/help-center/guides/settings/lead-stages.md) |
| **Facebook Events → Lead form received** | عند حفظ نموذج فيسبوك أو إنستغرام، مع العميل والنموذج ومعرّف العميل لدى ميتا والحملة والإعلان. يظهر مع قناة فيسبوك، حتى لو لم يُربط تطبيق التحويلات |
| **Send WhatsApp conversion** | نقرة إعلان واتساب خلال آخر 7 أيام. يستخدم حساب واتساب المربوط |
| **Send Messenger conversion** | نقرة إعلان ماسنجر خلال آخر 7 أيام. يستخدم صفحة فيسبوك المربوطة |
| **Send Instagram conversion** | نقرة إعلان إنستغرام خلال آخر 7 أيام. يستخدم حساب إنستغرام المربوط |
| **Send customer conversion** | بلا نقرة إعلان. يطابق العميل بالهاتف أو البريد، ويرسل **Lead ID** الذي تكتبه. يستخدم مجموعة البيانات في هذا التطبيق |
| **Add to audience** | يضيف هاتف العميل وبريده المشفّرين إلى جمهور تحدده بـ **Audience ID** |
| **Remove from audience** | يزيل الشخص من ذلك الجمهور بنفس الهاتف والبريد |

### تحويلات النقرة

**Lead submitted** يُرسل عند وصول أول رسالة من الإعلان، وهو غير موجود في قائمة أحداث إجراء النقرة. استخدم **Send WhatsApp conversion** أو **Send Messenger conversion** أو **Send Instagram conversion** لـ **Qualified lead** و**Purchase** وبقية الأحداث. كل إجراء يرسل فقط عندما تكون لقناته نقرة إعلان خلال آخر 7 أيام. وإلا يتجاوز الإجراء. التكرار يستخدم نفس معرّف الحدث، وميتا تحسبه حدثاً واحداً لنحو 48 ساعة. **Order ID** جديد يعني شراءً جديداً. **Purchase** يحتاج **Value** و**Currency**. لا يُرسل الهاتف أو البريد مع النقرة.

أعد ربط واتساب بعد هذا التغيير حتى يحمل رمز الحساب صلاحية إرسال الأحداث. أعد ربط صفحة فيسبوك حتى يحمل رمزها `page_events`.

### Send customer conversion

هذا الإجراء على تطبيق التحويلات. اختر **Event**. **Purchase** يحتاج **Value** و**Currency**. المطابقة بالهاتف أو البريد.

**Lead ID** اختياري. عندما يبدأ المسار من **Lead form received**، مرّر معرّف النموذج من ذلك المشغّل إلى هذا الحقل. اتركه فارغاً إن لم يكن للتحويل نموذج ميتا.

**Click ID** اختياري. مرّر نقرة إعلان الموقع، `fbclid`، عندما يأتي الطلب من الموقع. مرّر أيضاً **Page URL** و**Browser** من تلك الزيارة. اترك **Click ID** فارغاً إن لم تكن هناك نقرة موقع.

بلا هاتف وبلا بريد يتجاوز الإجراء. **Test event code** على الإجراء يحل محل الرمز المحفوظ عند الربط.

### الجمهور

**Add to audience** و**Remove from audience** يحتاجان `adsAccessToken` ومعرّف الجمهور. بلا هاتف وبلا بريد لا يوجد ما يُطابق، فيتجاوز الإجراء بهدوء.

إنشاء الجمهور من شاشة الربط غير متاح. أنشئ القائمة في مدير إعلانات ميتا والصق معرّفها في الإجراء.

> [!WARNING]
>
> لا تضع إجراء تحويل على مشغّل **Lead form received** إن كان هدفك انتظار تأهيل أو بيع. النموذج المحفوظ يكفي. أرسل التحويل عندما تتغير [المرحلة](https://docs.karzoun.chat/ar/help-center/guides/contacts/leads.md) أو عندما تغادر الشريحة أو تنضم، حسب قاعدتك.

## أخطاء شائعة

| ماذا ترى؟ | ماذا تتحقق؟ |
| - | - |
| لا إجراءات في المسار | إجراءات النقرة تأتي من القناة المربوطة. **Send customer conversion** وإجراءات الجمهور تحتاج هذا التطبيق **متصلاً** |
| لا صف تحت **نماذج فيسبوك** | صفحة فيسبوك مربوطة، ووصلت تجربة حقيقية أو اكتمل سحب الـ 90 يوماً. أعد ربط الصفحة إن رُبطت قبل تفعيل نماذج العملاء |
| عميل المحادثة من الإعلان لم يظهر في ميتا | القناة مربوطة، ورمزها يستطيع إرسال الأحداث. واتساب يحتاج `whatsapp_business_manage_events`. صفحة فيسبوك تحتاج `page_events`. أعد الربط بعد إضافة هذه الصلاحيات |
| التحويل لم يظهر في ميتا | المسار **منشور**. إجراء النقرة يحتاج نقرة إعلان من تلك القناة خلال 7 أيام. تحويل العميل يحتاج هاتفاً أو بريداً |
| نفس الشراء حُسب مرتين | استخدم **Order ID** جديداً لشراء جديد. نفس معرّف الحدث حدث واحد عند ميتا لنحو 48 ساعة |
| الجمهور لم يتحدث | `adsAccessToken` يستطيع تعديل الجمهور، و**Audience ID** صحيح، والعميل فيه هاتف أو بريد |

## الخطوة التالية

تعلّمت أين تصل النماذج ومتى يخبر المسار ميتا. بعد ذلك:

* صمّم أول رسالة بعد نقرة واتساب من [إعلانات تفتح محادثة](https://docs.karzoun.chat/ar/help-center/guides/whatsapp/ads/overview.md).
* راجع الإدخال على [صفحة الإدخالات](https://docs.karzoun.chat/ar/help-center/guides/popups/submissions.md).

## ذات صلة

* [إعلانات تفتح محادثة](https://docs.karzoun.chat/ar/help-center/guides/whatsapp/ads/overview.md)
* [الردود](https://docs.karzoun.chat/ar/help-center/guides/popups/submissions.md)
* [مراحل العميل المحتمل](https://docs.karzoun.chat/ar/help-center/guides/settings/lead-stages.md)
* [تثبيت تطبيق وربطه](https://docs.karzoun.chat/ar/help-center/guides/automations/apps/install-connect.md)
* [أنواع المشغّلات](https://docs.karzoun.chat/ar/help-center/guides/automations/triggers/types.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.