انتقل إلى المحتوى
Partnerfy Partnerfy
Türkçe English Deutsch Español Italiano Русский العربية
واجهة Conversion API · CAPI

انتهى زمن البكسل.
التتبع من جهة الخادم هو الرابح.

حين تجتمع قيود iOS 14.5 وSafari ITP مع نهاية ملفات تعريف الارتباط الخاصة بالجهات الخارجية وأدوات حظر الإعلانات، يضيع نصف بيانات التحويل التي يراها بكسل المتصفح (Browser Pixel). وقد أصبحت Meta وGoogle وTikTok وLinkedIn تعتمد اليوم على الأحداث المرسلة من الخادم بوصفها إشارة للتعلّم. ولهذا السبب تحديدًا أصبحت واجهة Conversion API ضرورة لا غنى عنها.

بعد الإعداد المعتاد، يرتفع معدل مطابقة الأحداث (Event Match Rate) من نحو 30% إلى نطاق 85-90%، فتعيد الخوارزمية التعلّم، وتنخفض تكلفة اكتساب العميل (CAC)، ويعود العائد على الإنفاق الإعلاني (ROAS) إلى مستواه. ومهمتنا بناء خط البيانات هذا بإتقان، دون إيقاف البكسل، ودون الإخلال بقانون KVKK التركي لحماية البيانات أو GDPR، ودون المساس بأدوات التحليلات الحالية لديك.

اطلب تدقيق CAPI خطة الإعداد
المتصفح
Purchase · 249.99 TRY
ملفات تعريف الارتباط محظورة
{`event_id:"a91"`} {`value:249.99`} {`em:sha256(...)`} {`fbp,fbc,ip,ua`}
الخادم
capi.partnerfy.co
M
Meta CAPI
graph.facebook.com/events
88%
G
Google Ads EC
googleadservices.com
91%
T
TikTok Events
business-api.tiktok.com
82%
L
LinkedIn CAPI
api.linkedin.com/conversions
79%
معدل المطابقة من 30% إلى 88%

لماذا تحتاج إليها؟

من كل 100 تحويل كان يرصدها بكسل المتصفح لديك، أصبحت 50 منها اليوم غير مرئية

عندما فعّلت Apple ميزة App Tracking Transparency مع iOS 14.5، رفض 75% من المستخدمين التتبع. وتحذف ميزة Intelligent Tracking Prevention في Safari ملفات تعريف الارتباط الخاصة بالجهات الخارجية خلال 7 أيام. وعلى مدار 2024-2025 تُلغي Chrome هذه الملفات تمامًا. وتمنع أدوات الحظر مثل uBlock Origin وBrave وDuckDuckGo عمل البكسل لدى 25-40% من المستخدمين. والنتيجة: تتغذى الخوارزمية الإعلانية على إشارات خاطئة، وتعرض الإعلانات على الأشخاص غير المناسبين، فترتفع تكلفة اكتساب العميل (CAC).

01

iOS 14.5 ATT

مع App Tracking Transparency يرفض 75% من المستخدمين التتبع. لقد اختفى معرّف IDFA، ولم تعد SKAdNetwork تقدّم سوى بيانات متأخرة وناقصة.

02

Safari ITP

تحذف Intelligent Tracking Prevention ملفات تعريف الارتباط الخاصة بالموقع نفسه خلال 7 أيام، وتلك التي يضبطها النص البرمجي خلال 24 ساعة. لقد انتهى التتبع بين المواقع.

03

نهاية ملفات تعريف الارتباط الخاصة بالجهات الخارجية

تُزيل Chrome هذه الملفات تمامًا في عام 2025، بينما تحظرها Firefox وEdge افتراضيًا بالفعل.

04

انتشار أدوات حظر الإعلانات

يستخدم 30-45% من مستخدمي أجهزة الكمبيوتر المكتبية في تركيا وألمانيا أدوات حظر الإعلانات، فيتوقف البكسل قبل أن يعمل أصلًا.

05

ePrivacy وKVKK وGDPR

إطلاق البكسل قبل الحصول على الموافقة غير قانوني. وعندما ينقر المستخدم على «رفض»، يظل بكسل المتصفح متوقفًا بصمت.

06

الخوارزمية جائعة للبيانات

تعتمد تحسينات الذكاء الاصطناعي لدى Meta وGoogle على جودة الإشارة. فحين تتراجع الإشارة، ترتفع تكلفة الألف ظهور (CPM)، وتقفز تكلفة اكتساب العميل (CAC)، وينخفض العائد على الإنفاق الإعلاني (ROAS).

