---
title: "Conversions API: ليه بقت ضرورية وإزاي تركّبها"
description: "يعني إيه Conversions API، والفرق بينها وبين البيكسل وهل محتاج الاتنين، وطرق تركيبها على ووردبريس من غير تكرار الأحداث بأمثلة عملية."
url: "https://ahmed-abdelhamed.com/blog/conversions-api-setup/"
date_published: "2026-10-06T05:39:32+00:00"
date_modified: "2026-10-06T20:24:19+00:00"
author: "احمد عبدالحميد"
categories: ["التتبع والتحليلات"]
---

# Conversions API: ليه بقت ضرورية وإزاي تركّبها

**Conversions API** (واختصارها CAPI) هي طريقة بتبعت بيها الأحداث (شراء، عميل محتمل، إضافة للسلة) لميتا **من السيرفر بتاعك مباشرة** بدل ما تعتمد بس على كود جوه متصفح الزائر. السبب إنها بقت ضرورية: البيكسل بيشتغل في المتصفح، والمتصفحات ومانعات الإعلانات وقيود الخصوصية ممكن توقفه أو تقلل اللي بيوصل. فلو اعتمدت على البيكسل لوحده، ميتا بتشوف جزء من مبيعاتك بس، والحملة بتتحسن على بيانات ناقصة. في المقال ده هاشرح يعني إيه CAPI، والفرق بينها وبين البيكسل، وهل محتاج الاتنين، وطرق التركيب على ووردبريس من غير تكرار الأحداث.

## الفرق بين البيكسل و CAPI

- **البيكسل (Meta Pixel):** كود JavaScript في الصفحة، بيرصد اللي بيحصل في متصفح الزائر ويبعته لميتا. سهل التركيب، لكنه بيتأثر بمانعات الإعلانات وإعدادات الخصوصية وإغلاق الصفحة قبل ما الحدث يتبعت.
- **Conversions API:** بتبعت الحدث من **السيرفر** (موقعك) لميتا. مش بتعتمد على المتصفح، فبتغطي الأحداث اللي البيكسل بيفقدها، وبتقدر تبعت كمان أحداث حصلت خارج الموقع (زي حالة ليد في CRM أو مبيعة اتمت بالتليفون).

الخلاصة: **مش بديل، مكمّل**. وده اللي بتوصي بيه ميتا: استخدم الاتنين مع بعض (Redundant Setup) عشان كل واحد يغطي ثغرات التاني.

## ليه Conversions API بقت ضرورية

