كيف يُبلغ متجرك LinkHarbor بالمبيعات: معرّف النقرة وسر الـ Callback وCallback البيع. وكيف تُحسب مدفوعات الداعمين تحويلات.

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

مصادر التحويلات

المبيعات التي يُبلغ عنها متجرك أو خادمك عبر Callback بيع
مدفوعات الداعمين عبر Stripe؛ واسترداد المبلغ يزيل التحويل مجددًا، انظر مدفوعات الداعمين عبر Stripe

يرث كل تحويل بيانات النقرة التي ينتمي إليها: الصفحة والرابط والبلد والجهاز والمصدر المُحيل ومعاملات UTM. لذلك يظهر في الإحصائيات في المكان الذي جاءت منه النقرة بالضبط.

كيف تعمل النسبة

ينقر زائر على رابط في صفحتك
يحسب LinkHarbor النقرة، وعند إعادة التوجيه يضيف المعامل lt_click_id مع معرّف نقرة فريد إلى الرابط الهدف
تقرأ صفحتك الهدف (المتجر مثلًا) lt_click_id من العنوان وتحتفظ به حتى الشراء
بعد الشراء يرسل خادمك Callback بيع بمعرّف النقرة هذا إلى LinkHarbor
يظهر التحويل في لوحة التحكم وفي إحصائيات الصفحة

لا يُضاف معرّف النقرة إلا إلى الأهداف التي تبدأ بـ http://‎ أو https://‎. الروابط إلى mailto:‎ أو tel:‎ لا تحصل عليه، لأن المعامل سيُفسد الموضوع أو رقم الهاتف هناك. ولا تحصل نقرات الروبوتات على معرّف نقرة أيضًا.

إنشاء سر Callback

يجب أن يعرّف Callback البيع نفسه بسر Callback. يدير المالكون والمسؤولون الأسرار ابتداءً من Creator Pro تحت «Callback وواجهة API» في قسم الحساب من القائمة.

صفحة «Callback وواجهة API» مع بطاقتي مفاتيح API وأسرار Callback — تجد أسرار Callback تحت «Callback وواجهة API»

افتح «Callback وواجهة API»
في بطاقة «أسرار Callback» انقر «+ إنشاء سر جديد»
أدخل اسمًا اختياريًا، مثل «Callback المتجر»
انقر «إنشاء السر»
انسخ السر فورًا: فهو يُعرض مرة واحدة فقط

«تعديل»: غيّر الاسم والحالة (نشط أو غير نشط). السر غير النشط يُرفض.
«↺ تدوير»: يُنشئ سرًا جديدًا. يتوقف القديم عن العمل فورًا، لذا أدخل الجديد في متجرك مباشرة.
«حذف»: يزيل السر بعد طلب تأكيد.
«آخر Callback:»: يعرض آخر مرة استُخدم فيها السر، وإلا «لم يُستخدم بعد».

يمكنك إنشاء حتى 5 أسرار Callback لكل مساحة عمل.

إرسال Callback البيع

يرسل خادمك طلب POST إلى واجهة LinkHarbor API. ويوضع السر في الترويسة X-Callback-Secret.

Callback بيع باستخدام curl

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id: مطلوب. معرّف النقرة من lt_click_id (من 10 إلى 36 حرفًا).
order_id: مطلوب. رقم طلبك (من 1 إلى 128 حرفًا). لا يُحسب إلا تحويل واحد لكل رقم طلب، فلا يُنشئ Callback مكرر تحويلًا ثانيًا.
amount: مطلوب. المبلغ كرقم عشري.
currency: مطلوب. رمز عملة من 3 أحرف، مثل EUR.
occurred_at, meta: اختياري. وقت الشراء وحتى 50 مفتاحًا مخصصًا (من 1 إلى 64 حرفًا لكل منها) بمعلومات إضافية. القيمة نص من 500 حرف كحد أقصى، أو رقم، أو true/false، أو null؛ وترفض الـ API الكائنات المتداخلة.

الاستجابات

الحالة	المعنى
200	حُفظ التحويل؛ وتحتوي الاستجابة على conversion_id
403	السر خاطئ أو غير نشط، أو معرّف النقرة غير معروف إذا لم ترسل workspace_id
404	معرّف النقرة غير معروف (فقط إذا أرسلت workspace_id الخاص بك)
413	جسم الطلب أكبر من 1 MB ‏(request_too_large)
422	حقل مطلوب مفقود أو بتنسيق خاطئ، مثل قيمة في meta طويلة جدًا أو متداخلة
429	أكثر من 120 Callback في الدقيقة من عنوان IP واحد

كل الحقول ورموز الأخطاء للمطوّرين موجودة في إرسال المبيعات والبيانات المخصصة.

تحليل التحويلات

لوحة التحكم: بطاقتا «التحويلات» و«CVR» وبطاقة «التحويلات» حسب مصدر UTM ووسيطه
إحصائيات الصفحة: بطاقة «التحويلات» مع «CVR الإجمالي» و«CVR الفريد» و«التفصيل»
CVR الإجمالي = التحويلات مقسومة على النقرات؛ CVR الفريد = التحويلات مقسومة على النقرات الفريدة

لم تجد ما تبحث عنه؟

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

تواصل مع الدعم

نسب التحويلات والمبيعات

#مصادر التحويلات

#كيف تعمل النسبة

#إنشاء سر Callback

#إرسال Callback البيع