كيف يعمل النظام

حدث واحد يصل إلى أربع منصات إعلانية بالتوازي، بلا تكرار ومع تجزئة البيانات

عندما يُتم المستخدم عملية شراء، ينشئ خادمنا كائن الحدث، ويجزّئ البريد الإلكتروني ورقم الهاتف باستخدام SHA-256، ويُبقي معرّف event_id مطابقًا لمعرّف البكسل (لإزالة التكرار)، ثم يرسل الحدث بالتوازي إلى أربع منصات إعلانية. وفيما يلي الحمولة الفعلية (Payload)، ولوحة معدل المطابقة الفعلية، ومنطق إزالة التكرار (Deduplication) الفعلي:

POST graph.facebook.com/v19.0/{`{pixel_id}`}/events
// Meta CAPI — Purchase event payload {   "data": [{     "event_name": "Purchase",     "event_time": 1748602800,     "event_id": "ord_a91c4f", // dedup key     "action_source": "website",     "event_source_url": "https://shop/...thank-you",     "user_data": {       "em": ["7c4a8d09ca3762af61e..."],       "ph": ["e6c2e9c9be1f7dd9e2..."],       "fbp": "fb.1.1748...", "fbc": "fb.1...."     },     "custom_data": { "value": 249.99, "currency": "TRY" }   }] }

معدل مطابقة الأحداث: البكسل وحده مقابل CAPI

مباشر
Meta 30% → 88%
Google 30% → 88%
TikTok 30% → 88%
LinkedIn 30% → 88%

إزالة التكرار عبر event_id

pixel event_id=ord_a91c4f
CAPI event_id=ord_a91c4f
Meta المعرّف نفسه يُحتسب تحويلًا واحدًا

حدث/ثانية

1.840

زمن الاستجابة

42ms

الأخطاء

0.04%

لمن هذه الخدمة؟

لكل من يهدر ميزانيته الإعلانية لأنه لا يستطيع قياسها بدقة

01

التجارة الإلكترونية · التركيز على Meta

متاجر إلكترونية تنفق أكثر من 100 ألف شهريًا وفقدت إسناد التحويلات (Attribution) بعد تحديثات iOS؛ وعند إعادة حدث Purchase الفعلي إلى Meta تستعيد عائد إنفاقها الإعلاني.

02

وكالات توليد العملاء المحتملين

وكالات تدير إعلانات Meta وGoogle لعملائها وتواجه صعوبة في التقارير الشهرية لعجزها عن قياس تعبئة النماذج على iOS؛ ومع CAPI يتضح إسناد العملاء المحتملين.

03

SaaS: التسجيل في الفترة التجريبية

شركات SaaS التي تحتاج إلى إبلاغ المنصة الإعلانية بالمستخدمين الذين بدأوا فترة تجريبية؛ كما تغذّي CAPI سلسلة التحويل من الفترة التجريبية إلى الاشتراك المدفوع.

04

وكالات لديها أكثر من 10 عملاء على Meta

بنية تحتية White-Label لواجهة CAPI تتيح إدارة الأحداث وإزالة التكرار وضمان الجودة لجميع الحسابات من وحدة تحكم واحدة.

05

الأسواق الإلكترونية ثنائية الجانب

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

06

التمويل: التحويلات المتأخرة

طلبات القروض وعروض التأمين التي تُعتمد بعد أيام: رفع التحويلات غير المتصلة بالإنترنت (Offline Conversions) مع CAPI معًا.

07

التجارة الإلكترونية متعددة المتاجر

من 3 إلى 10 متاجر تحت علامة تجارية واحدة؛ تمر أحداث كل نطاق عبر خط بيانات واحد مع ضمان إزالة التكرار.

08

قطاع التجزئة · خارج الإنترنت

رفع مبيعات نقاط البيع (POS) داخل المتاجر إلى التحويلات غير المتصلة بالإنترنت في Google Ads، مع إسناد التحويلات عبر الإنترنت وخارجها في تقرير واحد.

حزمة من 10 طبقات تعمل من جهة الخادم

تثبيت حزمة SDK منفصلة لكل منصة، أو البث إلى جميع المنصات عبر خط بيانات واحد

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

01

Meta Conversions API

نهج هجين يجمع البكسل وCAPI مع إزالة التكرار عبر event_id، ومعاملات em/ph/fbp/fbc كاملة، والتحقق عبر Test Events من صحة الأحداث.

02

Google Enhanced Conversions

مطابقة البيانات التي يقدمها المستخدم (البريد الإلكتروني + الهاتف، SHA-256) مع gclid، ورفع تحويلات الويب والتحويلات غير المتصلة بالإنترنت.