1. **قيود الخصوصية والمتصفحات:** المتصفحات ونظم التشغيل بتحدّ من تتبع الطرف الثالث والكوكيز، فجزء من أحداث البيكسل مش بيوصل.
2. **مانعات الإعلانات:** نسبة من الزوار بتستخدمها وبتحجب البيكسل.
3. **جودة بيانات التحسين:** ميتا بتعتمد على الأحداث لتتعلم مين بيشتري. أحداث أكتر وأدق = تحسين أفضل. وبحسب توثيق ميتا، الحملة بتحتاج عدد كفاية من أحداث التحسين، وفقدان جزء منها ممكن يبطّئ التعلم. اقرا [مرحلة التعلم](https://ahmed-abdelhamed.com/blog/facebook-ads-learning-phase/).
4. **جودة المطابقة (Event Match Quality):** CAPI بتسمح تبعت معلومات مطابقة إضافية (بشكل مشفّر) بتساعد ميتا تربط الحدث بالشخص.
5. **تتبع ما بعد الموقع:** ليدز ومبيعات بتتم في مكان تاني.

ومهم تعرف إن ده كله مش سحر: CAPI بتحسّن دقة التتبع، لكنها مش بتضمن مبيعات. الأساس لسه عرض قوي وإعلان كويس، شوف [الإعلان آخر خطوة](https://ahmed-abdelhamed.com/book/ad-is-the-last-step/).

### هل محتاج الاتنين؟

لمعظم المتاجر ومواقع الخدمات اللي بتعتمد على الإعلانات: **أيوه، الأفضل الاتنين**. ولو بتتساءل لو لازم تعمل ده من اليوم الأول: ابدأ بالبيكسل السليم الأول، وبعدين ضيف CAPI. وتركيب البيكسل بشكل صحيح على ووكومرس مشروح في [تركيب بيكسل ميتا على ووكومرس](https://ahmed-abdelhamed.com/blog/install-meta-pixel-woocommerce/).

## إزالة التكرار (Deduplication): أهم نقطة

لما بتبعت نفس الحدث من البيكسل ومن CAPI، ميتا لازم تعرف إنهم نفس الحدث عشان ما تعدّهوش مرتين. وده بيتم عن طريق إرسال:

- **معرّف الحدث (event_id)** متطابق في الاتنين.
- **اسم الحدث (event_name)** متطابق.

لو معرّف الحدث ناقص أو مختلف، ميتا ممكن تعدّ الشراء مرتين، فتشوف مبيعات أكتر من الحقيقة، وROAS مضخّم، والتحسين غلط. وده من أكتر الأخطاء شيوعًا. وبتشوف الحالة في مدير الأحداث (Events Manager) ضمن معلومات إزالة التكرار.

## طرق تركيب Conversions API على ووردبريس

### الطريقة 1: الإضافة الرسمية (متاجر ووكومرس)

إضافة Facebook for WooCommerce عادةً بتدعم إرسال الأحداث من السيرفر مع البيكسل وبتتعامل مع إزالة التكرار. خطوات عامة:

1. ثبّت الإضافة واربطها بحسابك في ميتا.
2. اختار البيكسل/Dataset، وفعّل خيار إرسال الأحداث من السيرفر لو متاح.
3. راجع مدير الأحداث وتأكد إن مصدر الأحداث بيظهر **متصفح وسيرفر** معًا.

أسماء الخيارات بتتغير بين نسخ الإضافة، فاتبع الواجهة الحالية.

### الطريقة 2: Gateway الخاص بميتا (Conversions API Gateway)

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

### الطريقة 3: عن طريق Google Tag Manager Server-Side

الأنسب للي عنده GTM ومعرفة تقنية. بتديك تحكم أكبر، لكن بتتطلب سيرفر ملحق وتكلفة وصيانة.

### الطريقة 4: إضافات ووردبريس أخرى

في إضافات تدعم CAPI لمواقع الخدمات (غير ووكومرس) أو لنماذج الليدز. اختار إضافة محدّثة وموثوقة، وراجع تقييمها وتحديثاتها قبل التثبيت.

### الطريقة 5: كود مخصص

بتبعت الطلبات عن طريق API مباشرة. أقوى وأكثر مرونة، لكن مش للكل، وبتحتاج مطوّر. ممكن تكون ضرورية لو عايز تبعت أحداث من CRM.

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

## إزاي تتأكد إن CAPI شغالة

1. **مدير الأحداث ← مصدر البيانات:** شوف إن الأحداث بتيجي من **المتصفح والسيرفر** مع بعض.
2. **اختبار الأحداث (Test Events):** جرّب رحلة شراء، وراقب إن الحدث وصل من الطريقتين.
3. **حالة إزالة التكرار:** تأكد إن مفيش تحذير بتكرار.
4. **جودة مطابقة الأحداث (Event Match Quality):** بتقيس مدى قدرة ميتا على ربط الحدث بشخص. كلما كانت أعلى كان أفضل، وبتتحسّن بإرسال معلومات مطابقة صحيحة (بريد أو هاتف مشفّر) في الحالات اللي بتسمح بيها سياسات الخصوصية والموافقة.
5. **قارن بالأرقام الفعلية:** مبيعات ميتا مقابل طلباتك. وسبب الفروق بيتشرح في [ليه أرقام ميتا مختلفة عن جوجل أناليتكس](https://ahmed-abdelhamed.com/blog/meta-vs-ga4-numbers/).

### الخصوصية والموافقة

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

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

مش كل حدث يتبعت بنفس الطريقة. الأحداث الأساسية لمتجر أو خدمة:

- **Purchase (شراء):** القيمة والعملة ومعرّف الحدث. الأهم.
- **Lead (عميل محتمل):** لنماذج الاتصال، ويفضل معاه معلومات المطابقة.
- **AddToCart وInitiateCheckout وViewContent:** لتحسين الجمهور وإعادة الاستهداف.
- **أحداث مخصصة:** زي «ليد مؤهَّل» أو «معاينة محجوزة» لو بتتابع الجودة من CRM.

ومعلومات المطابقة (زي البريد أو الهاتف) بتتبعت **مشفّرة** حسب متطلبات ميتا، وبشرط الالتزام بالموافقة وسياسة الخصوصية. وما تبعتش بيانات حساسة غير مسموح بها. وراجع توثيق ميتا الحالي لقائمة المعاملات (Parameters) المتاحة.

### الإرسال من CRM: ميزة CAPI الأهم لمجالات الخدمات

لو بتبيع خدمة أو عقار، المبيعة الفعلية بتحصل بعد الليد بأيام في محادثة أو اجتماع. CAPI بتسمح تبعت لميتا إن الليد ده اتحوّل لعميل فعلي، فتبدأ ميتا تدوّر على ناس تشبه اللي بيشتروا مش بس اللي بيسيبوا بياناتهم. وده بيغيّر جودة الحملة فعلًا. وتطبيقه على المجال العقاري في [إعلانات العقارات](https://ahmed-abdelhamed.com/blog/real-estate-facebook-ads/).

### تأخير الإرسال

الأحداث بيفضّل تتبعت في أقرب وقت بعد حدوثها، لأن ميتا بتستخدمها في التحسين اللحظي. تأخير طويل بيقلل فائدتها، وفي حدود زمنية بتقبلها ميتا، فراجع التوثيق الحالي.

### تحليل مشاكل شائعة بعد التركيب

### مشكلة: عدد الشراء في ميتا أعلى من طلباتك

- **التكرار بين البيكسل وCAPI:** افحص event_id وحالة إزالة التكرار.
- **تكرار البيكسل نفسه:** ركّب من طريقة واحدة بس.
- **صفحة الشكر بتتحمّل أكتر من مرة.**
- **طلبات ملغية بعد الشراء:** المتجر بيخصمها وميتا لا.

### مشكلة: عدد الشراء في ميتا أقل بكتير من طلباتك

- **حدث الشراء مش بيوصل في بعض الحالات** (بوابة دفع خارجية، أو كاش).
- **موافقة الكوكيز بتمنع جزء من الأحداث.**
- **الإسناد:** ميتا بتنسب لنفسها المبيعات اللي جاية من إعلاناتها بس، وباقي الطلبات (عضوي، بحث، مباشر) مش بتظهر عندها. وده مش خطأ تتبع.

### مشكلة: جودة مطابقة الأحداث ضعيفة

الأسباب: معلومات المطابقة ناقصة أو غير مرسلة. الحل: تأكد إن الإضافة أو الإعداد بيبعت البريد والهاتف (حيث يسمح الاستخدام القانوني) بشكل صحيح ومشفّر.

### مشكلة: الأحداث بتوصل متأخرة

راجع إعدادات السيرفر والـ Cron لو الإرسال معتمد على مهام مجدولة، وراجع أداء الموقع. وبطء الموقع بيأثر: [ليه موقع ووردبريس بطيء](https://ahmed-abdelhamed.com/blog/why-wordpress-site-slow/).

### متى تحتاج مطوّرًا

- لو بتبعت أحداث من CRM أو نظام خارجي.
- لو بتحتاج إعداد سيرفر (Server-Side GTM أو كود مخصص).
- لو الإضافة الجاهزة ما بتغطيش احتياجك الخاص (أحداث مخصصة، أو متجر غير ووكومرس).
- لو التكرار أو الفقدان مش بيتحلّ بالإعدادات العادية.

ولو بتبدأ لسه، متضيعش وقت في الإعداد المعقد قبل ما تتأكد إن أساس عرضك وإعلانك سليم، وده منهج [الاستراتيجية قبل الإعدادات](https://ahmed-abdelhamed.com/book/strategy-not-settings/). وشرح الربط بين التتبع والـ Funnel في [الـ Funnel بدون فلسفة](https://ahmed-abdelhamed.com/book/funnel-without-philosophy/).

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

- **إرسال الحدث من الاتنين بدون event_id متطابق:** تكرار.
- **ربط CAPI بالبيكسل الغلط.**
- **اعتبار CAPI بديل عن البيكسل** وتشغيل واحد فقط.
- **عدم اختبار بعد التركيب:** والنتيجة أرقام مضللة بدون ما تعرف.
- **إرسال قيم أو عملات غير صحيحة.**
- **إهمال الموافقة والخصوصية.**
- **الحكم على الحملة بعد تغيير التتبع مباشرة:** الأرقام بتتغير بعد التركيب، فقارن بحذر. وتحليل التقرير بشكل سليم في [إزاي تقرا تقرير حملاتك](https://ahmed-abdelhamed.com/blog/read-facebook-ads-report/).

وغيرها من الأخطاء المتكررة في [الأخطاء المتكررة](https://ahmed-abdelhamed.com/book/recurring-mistakes/).

### ملخص عملي: ترتيب تركيب Conversions API

1. **تأكد إن البيكسل سليم أولًا.**
2. **اختار طريقة التركيب** المناسبة لمستواك: إضافة رسمية، أو Gateway، أو GTM Server-Side، أو كود.
3. **فعّل الإرسال من السيرفر** وراجع ظهور الأحداث من المتصفح والسيرفر.
4. **اتأكد من event_id متطابق** وإزالة التكرار شغالة.
5. **راجع جودة المطابقة** وحسّنها بإرسال معلومات صحيحة ومشفّرة وفق الموافقة.
6. **اختبر بأحداث حقيقية** وقارن بطلباتك.
7. **راقب أسبوعين** قبل ما تحكم على تأثيرها في الحملات.

وتذكّر إن بعد تغيير التتبع، الأرقام بتتحرك: أحداث أكتر بتتسجّل، وممكن تشوف مبيعات منسوبة أكتر مما كنت بتشوف قبل. ده مش بالضرورة تحسّن في الأداء الفعلي، هو تحسّن في الرؤية. فقارن بعد التركيب بحذر وبطلبات المتجر الفعلية.

### كلمة أخيرة عن الصيانة المستمرة

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

للتأكد من أحدث التفاصيل، راجع [وثائق Conversions API الرسمية](https://developers.facebook.com/docs/marketing-api/conversions-api/)، لأن الواجهات والسياسات بتتغيّر باستمرار.

**مقالات ذات صلة بتفيدك:**

- [جودة مطابقة الأحداث: يعني إيه وإزاي ترفعها](https://ahmed-abdelhamed.com/blog/event-match-quality/)
- [معدل الارتداد: يعني إيه في GA4 وإمتى تقلق منه](https://ahmed-abdelhamed.com/blog/bounce-rate-explained/)
- [نافذة الإسناد: إزاي بتغيّر قراءتك لنتائج الحملة](https://ahmed-abdelhamed.com/blog/attribution-window/)
- [شرح جوجل تاج مانجر للمبتدئين: تركّبه إزاي وتستخدمه في إيه](https://ahmed-abdelhamed.com/blog/google-tag-manager-guide/)

## أسئلة شائعة

### هل CAPI هتزوّد مبيعاتي؟

مش مباشرة. هي بتحسّن دقة التتبع والتحسين، وده ممكن يحسّن الأداء مع الوقت، لكنها مش بتولّد طلبات بنفسها.

### CAPI ولا البيكسل؟

الاتنين مع بعض. البيكسل لوحده بيفقد جزء من الأحداث، وCAPI لوحدها بتفقد بعض معلومات المتصفح.

### إزاي أعرف لو في تكرار؟

من مدير الأحداث والتحذيرات، ومن مقارنة مبيعات ميتا بالطلبات الفعلية. ولو الفرق كبير، افحص event_id.

### محتاج مطوّر؟

للمتجر العادي بالإضافة الرسمية، غالبًا لأ. أما الأحداث من CRM أو الإعداد على السيرفر فغالبًا محتاج دعم تقني.

لو عايز تضبط التتبع على موقعك بشكل كامل من البيكسل لـ CAPI، احجز [استشارة](https://ahmed-abdelhamed.com/consultation/) ونراجع الإعداد.