umami python
v0.2.17
عميل للحفاظ على الخصوصية ، منصة تحليلات UMAMI المصدر مفتوح المصدر تعتمد على httpx و pydantic .
يهدف umami-analytics لإضافة بيانات مخصصة إلى مثيل Umami الخاص بك (مستضيف ذاتي أو SaaS). يمكن توفير العديد من أحداث Umami مباشرة من HTML عبر سمات data-* الخاصة بهم. ومع ذلك ، لا يستطيع البعض. على سبيل المثال ، إذا كان لديك حدث يتم تشغيله في تطبيقك ولكن ليس لديه إجراءات HTML واضح ، فيمكنك إضافة أحداث مخصصة. ستظهر هذه في الجزء السفلي من صفحة Umami Analtytics لموقع ويب.
أحد الأمثلة على ذلك هو حدث مشترك يحدث في عمق رمز Python بدلاً من HTML في Talk Python Training. هذا هو ما يبدو عليه قسم الأحداث لدينا ليوم عطلة نهاية أسبوع نموذجي (بتوقيت المحيط الهادئ الأمريكي):
واجهة برمجة تطبيقات UMAMI واسعة النطاق والكثير من ذلك يهدف إلى أن يكون رمز الواجهة الأمامية قادرة على العمل. ربما لا تريد أو تحتاج ذلك. يغطي umami-analytics المجموعة الفرعية فقط التي سيحتاجها معظم المطورين إلى إجراءات SaaS المشتركة مثل إضافة الأحداث المخصصة. ومع ذلك ، فإن PRS weclome.
انظر مثال الاستخدام أدناه ل Python API حول هذه الميزات.
؟ يتم دعم Async ولكنه غير مطلوب لرمز Python الخاص بك. بالنسبة للوظائف التي تصل إلى الشبكة ، يوجد متغير func() و func_async() يعمل مع async و await Python.
مجرد pip install umami-analytics
import umami
umami . set_url_base ( "https://umami.hostedbyyouorthem.com" )
# Auth is NOT required to send events, but is for other features.
login = umami . login ( username , password )
# Skip the need to pass the target website in subsequent calls.
umami . set_website_id ( 'cc726914-8e68-4d1a-4be0-af4ca8933456' )
umami . set_hostname ( 'somedomain.com' )
# List your websites
websites = umami . websites ()
# Create a new event in the events section of the dashboards.
event_resp = umami . new_event (
website_id = 'a7cd-5d1a-2b33' , # Only send if overriding default above
event_name = 'Umami-Test' ,
title = 'Umami-Test' , # Defaults to event_name if omitted.
hostname = 'somedomain.com' , # Only send if overriding default above.
url = '/users/actions' ,
custom_data = { 'client' : 'umami-tester-v1' },
referrer = 'https://some_url' )
# Create a new page view in the pages section of the dashboards.
page_view_resp = umami . new_page_view (
website_id = 'a7cd-5d1a-2b33' , # Only send if overriding default above
page_title = 'Umami-Test' , # Defaults to event_name if omitted.
hostname = 'somedomain.com' , # Only send if overriding default above.
url = '/users/actions' ,
referrer = 'https://some_url' )
# Call after logging in to make sure the auth token is still valid.
umami . verify_token ()قائمة الكود هذه هي رمز PSUEDO عالية الإخلاص. إذا كنت تريد مثالًا قابلًا للتنفيذ فعليًا ، راجع عميل المثال في الريبو.
راجع وثائق API لإضافة نقاط النهاية المتبقية. PRS موضع ترحيب. ولكن يرجى فتح مشكلة أولاً لمعرفة ما إذا كانت الميزة المقترحة تتناسب مع اتجاه هذه المكتبة.
يتمتع.