03

TikTok Events API

التقاط ttclid، وAdvanced Matching، وإزالة التكرار عبر event_id، والتكامل مع Test Event في Events Manager لاختبار الأحداث.

04

LinkedIn CAPI

إزالة التكرار بواسطة Insight Tag، ومطابقة li_fat_id لدى جمهور B2B مع بيانات المستخدم بعد تجزئتها.

05

Snap Conversions API

التقاط sc_cid، وبيانات مجزّأة، وأحداث الجوال والويب عبر خط بيانات واحد.

06

رفع التحويلات غير المتصلة بالإنترنت

إرسال الأحداث القادمة من CRM مثل «تم الدفع» و«تم الإلغاء» و«تم الاسترداد» إلى Google وMeta مجددًا.

07

Server-side Google Tag Manager

تشغيل sGTM على Stape.io أو على Cloud Run / ECS الخاص بك، من حمولة واحدة إلى أكثر من 10 وجهات.

08

ضمان إزالة التكرار عبر event_id

يحمل البكسل وCAPI المعرّف نفسه، فلا يحدث احتساب مزدوج في تقارير Meta وTikTok وLinkedIn على الإطلاق.

09

تجزئة PII والموافقة

تجزئة SHA-256 بعد توحيد الصيغة (Trim وLowercase)، مع تشغيل الأحداث وإيقافها وفق إدارة الموافقة.

10

التنسيق متعدد المنصات

حدث واحد يصل إلى 4 منصات بالتوازي، مع تتبع الأخطاء بأسلوب Sentry وقائمة انتظار لإعادة الإرسال.

آلية العمل

خارطة طريق للإعداد خلال 21 يومًا: من التدقيق إلى معدل مطابقة فعلي يتجاوز 85%

  1. 01

    الأيام 1-3 · تدقيق الأحداث

    نفحص البكسلات الحالية وdataLayer وحاوية GTM وأحداث GA4، ثم نقدّم قائمة واضحة بالأحداث الناقصة والأحداث التي تحمل معاملات خاطئة.

  2. 02

    الأيام 3-6 · مطابقة المخططات

    نطابق أحداث الخادم لديك مع مخططات Meta وGoogle وTikTok وLinkedIn، ونتفق على استراتيجية event_id وقواعد التجزئة والمعاملات الاحتياطية.

  3. 03

    الأيام 6-12 · بناء خط البيانات

    بعد اتخاذ القرار بين Stape.io وsGTM وCloud Run، نبرمج خط البيانات بمستوى بيئة الإنتاج: قوائم الانتظار، وإعادة المحاولة، وعدم تكرار الأثر (Idempotency)، وقوائم الرسائل الفاشلة (Dead-Letter).

  4. 04

    الأيام 10-14 · تجزئة PII والموافقة

    نوحّد صيغة em/ph/external_id ونجزّئها باستخدام SHA-256، ويتوقف إرسال الحدث على حالة الموافقة (KVKK وGDPR).

  5. 05

    الأيام 14-18 · النشر والتحقق

    تحقق مباشر على كل منصة عبر Meta Test Events وGoogle Tag Assistant وTikTok Test Event Tool، وتقرير عن معدل المطابقة خلال أول 48 ساعة.

  6. 06

    اليوم 18 وما بعده · المراقبة والتحسين

    لوحة تحكم لمعدل المطابقة، ومعدل الأخطاء، والأحداث المتأخرة، ومقارنة إسناد التحويلات على مستوى الحملات؛ مع تعديلات أسبوعية ومراجعة شهرية.

الأدوات التي نستخدمها

حزمة تقنيات CAPI وETL المعتمدة في القطاع

Meta Conversions API Google Enhanced Conversions TikTok Events API LinkedIn CAPI Snap CAPI Server-side GTM Stape.io RudderStack Segment Tealium Zapier

قصص العملاء

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

التجارة الإلكترونية من 41% إلى 89%

علامة أزياء D2C

ارتفع معدل مطابقة الأحداث على Meta من 41% إلى 89%، فأعادت الخوارزمية التعلّم، وبعد 6 أسابيع ارتفع ROAS على Meta من 2.1× إلى 3.4×، وزادت الإيرادات بنسبة 52% مع ثبات الميزانية الإعلانية.

توليد العملاء المحتملين زيادة ROAS بنسبة 127%

وسيط تأمين

إعداد CAPI لحملات توليد العملاء المحتملين على Meta التي انهارت بعد تحديثات iOS، فانخفضت تكلفة العميل المحتمل بنسبة 44%، وتحقق تعافٍ بنسبة 127% في العائد على الإنفاق الإعلاني.

