umami python 다운로드 - umami python 소스 코드 다운로드

umami python

웹사이트 데이터

v0.2.17

다운로드

Python 용 Umami Analytics 클라이언트

httpx 및 pydantic 을 기반으로 한 개인 정보 보호, 오픈 소스 Umami Analytics 플랫폼의 클라이언트.

umami-analytics 우마미 인스턴스 (자체 호스팅 또는 SAA)에 사용자 정의 데이터를 추가하기위한 것입니다. 많은 우마미 이벤트는 data-* 속성을 통해 HTML에서 직접 공급할 수 있습니다. 그러나 일부는 할 수 없습니다. 예를 들어, 앱에 트리거되었지만 명확한 HTML 작업이없는 이벤트가있는 경우 사용자 정의 이벤트를 추가 할 수 있습니다. 이것들은 웹 사이트의 Umami Analtytics 페이지의 맨 아래에 나타납니다.

한 가지 예는 Talk Python Training의 HTML이 아닌 Python 코드 내부에서 깊숙이 발생하는 구매 코스 이벤트입니다. 이것은 우리의 이벤트 섹션이 전형적인 주말 날 (미국 태평양 시간)의 모습입니다.

제공되는 것이 아니라 필요한 것에 초점을 맞추 었습니다

우마미 API는 광범위하며 그 중 상당수는 프론트 엔드 코드가 작동 할 수 있도록 의도 된 것입니다. 당신은 아마 그것을 원하거나 필요로하지 않을 것입니다. umami-analytics 대부분의 개발자가 사용자 정의 이벤트 추가와 같은 일반적인 SaaS 동작에 필요한 하위 집합 만 포함합니다. 즉, PR은 weclome입니다.

핵심 기능

wammi Mami Analytics 대시 보드에 사용자 정의 이벤트를 추가하십시오 .
귀하가 Numami에 등록한 세부 정보가 포함 된 모든 웹 사이트를 나열하십시오.
? 동기화 및 비동기 프로그래밍 모델.
API 응답을위한 Pydantic 모델을 사용하여 구조화 된 데이터 .
?
? 앞으로 단순화 된 API 에 대한 기본 웹 사이트를 설정하십시오.

이러한 기능 주변의 Python API에 대한 아래 사용 예제를 참조하십시오.

비동기 또는 동기화 API? 당신은 선택합니다

? Async는 지원되지만 Python 코드에는 필요하지 않습니다 . 네트워크 await 액세스하는 함수의 경우 Python의 async 와 함께 작동하는 func() 및 func_async() 변형이 있습니다.

설치

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 ()