الانتقال إلى المحتوى الرئيسي

​
المقدمة

توجهك هذه الدليل خلال كيفية تتبع إحالات الشركاء، التعامل مع أحداث العمولة، وزيادة إيراداتك من خلال شراكات موثوقة مع الشركاء عبر مدفوعات دودي. نحن نقدم تكاملات مع منصات الشركاء الرائدة بما في ذلك أفونسو و دب بارتنرز لمساعدتك في إدارة وتتبع برامج الشركاء الخاصة بك بسلاسة.

​
الميزات الرئيسية

نسبة العمولة الآلية

لا جداول بيانات أو تتبع يدوي. يتم نسب الإحالات تلقائيًا وتسجيلها عند إجراء عملية شراء.

تقارير في الوقت الحقيقي

يمكنك أنت وشركاؤك مراقبة الأداء والقيادات من لوحات المعلومات المخصصة.

خيارات تتبع مرنة

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

مشفرة وآمنة بالكامل

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

إعداد سريع

أطلق برنامج الشركاء الخاص بك في دقائق—لا حاجة لتغييرات في الكود بخلاف نسخ ولصق مقتطفات النص البرمجي ورموز API.

تكامل سلس

قم بتوصيل تتبع الشركاء مباشرة في تدفقات الدفع الخاصة بك باستخدام تكاملاتنا مع أفونسو ودب بارتنرز، منصات التسويق بالعمولة الرائدة.

​
خيارات التكامل

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

​
تكامل أفونسو

لقد تعاوننا مع أفونسو، منصة رائدة لإدارة الشركاء لتفعيل مبيعاتك. اتبع الخطوات أدناه لربط حساب مدفوعات دودي الخاص بك مع أفونسو وبدء تتبع المبيعات المدفوعة من الشركاء.
1

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

للبدء، قم بربط حساب مدفوعات دودي الخاص بك عن طريق إضافة مفتاح API الخاص بك.

​
كيفية الحصول على مفتاح API الخاص بك من مدفوعات دودي

  • قم بتسجيل الدخول إلى لوحة معلومات مدفوعات دودي
  • انتقل إلى قسم المطور في القائمة اليسرى
  • انقر على مفاتيح API
  • اختر إضافة مفتاح API
  • أعطه اسمًا (مثل “تكامل أفونسو”)
  • انقر على إنشاء و انسخ مفتاح API الخاص بك

​
أضف مفتاح API الخاص بك إلى أفونسو

  • افتح لوحة معلومات أفونسو عبر affonso.io
  • انتقل إلى تفاصيل البرنامج > الاتصال
  • انقر على بطاقة تكامل مدفوعات دودي
  • ألصق مفتاح API الخاص بك من مدفوعات دودي
  • انقر على الاتصال
سيتم تشفير مفتاح API الخاص بك بشكل آمن بواسطة أفونسو.
2

إضافة Webhook إلى مدفوعات دودي

بمجرد الاتصال، ستتلقى عنوان URL فريد من أفونسو. هذا يمكّن تتبع المدفوعات وتفعيل عمولات الشركاء.

​
إضافة عنوان URL لـ Webhook في مدفوعات دودي

  • في لوحة معلومات مدفوعات دودي الخاصة بك، انتقل إلى المطور → Webhooks
  • انقر على إضافة Webhook
  • ألصق عنوان URL لـ Webhook أفونسو (من إعدادات برنامجك)
  • احفظ الـ Webhook

​
إضافة سر Webhook في أفونسو

  • بعد حفظ الـ Webhook في مدفوعات دودي، انسخ مفتاح التوقيع المقدم
  • ألصقه مرة أخرى في أفونسو تحت إعدادات Webhook مدفوعات دودي
هذا يسمح لأفونسو بالتحقق بشكل آمن من الأحداث الواردة من مدفوعات دودي.
3

إضافة سكربت التتبع

ضع بكسل أفونسو على موقعك لبدء تتبع زيارات الشركاء والتحويلات.
<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>
هذا السكربت:
  • يتتبع زيارات الشركاء
  • يضع ملف تعريف الارتباط مع معرف الإحالة (affonso_referral)
  • يمكّن تتبع التسجيلات والمدفوعات
