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

إعداد S2S Postback: دليل من 5 دقائق للمسوّقين بالعمولة

من الصفر إلى تتبّع تحويلات حقيقية: بلا SDK وبلا pixel، فقط رابط postback من خادم إلى خادم مع المعاملات الصحيحة.

ما هو postback من نوع S2S

الـ postback من نوع server-to-server هو طلب HTTP بسيط يُرسله شبكة الأفيلييت الخاصة بك إلى المتتبّع عند حدوث تحويل. لا يعمل أي JavaScript في متصفح الزائر، لذا لا تؤثر فيه أدوات حظر الإعلانات ولا قواعد ملفات تعريف الارتباط ولا سرعة الصفحة. لهذا السبب هو الطريقة الافتراضية لاحتساب التحويلات في التسويق بالعمولة.

كيف ينتقل click ID

  1. ينقر الزائر على إعلانك ويصل إلى رابط التتبع الخاص بك. يسجّل المتتبّع النقرة ويمنحها click ID فريدًا.
  2. يُعيد المتتبّع توجيه الزائر إلى العرض ويمرّر click ID معه، على سبيل المثال كـ ?sub_id=….
  3. تحتفظ الشبكة بهذه القيمة مع الزائر. وعندما يتحوّل الزائر، تستدعي الشبكة رابط postback الخاص بك بالقيمة نفسها.
  4. يطابق المتتبّع click ID مع النقرة الأصلية ويضيف التحويل والعائد إلى الحملة والمسار وصفحة الهبوط والعرض الذي أنتجه.
إذا لم يصل click ID إلى الشبكة أبدًا، فلا يمكن مطابقة أي postback. تسع من كل عشر تذاكر "تحويلات مفقودة" سببها هذه الخطوة بالتحديد.

إعداد ذلك في XPNSR Tracker

1. مرّر click ID إلى العرض

إمّا أن تضبط Click ID forward parameter الخاص بالحملة (مثلًا clickid) فيُلحقه المتتبّع بكل رابط عرض، أو تضع الماكرو في رابط العرض بنفسك:

https://offer.example/landing?sub_id={click_id}&country={country_code}

استخدم اسم المعامل الذي تتوقّعه شبكتك: sub_id، aff_sub، s2 وما شابه. إعدادات الشبكات التابعة الجاهزة البالغ عددها 331 في المتتبّع تعرفها مسبقًا.

2. أعطِ الشبكة رابط postback الخاص بك

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

استبدل القيم بين الأقواس المعقوفة بماكروهات شبكتك الخاصة. في لوحة تحكم الشبكة يُسمّى هذا الحقل عادةً Postback أو S2S أو Server callback.

المعاملالمعنى
click_id أو subidمعرّف النقرة الذي أنشأه المتتبّع (إلزامي)
revenue أو payoutالعائد مقابل التحويل
statuslead، sale أو rejected، تُربط بأنواع التحويل لديك
currencyعملة العائد، إن لم تكن USD
tidمعرّف المعاملة، لعدة تحويلات على نقرة واحدة

تأمين postback

أي شخص يعرف الرابط يمكنه إرسال تحويلات مزيّفة. لكل حملة مفتاح سرّي خاص بـ postback: أضف &token=YOUR_SECRET إلى الرابط (أو أرسله ضمن ترويسة X-Postback-Token) وفعّل خيار Require token. يمكنك أيضًا تقييد postbacks بعناوين IP الخاصة بالشبكة. تُتجاهل postbacks المكرّرة لنفس التحويل.

الاختبار واستكشاف الأخطاء

  1. افتح رابط التتبّع بنفسك وأكمل تحويلًا تجريبيًا، أو استخدم postback التجريبي الخاص بالشبكة.
  2. افتح Clicks Log في المتتبّع وابحث عن نقرتك: يظهر التحويل عليها خلال ثوانٍ.
  • لا شيء يصل: تحقّق من الرابط في الشبكة بحثًا عن أخطاء إملائية ومن تطابق أسماء الماكرو مع توثيق الشبكة تمامًا.
  • يصل لكن لا يتطابق: لم يُمرَّر معرّف النقرة إلى العرض. افتح رابط العرض من نقرة تجريبية وابحث عنه.
  • مبالغ خاطئة: أرسل العائد كرقم عادي، بدون رمز عملة؛ استخدم currency للعوائد بغير USD.
  • أخطاء 401: الرمز المميّز مفقود أو خاطئ بينما خيار Require token مفعّل.

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

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