Analytics API الخاص بـ Linkly

قم بتصدير بيانات النقرات وتقارير الحركة من Linkly برمجيًا باستخدام Analytics API الخاص بنا.

ذات صلة: Link Shortening API | Webhooks

قبل البدء

يقوم Linkly بإنشاء طلبات API في الواجهة لنسخها والصقها في تطبيقاتك.

وفر الوقت واترك لنا القيام بالعمل الشاق. واجهة برمجة التطبيقات الخاصة بنا قابلة للاستهلاك بالكامل بواسطة الآلات.

التفويض

ستحتاج إلى API Key و Workspace ID. يمكنك الحصول على هذه التفاصيل من داخل Linkly.

واجهة برمجة تقارير الحركة

يقوم Linkly تلقائيًا بإنشاء طلبات API لك داخل تقارير الحركة الخاصة بك.

تقوم تقارير الحركة الخاصة بـ Linkly بإنشاء طلبات API لك تلقائيًا، بناءً على البيانات المعروضة على الشاشة.

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

تنسيقات الإخراج

تدعم واجهة برمجة التطبيقات للتحليلات ثلاثة تنسيقات إخراج:

وضع Pivot (تنسيق مصفوفة)

بشكل افتراضي، تُرجع واجهة برمجة التطبيقات بيانات سلاسل زمنية بصف واحد لكل تاريخ. مع وضع Pivot، يمكنك الحصول على حركة الروابط بأكملها في طلب واحد كمصفوفة.

استخدم تصدير البيانات من القائمة المنسدلة في أي تقرير حركة لتصدير البيانات بسرعة حسب الرابط، أو أضف pivot=link_id إلى طلب API الخاص بك.

أضف pivot=link_id إلى طلبك للحصول على بيانات مع:

• التواريخ كصفوف (صف واحد لكل يوم)
• الروابط كأعمدة (عمود واحد لكل رابط)

مثال على إخراج Pivot CSV/TSV

مثال على إخراج JSON Pivot

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

يكون وضع Pivot مفيدًا لـ:

• مقارنة الحركة عبر روابط متعددة
• الاستيراد إلى جداول البيانات للتحليل
• بناء لوحات معلومات مع بيانات جميع الروابط في استدعاء واحد

بيانات النقرات الأولية

بيانات النقرات الأولية التي نسجلها، بما في ذلك المعاملات الكاملة والطوابع الزمنية ومعلومات الموقع الجغرافي، متاحة.

للوصول إلى هذه البيانات، انقر على تصدير من الألسنة في الأسفل واختر التنسيق الخاص بك. هذه طلبات API مكتملة بالكامل يمكنك استخدامها مباشرة في تطبيقك.

ملاحظات بشأن تصدير البيانات

• ضع في الاعتبار تصفية البيانات في العرض أولاً لتقليل كمية البيانات المُصدَّرة. تقوم هذه الوظيفة بتصدير البيانات الأساسية المستخدمة لإنشاء التقرير الحالي على الشاشة.
• يتم تخزين هذه البيانات مؤقتًا لمدة تصل إلى 3 ساعات. لن تنتج الطلبات المتكررة إلى نقطة النهاية هذه بيانات فورية.

الأعداد المجمعة

تُرجع نقطة النهاية /counters/{dimension} إجماليات النقرات مجمعة حسب بُعد واحد — مثل country أو platform أو destination أو referer أو isp أو link_id. تأتي النتائج مرتبة حسب عدد النقرات، الأعلى أولاً.

يتم إرجاع الحد الأقصى من 10,000 قيمة. الأبعاد عالية الكاردينالية — destination و referer و remote_ip و isp — يمكن أن يكون لديها قيم مميزة أكثر بكثير من ذلك في مساحة عمل مشغولة. عندما يكون الأمر كذلك، تتلقى أفضل 10,000 من خلال عدد النقرات والباقي لا يتم إرجاعه.

حقل total هو دائمًا إجمالي النقرات عبر كل مجموعة، بما في ذلك أي لم يتم إرجاعها. إذاً في النتيجة المقطوعة، ستضيف قيم count ما يصل إلى أقل من total — مما يعني أن النسبة المئوية المحسوبة كـ count / total لا تزال دقيقة.