ضع هذا على جميع النطاقات التي يزور فيها المستخدمون أو يتحولون (مثل موقع التسويق، التطبيق).
4

تتبع تسجيلات المستخدمين

للحصول على رؤية أفضل في القمع وتحسين أداء الشركاء، تتبع تسجيلات المستخدمين كعملاء محتملين.
// After successful registration
window.Affonso.signup(userEmail);
هذا سيسجل إحالة جديدة كـ عميل محتمل إذا جاء المستخدم عبر رابط الشريك
  • سيتم عرضها في لوحة المعلومات الخاصة بك وإحصائيات الشريك
أفضل ممارسة: قم بتفعيل هذا بعد التسجيل الناجح أو التأكيد المزدوج (DOI).
5

تمرير بيانات الإحالة إلى مدفوعات دودي

لتخصيص العمولات بشكل صحيح، مرر معرف الإحالة من أفونسو إلى مدفوعات دودي أثناء الدفع.

​
تكامل المدفوعات

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: 'email@email.com', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

​
تكامل الاشتراك

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

​
روابط الدفع

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
لمزيد من التفاصيل، راجع وثائق API لمدفوعات دودي
6

اختبار تكاملك

قبل الإطلاق علنًا، اختبر إعدادك باستخدام روابط الشركاء الحية والمعاملات التجريبية.قائمة التحقق للاختبار:
  • ✅ إنشاء شريك وتوليد رابط تتبع
  • ✅ زيارة موقعك عبر رابط الشريك
  • ✅ تأكد من تحميل سكربت أفونسو وأن ملف تعريف الارتباط affonso_referral تم تعيينه
  • ✅ إكمال تسجيل (اختياري)
  • ✅ إكمال الدفع عبر مدفوعات دودي
  • ✅ تأكيد التتبع والتخصيص في لوحة معلومات أفونسو

​
تكامل دب بارتنرز

يمكنك أيضًا استخدام دب بارتنرز لتتبع إحالات الشركاء والتحويلات. تتيح لك ميزة تتبع التحويلات من دب تخصيص المبيعات إلى روابط الشركاء الخاصة بك، مما يوفر تحليلات تفصيلية حول أي الشركاء يحققون أكبر إيرادات.
للحصول على تعليمات إعداد مفصلة، راجع دليل تكامل دب الذي يغطي كيفية تتبع أحداث تحويل المبيعات وتخصيص الإيرادات إلى روابط الشركاء الخاصة بك.

​
إعداد سريع مع دب بارتنرز

  1. تفعيل تتبع التحويلات في لوحة معلومات دب لروابط الشركاء
  2. التقاط معرف نقرة دب (dub_id ملف تعريف الارتباط) عند إنشاء جلسات الدفع
  3. تخزين معرف النقرة في بيانات الدفع مع معلومات العميل
  4. تكوين تكامل Webhook لإرسال بيانات المبيعات إلى دب عند نجاح المدفوعات
يتتبع التكامل تلقائيًا:
  • المدفوعات لمرة واحدة
  • تفعيل الاشتراكات
  • المدفوعات المتكررة للاشتراكات

تعلم المزيد

عرض دليل تكامل دب الكامل مع أمثلة على الشيفرة وقوالب التحويل.

​
تحتاج إلى مساعدة؟

إذا واجهت أي مشاكل أو كنت بحاجة إلى دعم أثناء التكامل:

دعم أفونسو

  • تحدث معنا عبر الدردشة المباشرة على affonso.io
  • راسلنا عبر البريد الإلكتروني على support@affonso.io

دعم دب

  • زيارة وثائق دب للحصول على أدلة تتبع التحويلات
  • الاتصال بدعم دب من خلال لوحتهم

دعم مدفوعات دودي

لاستفسارات API الخاصة بمدفوعات دودي، راجع docs.dodopayments.com أو اتصل بفريق الدعم لدينا.

أدلة التكامل