{"id":13847952,"url":"https://github.com/matomo-org/matomo-sdk-android","last_synced_at":"2025-07-12T11:32:53.574Z","repository":{"id":20074191,"uuid":"23343072","full_name":"matomo-org/matomo-sdk-android","owner":"matomo-org","description":"SDK for Android to measure your apps with Matomo. Works on Android phones, tablets, Fire TV sticks, and more!","archived":false,"fork":false,"pushed_at":"2024-08-09T02:19:22.000Z","size":6045,"stargazers_count":387,"open_issues_count":46,"forks_count":163,"subscribers_count":48,"default_branch":"master","last_synced_at":"2024-08-09T23:01:48.743Z","etag":null,"topics":["analytics","android","android-sdk","java","matomo","matomo-sdk","metrics","piwik","piwik-sdk","tracker"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matomo-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-08-26T07:37:33.000Z","updated_at":"2024-08-09T23:01:52.824Z","dependencies_parsed_at":"2023-09-29T05:40:27.519Z","dependency_job_id":"92e34441-138a-4987-8588-8e1f69ce6354","html_url":"https://github.com/matomo-org/matomo-sdk-android","commit_stats":{"total_commits":552,"total_committers":29,"mean_commits":19.03448275862069,"dds":0.7192028985507246,"last_synced_commit":"8ef21786e4275d2a0295c2fe064d548003295c59"},"previous_names":["piwik/piwik-sdk-android"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matomo-org%2Fmatomo-sdk-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matomo-org%2Fmatomo-sdk-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matomo-org%2Fmatomo-sdk-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matomo-org%2Fmatomo-sdk-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matomo-org","download_url":"https://codeload.github.com/matomo-org/matomo-sdk-android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224880615,"owners_count":17385367,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","android","android-sdk","java","matomo","matomo-sdk","metrics","piwik","piwik-sdk","tracker"],"created_at":"2024-08-04T19:00:37.480Z","updated_at":"2024-11-21T23:30:48.610Z","avatar_url":"https://github.com/matomo-org.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"Matomo SDK for Android\n========================\n\n[![](https://jitpack.io/v/matomo-org/matomo-sdk-android.svg)](https://jitpack.io/#matomo-org/matomo-sdk-android)\n![Build](https://github.com/matomo-org/matomo-sdk-android/actions/workflows/pull-request-ci.yml/badge.svg)\n[![Codecov](https://codecov.io/gh/matomo-org/matomo-sdk-android/branch/master/graph/badge.svg)](https://codecov.io/gh/matomo-org/matomo-sdk-android?branch=master)\n\nWelcome to the [Matomo](http://matomo.org) Tracking SDK for Android. This library helps you send analytics data from Android apps to Matomo instances. Until v4 this library was known as **Piwik** Tracking SDK for Android.\n\n__Features__:\n* Caching and offline support\n* Graceful reconnection handling\n* WIFI-only mode\n* Thread-safe support for multiple trackers\n* Support for custom connection implementations\n* Complete [Matomo HTTP API](https://developer.matomo.org/api-reference/tracking-api) support\n    * [Custom dimensions](https://matomo.org/docs/custom-dimensions/)\n    * [Event Tracking](https://matomo.org/docs/event-tracking/)\n    * [Content Tracking](https://matomo.org/docs/content-tracking/)\n    * [Ecommerce](https://matomo.org/docs/ecommerce-analytics/)\n* Checksum based app install/upgrade tracking\n\n## Quickstart\nFor the not so quick start, [see here](https://github.com/matomo-org/matomo-sdk-android/wiki/Getting-started) or look at our [demo app](https://github.com/matomo-org/matomo-sdk-android/tree/master/exampleapp)\n\n* [Setup Matomo](https://matomo.org/docs/installation/) on your server.\n* Include the library in your app modules `build.gradle` file\n  via [JitPack](https://jitpack.io/#matomo-org/matomo-sdk-android)\n\n```groovy\nrepositories {\n  maven { url 'https://jitpack.io' }\n}\ndependencies {\n  implementation 'com.github.matomo-org:matomo-sdk-android:\u003clatest-version\u003e'\n}\n```\n\n* Now you need to initialize your `Tracker`. It's recommended to store it as singleton. You can extend `MatomoApplication` or create and store a `Tracker` instance yourself:\n```java\nimport org.matomo.sdk.TrackerBuilder;\n\npublic class YourApplication extends Application {\n    private Tracker tracker;\n    public synchronized Tracker getTracker() {\n        if (tracker == null){\n            tracker = TrackerBuilder.createDefault(\"http://domain.tld/matomo.php\", 1).build(Matomo.getInstance(this));\n        }\n        return tracker;\n    }\n}\n```\n\n* The `TrackHelper` class is the easiest way to submit events to your tracker:\n```java\n// The `Tracker` instance from the previous step\nTracker tracker = ((MatomoApplication) getApplication()).getTracker();\n// Track a screen view\nTrackHelper.track().screen(\"/activity_main/activity_settings\").title(\"Settings\").with(tracker);\n// Monitor your app installs\nTrackHelper.track().download().with(tracker);\n```\n\n* Something not working? Check [here](https://github.com/matomo-org/matomo-sdk-android/wiki/Troubleshooting).\n\n## License\nAndroid SDK for Matomo is released under the BSD-3 Clause license, see [LICENSE](https://github.com/matomo-org/matomo-sdk-android/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatomo-org%2Fmatomo-sdk-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatomo-org%2Fmatomo-sdk-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatomo-org%2Fmatomo-sdk-android/lists"}