إذا كنت بحاجة إلى المجموعة الكاملة من القيم بدلاً من أفضل 10,000، فقم بتصدير بيانات النقرات الأولية وقم بتجميعها بنفسك، أو استخدم BigQuery integration.

إشعارات النقرات الفورية

للحصول على إشعارات النقرات الفورية، انظر Webhooks. ترسل Webhooks طلب POST إلى عناوين URL المحددة لديك فورًا عند حدوث نقرة، مع معلومات مفصلة عن النقرة.

يمكنك أيضًا إدارة webhooks عبر واجهة برمجة التطبيقات - انظر OpenAPI spec للحصول على التفاصيل.

سياسة الاستخدام العادل

حدود المعدل

تقتصر واجهة برمجة التطبيقات للتحليلات على 50 طلب في الساعة لكل مساحة عمل.

حدود الاستخدام

بالإضافة إلى حدود المعدل، لدى Analytics API حدود الاستخدام التي تُعاد تعيينها في كل فترة فواتير:

ما الذي يحتسب كاستخدام

• طلبات API: كل استدعاء لنقاط نهاية Analytics API (/clicks و /counters و /export) يُحتسب كطلب واحد.
• البيانات الممسوحة: مقدار البيانات التي تمت معالجتها بواسطة قاعدة بيانات التحليلات الخاصة بنا لتلبية طلبك. تقوم نطاقات التواريخ الأكبر والاستعلامات الأكثر تعقيدًا بمسح المزيد من البيانات.

ما يحدث عند تجاوز الحدود

إذا تجاوزت حدود الاستخدام الخاصة بك:

1. 1
   ستُرجع طلبات API خطأ 429 Too Many Requests
2. 2
   سيتم إعادة تعيين حدودك تلقائيًا في بداية فترة الفواتير التالية
3. 3
   ستستمر الروابط الخاصة بك في العمل وتتبع النقرات بشكل طبيعي

نصائح لتقليل الاستخدام

يمكن لمعظم المستخدمين الحصول على جميع بياناتهم في طلب API واحد باستخدام وضع Pivot (pivot=link_id)، والذي يُرجع حركة جميع الروابط كمصفوفة في استدعاء واحد.

• استخدم وضع Pivot: أضف pivot=link_id للحصول على الحركة لجميع الروابط في طلب واحد بدلاً من الاستعلام عن كل رابط على حدة
• قم بتخزين الردود مؤقتًا: قم بتخزين استجابات API محليًا بدلاً من جلب نفس البيانات بشكل متكرر
• استخدم نطاقات تواريخ أصغر: استعلم فقط عن التواريخ التي تحتاجها
• دفع الطلبات: اجمع استعلامات روابط متعددة في طلب واحد باستخدام معامل link_ids

تحتاج إلى المزيد؟

إذا كنت بحاجة إلى حدود أعلى، يرجى التحدث إلينا باستخدام أداة الدعم.

BigQuery integration

لاحتياجات التحليلات عالية الحجم، يقدم Linkly BigQuery integration يوفر وصول SQL مباشر إلى بيانات النقرات الخاصة بك.

• وصول البيانات المباشرة - استعلم عن بيانات النقرات مباشرة في BigQuery مع التحديثات الفورية
• استعلامات غير محدودة - لا توجد حدود معدل API؛ أنت تدفع فقط لحساب BigQuery
• التقارير المخصصة - بناء لوحات معلومات مع Looker أو Data Studio أو Tableau
• توحيد البيانات - دمج بيانات النقرات مع مقاييس العمل الأخرى

يتم تضمين BigQuery integration في خطة Enterprise. تواصل معنا للحصول على التفاصيل.

تعرف على المزيد حول BigQuery Integration →

ذات صلة

• Link Shortening API - إنشاء وتحديث الروابط برمجيًا
• Webhooks - إشعارات النقرات الفورية
• BigQuery Integration - وصول SQL مباشر إلى بيانات النقرات
• Zapier Integration - تكاملات بدون كود