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

​
المقدمة

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

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

Automated Commission Attribution

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

Real-Time Reporting

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

Flexible Tracking Options

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

Fully Encrypted & Secure

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

Quick Setup

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

Seamless Integration

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

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

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

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

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

Connect with Dodo Payments

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

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

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

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

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

Add Webhook to Dodo Payments

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

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

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

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

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

Add the Tracking Script

ضع بكسل Affonso على موقعك لبدء تتبع زيارات الشركاء والتحويلات.
<!-- 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

Track User Signups

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

Pass Referral Data to Dodo Payments

لاحتساب العمولات بشكل صحيح، مرّر معرّف الإحالة من Affonso إلى Dodo Payments خلال الدفع.

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

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}`;
لمزيد من التفاصيل، راجع وثائق واجهة برمجة تطبيقات Dodo Payments
6

Testing Your Integration

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

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

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

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

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

Learn More

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

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

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

Affonso Support

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

Dub Support

Dodo Payments Support

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

Integration Guides