توثيق واجهة برمجة تطبيقات الشركاء

مرحبًا بك في وثائق واجهة برمجة تطبيقات شركاء Markopolo. تتيح واجهة برمجة تطبيقات الشركاء للمنصات دمج إمكانات تتبّع MarkTag في أنظمتها الخاصة، مما يمكّنها من تقديم تحليلات متقدمة وتتبع التحويلات لمستخدميها.

لمن هذا؟

تم تصميم Partners API للمنصات التي ترغب في دمج MarkTag كحلّ تحليلي:

منصات التجارة الإلكترونية

ادمج تتبّع MarkTag مباشرةً في منصتك، مما يمكّن التجار من إعداد التحليلات دون مغادرة لوحة التحكم الخاصة بك

منشئو المواقع الإلكترونية

قدّم MarkTag كحل تحليلات مدمج للمواقع الإلكترونية التي يتم إنشاؤها على منصتك

منصات التسويق

أضف إمكانيات تتبّع MarkTag لتعزيز ميزات أتمتة التسويق أو التحليلات لديك

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

إدارة التجار

  • أنشئ وأدر حسابات التجار تحت مظلة شريكك

  • نظّم عدة تجار من خلال تكامل API واحد

  • اعزل بيانات التاجر لأغراض الأمان والخصوصية

إنشاء والتحقق من MarkTag

  • إنشاء تطبيقات تتبّع فريدة لكل نطاق تاجر

  • الاكتشاف التلقائي للنطاقات المُتحقَّق منها مسبقًا مقابل النطاقات العادية

  • التحقق من إعدادات DNS لضمان الإعداد الصحيح

  • دعم عدة علامات لكل تاجر

الوصول إلى بيانات الحدث

  • استرجع أحداث التتبع التي جمعها MarkTag

  • قم بالتصفية حسب نطاقات التاريخ وأنواع الأحداث والمعلمات الأخرى

  • الوصول إلى بيانات التحويل وتفاعلات المستخدمين

  • إمكانيات بث الأحداث في الوقت الفعلي

البدء السريع

#1 احصل على وصول إلى واجهة برمجة التطبيقات وأكمل عملية الإعداد

  1. تواصل مع partners@markopolo.ai

  2. سيتعرف فريقنا على نشاطك التجاري وحالات الاستخدام الخاصة بك

  3. ستحصل على:

    • رمز API الخاص بـ Partners (mp_live_*)

    • سجل CNAME لإضافته إلى نطاقك

  4. قم بتكوين سجل CNAME على نطاقك لتمكين marktags الموثقة مسبقًا

لماذا إعداد CNAME؟

  • يتيح إنشاء marktag فوريًا ضمن نطاقك

  • لا توجد تأخيرات في التحقق من DNS لتجّارك

  • تتبّع الأحداث فورًا بمجرد إنشاء العلامات

#2 المصادقة

استخدم مصادقة رمز Bearer مع رمز واجهة برمجة التطبيقات الخاص بك:

curl -H "Authorization: Bearer mp_live_YOUR_TOKEN" \
  https://api-alpha.markopolo.ai/v1/partners/merchant

#3 أجرِ أول مكالمة لك

اختبر اتصالك:

curl -X GET https://api-alpha.markopolo.ai/v1/partners/merchant?limit=1 \
  -H "Authorization: Bearer mp_live_YOUR_TOKEN"

نظرة عامة على واجهة برمجة التطبيقات

عنوان URL الأساسي

https://api-alpha.markopolo.ai/v1/partners

تنسيق الطلب/الاستجابة

  • التنسيق: JSON

  • المصادقة: رمز حامل (بادئة mp_live_)

  • الطريقة: نقاط نهاية واجهة برمجة التطبيقات RESTful

سير عمل التكامل

للنطاقات التي تم التحقق منها مسبقًا (منصتك)

  1. إنشاء تاجر - سجّل التجار ضمن حساب شريكك

  2. إنشاء MarkTag - أنشئ التتبع باستخدام نطاقك الذي تم التحقق منه مسبقًا

  3. بدء التتبع - ابدأ بجمع الأحداث فورًا (بدون انتظار DNS)

  4. استرداد البيانات - الوصول إلى بيانات الأحداث عبر واجهة برمجة التطبيقات

للنطاقات المخصصة للتجار

  1. إنشاء تاجر - تسجيل التجار ضمن حساب شريكك

  2. إنشاء MarkTag - إنشاء التتبع للنطاق المخصص للتاجر

  3. تكوين DNS - يضيف التاجر سجل CNAME إلى نطاقه

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

  5. جمع الأحداث - يبدأ MarkTag بتتبع تفاعلات المستخدمين

  6. استرداد البيانات - الوصول إلى بيانات الأحداث عبر واجهة برمجة التطبيقات

الدعم والموارد

  • البريد الإلكتروني: partners@markopolo.ai

  • التوثيق: مرجع واجهة برمجة التطبيقات الكامل والأدلة الإرشادية

  • دعم التكامل: مساعدة تقنية للتنفيذ

ليس ما تبحث عنه؟

إذا كنت بحاجة إلى تنفيذ التتبع على مواقع الويب أو تطبيقات الجوال لالتقاط أحداث المستخدم والتحليلات،
فراجع وثائق MarkTag SDK الخاصة بنا بدلاً من ذلك.