المدونة / التتبّع

شرح واجهات CAPI: إرسال التحويلات إلى منصّات الإعلانات

لماذا تطلب منصّات الإعلانات أحداث تحويل من جهة الخادم، وما الذي يحتاجه CAPI من متتبّعك، وكيف تحافظ على نظافة البيانات والموافقة عليها.

لماذا تطلب المنصات أحداث الخادم

تُحسّن منصات الإعلانات عروض الأسعار بناءً على التحويلات التي تراها. وتُفوّت البكسل العاملة على المتصفح حصة متزايدة منها: السكربتات المحظورة، وقِصَر عمر ملفات تعريف الارتباط، والمتصفحات داخل التطبيقات، والتحويلات التي تحدث بعد أيام على نطاق تابع للشبكة حيث لا يُحمَّل بكسلك أبدًا. وConversion API (CAPI) هو البديل من جهة الخادم: يُخبر نظامك المنصة مباشرةً بحدوث تحويل، عبر HTTPS.

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

ما الذي يحتويه حدث التحويل

تختلف الحقول الدقيقة حسب المنصة، لكن كل حدث يتضمّن نفس العناصر الأساسية:

  • اسم الحدث: lead أو purchase أو registration أو اسم مخصّص تعرفه المنصة.
  • وقت الحدث: وقت حدوث التحويل، لا وقت إرسالك له.
  • معرّف النقرة: معرّف النقرة الخاص بالمنصة والمُلتقَط عند النقرة الأولى، مثل gclid أو fbclid أو ttclid.
  • القيمة والعملة، إذا كنت تُحسّن بناءً على القيمة.
  • معرّف الحدث لتتمكّن المنصة من تجاهل التكرارات.

من الـ postback إلى منصة الإعلانات

  1. ينقر الزائر على الإعلان. تُلحق المنصة معرّف النقرة الخاص بها برابطك.
  2. يخزّن المتتبّع معرّف النقرة ذاك مع النقرة، إلى جانب معرّف نقرته الخاص.
  3. ترسل الشبكة postback يتضمّن معرّف نقرة المتتبّع عند تحويل الزائر.
  4. يجد المتتبّع النقرة، ويأخذ منها معرّف نقرة المنصة، ويرسل الحدث إلى Conversion API الخاص بالمنصة.
  5. تنسب المنصة التحويل إلى الإعلان وتستخدمه في عروض الأسعار.

يدعم XPNSR Tracker ثماني واجهات Conversion API ويحتفظ بقائمة انتظار لإعادة المحاولة، بحيث لا يؤدي انقطاع إحدى المنصات إلى فقدان الأحداث. أيًا كان ما تستخدمه، تأكّد من أن عمليات الإرسال الفاشلة تُعاد محاولتها وتكون مرئية، لا أن تُفقَد بصمت.

السبب الأكثر شيوعًا لعدم عمل CAPI هو الخطوة 2: لم يُلتقط معرّف نقرة المنصة أصلًا. تحقّق من أن الوسم التلقائي (auto-tagging) مُفعّل، وأن لا إعادة توجيه تحذف المعامل قبل أن يراه المتتبّع.

جودة المطابقة وإزالة التكرار

تقيّم المنصات مدى قدرتها على مطابقة أحداثك بمستخدميها. يمنح click ID أفضل مطابقة. وبدونه، تقبل بعض المنصات معرّفات مُجزّأة (hashed) مثل عنوان البريد الإلكتروني، لكن فقط إذا كان لديك الحق في مشاركتها.

إذا كنت تشغّل أيضًا بكسل متصفح، أرسل نفس event ID من الجانبين. تحتفظ المنصة بأحدهما وتُسقط الآخر. فبدون معرّف مشترك، تحتسب التحويل مرتين ويبالغ خوارزمية المزايدة في الدفع.

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

  • أرسل فقط ما تحتاجه المنصة لإسناد التحويل. غالبًا ما يكفي click ID مع طابع زمني (timestamp).
  • احترم إشارات الموافقة الواردة من صفحات الهبوط الخاصة بك. في المناطق التي تتطلّب موافقة، لا ترسل الأحداث الخاصة بالزوار الذين رفضوها.
  • لا ترسل أبدًا بيانات شخصية خام. تتوقّع المنصات التي تقبل المعرّفات أن تكون مُطبَّعة (normalised) ومُجزّأة (hashed).
  • احتفظ بسجلّ لما يُرسَل وإلى أين، حتى تتمكّن من الاستجابة لطلب حذف.

جرّبه على زياراتك الخاصة.

XPNSR Tracker: نقرات غير محدودة في كل الخطط، وتجربة لمدة 7 أيام على Start وPro.