SaaS خفض CAC بنسبة 38%

SaaS متخصص في قطاع محدد

إرسال حدث التسجيل في الفترة التجريبية إلى Google وMeta من جهة الخادم، وإغلاق سلسلة التحويل من الفترة التجريبية إلى الدفع عبر الرفع غير المتصل بالإنترنت. وتحقق انخفاض بنسبة 38% في تكلفة اكتساب العميل.

السوق الإلكتروني خفض CPL بنسبة 29%

سوق إلكتروني ثنائي الجانب

أحداث المشترين والبائعين عبر خط بيانات واحد: انخفضت تكلفة الإعلان الواحد بنسبة 29%، وتوسعت حملة استقطاب البائعين 3 مرات.

التمويل زيادة ROAS بنسبة 93%

منصة مقارنة القروض

تستغرق المدة من تقديم الطلب إلى الموافقة 7 أيام؛ وبفضل CAPI ورفع التحويلات غير المتصلة بالإنترنت، عادت إلى Meta إشارة «القرض المعتمد» الفعلية، فتحقق ارتفاع بنسبة 93% في العائد على الإنفاق الإعلاني.

وكالة 14 عميلًا

وكالة تسويق الأداء

بنية تحتية White-Label لواجهة CAPI تخدم 14 عميلًا في التجارة الإلكترونية: ارتفع متوسط معدل المطابقة من 39% إلى 86%، ولم تفقد الوكالة أي عميل (Churn 0%).

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

8 أسئلة جوهرية قبل إعداد CAPI

