# Meta Conversions API ‏(CAPI) لنماذج جمع العملاء: أرسل العملاء المحتملين دون احتساب مزدوج

> **الجواب**: ترسل Meta Conversions API ‏(CAPI) الأحداث من خادمك بدلًا من متصفح الزائر. استخدمها مع Pixel وامنح **كليهما اسم الحدث نفسه ومعرّف الحدث نفسه**؛ وعندها تحتفظ Meta بنسخة واحدة وتتجاهل النسخة المكررة. والعملاء المحتملون الذين يفوتهم Pixel (بسبب حاجبات الإعلانات أو قيود التتبع في المتصفح أو إغلاق علامات التبويب) يُسجَّلون مع ذلك عبر حدث الخادم.

## لماذا لا يكفي Pixel وحده

يعمل Pixel في متصفح الزائر. وحاجبات الإعلانات وقيود التتبع في iOS وإغلاق الناس لعلامة التبويب فور الإرسال كلها تُسقط أحداثًا. فتُبلغ Meta عن تحويلات أقل من الواقع وتحسّن إعلاناتك بناءً على بيانات أقل. والنسخة المرسلة من جهة الخادم تسد هذه الفجوة.

## ما تحتاج إليه

1. **معرّف Pixel ‏(dataset)** من Meta Events Manager ← Data sources.
2. **رمز وصول Conversions API**: ‏Events Manager ← مجموعة البيانات الخاصة بك ← Settings ← Conversions API ← Generate access token.
3. **رمز حدث الاختبار** (اختياري): يظهر في علامة التبويب Test events، ويبدأ بـ `TEST`.

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

| مصدر الإرسال | اسم الحدث | معرّف الحدث |
|---|---|---|
| Pixel في المتصفح | `Lead` | `fbq('track', 'Lead', {}, {eventID: 'abc123'})` |
| الخادم (CAPI) | `Lead` | `"event_id": "abc123"` |

عندما يصل الاسم والمعرّف نفساهما من الجهتين، تحتفظ Meta بنسخة واحدة. أما إذا اختلف المعرّفان، أو اختلف الاسم (مثل `Lead` مقابل `SubmitApplication`)، فيُحتسب العميل المحتمل مرتين. أنشئ معرّفًا واحدًا في المتصفح لحظة الإرسال ومرّره إلى الجهتين.

## ما تضعه في حدث الخادم

- `event_name` ‏(Lead)، و`event_time`، و`event_id`، و`action_source: "website"`، و`event_source_url`
- `user_data`
  - يُرسل كما هو: `client_ip_address`، و`client_user_agent`، و`fbc` (ملف تعريف ارتباط معرّف النقرة)، و`fbp` (ملف تعريف ارتباط معرّف المتصفح)
  - مجزّأ بـ SHA-256: الهاتف (`ph`، أرقام مع رمز الدولة، مثل 821012345678)، والبريد الإلكتروني (`em`، بأحرف صغيرة)، والاسم

كلما زادت المعرّفات تحسّنت Event Match Quality، لكن احسم مسألة الموافقة أولًا.

## الموافقة: البيانات المجزّأة تبقى بيانات شخصية

بموجب Personal Information Protection Act الكوري (ومعظم قوانين الخصوصية)، لا يجعل تجزئة رقم الهاتف منه بيانات مجهولة، وMeta جهة متلقية خارج البلاد. إعداد آمن:

1. أضف موافقة منفصلة واختيارية على "النقل عبر الحدود لأغراض قياس الإعلانات": الجهة المتلقية (Meta Platforms)، والبلد، والبيانات، والغرض، ومدة الاحتفاظ.
2. أدرج بيانات الاتصال المجزّأة فقط للأشخاص الذين وافقوا.
3. لبقية الأشخاص، أرسل الحدث بعنوان IP ووكيل المستخدم ومعرّفات النقر فقط.
4. لا ترسل أبدًا معلومات صحية مثل الأعراض.

راجع [نص الموافقة لنماذج جمع العملاء في كوريا](/en/guides/landing-consent-text) أو أنشئه باستخدام [أداة الموافقة المجانية](/en/tools/consent).

## التحقق

1. أضف رمز حدث الاختبار وأرسل عميلًا محتملًا تجريبيًا واحدًا.
2. في Test events يجب أن ترى حدثًا من Browser وحدثًا من Server، أحدهما معلَّم بأنه أُزيل تكراره.
3. احذف رمز الاختبار قبل الإطلاق الفعلي.

## أعد إرسال النتائج

عندما يتحول العميل المحتمل إلى استشارة أو عملية بيع، أرسل حدث خادم مخصصًا بالمعرّفات المجزّأة نفسها (أو بمعرّف خارجي). وعندها تستطيع Meta أن تتعلم مَن مِن الناس يتجاوز مرحلة ملء النموذج.

## في CutLanding

الصق معرّف Pixel ورمز الوصول في Settings ← Connect. بعد حفظ العميل المحتمل، تنطلق أحداث Pixel والخادم بالمعرّف نفسه، وتُضاف بيانات الاتصال المجزّأة فقط للأشخاص الذين وافقوا على قياس الإعلانات، ولا تُرسل البيانات الصحية أبدًا، وتُعاد محاولة الإرسالات الفاشلة لمدة 24 ساعة.

## FAQ

### هل يمكنني إزالة Pixel والاعتماد على Conversions API وحدها؟

توصي Meta باستخدام الاثنين مع إزالة التكرار. فبيانات المتصفح (ملفا تعريف الارتباط fbp وfbc) تساعد في المطابقة، وإذا تعطلت جهة سجّلت الأخرى العميل المحتمل.

### يُحتسب عملائي المحتملون مرتين. لماذا؟

أسماء الأحداث أو معرّفاتها تختلف بين Pixel والخادم. استخدم معرّفًا واحدًا لكل إرسال في الجهتين، واسم الحدث نفسه.

### ماذا لو تسرّب رمز الوصول؟

أنشئ رمزًا جديدًا في Events Manager واستبدله في كل مكان يُستخدم فيه. احتفظ بالرمز على الخادم فقط، ولا تضعه أبدًا في HTML الصفحة.


---
Source: https://cutlanding.com/ar/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