لا، أبقِه يعمل. فالإعداد الأمثل هجين: يواصل البكسل العمل في المتصفح (ويقدّم إشارة سريعة حيثما لا يكون محظورًا)، وترسل CAPI الأحداث من الخادم أيضًا. ولأن المصدرين يحملان معرّف event_id نفسه، تزيل Meta وGoogle وTikTok التكرار ويُحتسب التحويل مرة واحدة. أما الاكتفاء بواجهة CAPI فيفقدك معاملات لا يوفرها إلا المتصفح (fbp وfbc وttclid وبصمة الجهاز)، وهذا يخفض معدل المطابقة (Match Rate). فالبكسل لا يزال ذا قيمة، وCAPI تكمّله ولا تحل محله.
نعم، إذا تحققت ثلاثة شروط: (1) أن يكون المستخدم قد وافق على غرضي «الإعلان / القياس» في شريط الموافقة؛ (2) أن تُجزَّأ حقول PII (البريد الإلكتروني والهاتف والاسم) على الخادم باستخدام SHA-256 تجزئة لا يمكن عكسها؛ (3) ألا يدخل الحدث خط البيانات إطلاقًا في غياب الموافقة. وتضمن Partnerfy هذه الشروط الثلاثة تقنيًا، إذ توفر تكاملات جاهزة مع منصات الموافقة (Consent Mode v2 وIAB TCF وOneTrust وCookiebot وUsercentrics). ووفقًا لإرشادات المجلس الأوروبي لحماية البيانات (EDPB) وهيئة KVKK التركية، لا تُعد البيانات المجزّأة «بيانات شخصية» ما دام لا يمكن عكسها.
يتوقف ذلك على حجم الزيارات والقدرات التقنية. يتميز sGTM (حاوية الخادم من Google) بسرعة الإعداد، ويُدار من واجهة GTM، وهو مجاني لأقل من 100 ألف طلب شهريًا، ما يجعله مثاليًا للتجارة الإلكترونية ولمنتجات SaaS متوسطة الحجم. أما مع الزيارات المرتفعة جدًا (أكثر من 10 ملايين حدث شهريًا)، أو المنطق المعقد (إعادة محاولة مخصصة، وإزالة تكرار مشروطة، وقوائم انتظار)، أو متطلبات الامتثال الصارمة الخاصة بالبيانات الشخصية (PII)، فالخيار الصحيح هو خادمك الخاص المبني على Node/Go (Cloud Run أو ECS أو VPC خاصة بك). وتنفّذ Partnerfy الخيارين، ويتضح القرار خلال تدقيق مدته 30 دقيقة.
توفر Stape.io استضافة مدارة لخدمة sGTM، فتتولى أمور DNS وSSL والتوسع والمراقبة. وتتراوح التكلفة بين 20 و200 دولار أمريكي شهريًا، ويستغرق التثبيت من ساعة إلى ساعتين. ميزتها السرعة، وعيوبها أن البيانات تمر عبر جهة خارجية (ولا مشكلة في ذلك مع وجود الموافقة والتجزئة) وأن التخصيص محدود. أما الخادم الخاص (AWS Cloud Run أو Google Cloud Run أو Kubernetes الخاص بك) فيمنحك تحكمًا أكبر وتخصيصًا بلا حدود، وتبقى البيانات داخل VPC الخاصة بك، لكنه يضيف أعباء تشغيلية (DevOps). ونوصي عادةً بالبدء مع Stape.io ثم الانتقال إلى خادم خاص بعد 12 شهرًا إذا كان الحجم يبرر ذلك.
معدل المطابقة (Match Rate) هو نسبة الأحداث التي تنجح المنصة الإعلانية في مطابقتها مع هوية مستخدم حقيقي. ويرفعه: إرسال البريد الإلكتروني والهاتف والاسم والعنوان والمدينة بعد تجزئتها (فكلما زادت المعاملات تحسنت المطابقة)؛ والتقاط معرّفات النقر (fbp وfbc وgclid وttclid)؛ وضبط event_time بدقة (خلال 7 أيام من الحدث)؛ وتمرير عنوان IP وUser-Agent؛ وإضافة البلد والرمز البريدي. ويخفضه: إرسال البريد الإلكتروني وحده، والتجزئة دون توحيد الصيغة (Lowercase وTrim)، وغياب fbp/fbc، وعدم تسجيل دخول المستخدم. ونستهدف لكل منصة النطاقات التالية (Meta أكثر من 85%، وGoogle EC أكثر من 80%، وTikTok أكثر من 75%).
يستغرق الإعداد القياسي الذي يجمع التجارة الإلكترونية مع Meta وGoogle وTikTok من 14 إلى 21 يومًا. ومع dataLayer نظيف واجتماع انطلاق مدته ساعتان، ينتهي الأسبوع الأول بالتدقيق والمطابقة، ويُبنى في الأسبوع الثاني خط البيانات وطبقة التجزئة والموافقة، ويشمل الأسبوع الثالث التحقق المباشر وأول تقرير عن معدل المطابقة. وتضيف LinkedIn وSnap ثلاثة أيام، ويضيف رفع التحويلات غير المتصلة بالإنترنت أسبوعًا. أما تكامل CRM أو المنطق المخصص لقوائم الانتظار وإعادة المحاولة فيرفع المدة الإجمالية إلى 4-6 أسابيع.
لا. تعمل CAPI من جهة الخادم، ولا نضيف سطرًا واحدًا من النصوص البرمجية إلى صفحاتك (كل ما يلزم هو تعديل صغير من 5 أسطر في dataLayer لنقل معرّف event_id). وتبقى أدواتك الحالية مثل GA4 وGTM وHotjar وMixpanel وSegment ونظام ذكاء الأعمال لديك على حالها. بل إن sGTM يحسّن سرعة الصفحات لدى كثير من العملاء، لأن النصوص البرمجية الخارجية تنتقل إلى الخادم. ونبدأ التثبيت في بيئة الاختبار، ثم نشغّله بالتوازي لمدة أسبوع بمنطق A/B، وبعدها ننتقل إلى بيئة الإنتاج.
على ثلاثة مستويات: (1) تقنيًا: معدل المطابقة (نسبة الارتفاع)، ومعدل نجاح تسليم الأحداث (الهدف أكثر من 99%)، وزمن الاستجابة (الوسيط أقل من 100 ms). (2) إعلانيًا: إسناد التحويلات على مستوى الحملات (Meta Reports وGA4 ونظام ذكاء الأعمال لديك)، وانخفاض CPM، وانخفاض CPA / CPL، وارتفاع ROAS، ويتضح ذلك عادةً خلال 6-8 أسابيع. (3) تجاريًا: إجمالي الإيرادات، والمزيج بين القنوات العضوية والمدفوعة، والقيمة الدائمة للعميل. ونعرض ذلك كله في تقارير شهرية ولوحة تحكم مباشرة بسلسلة سببية واضحة: «تم إعداد CAPI، واستُعيد إسناد التحويلات، ونُقلت الميزانية من X إلى Y، فصار Z مستوى ROAS الجديد».

قِس إنفاقك الإعلاني بدقة

في تدقيق مجاني مدته 30 دقيقة، نراجع معك الوضع الحالي لإعداد البكسل وCAPI، ونشاركك خارطة الطريق لرفع معدل المطابقة إلى أكثر من 85% خلال أول 21 يومًا.

احجز اجتماعًا تواصل معنا
نتيجة