{"id":19435952,"url":"https://github.com/ralscha/piwik-tracking","last_synced_at":"2025-04-24T21:30:45.752Z","repository":{"id":57715633,"uuid":"75476801","full_name":"ralscha/piwik-tracking","owner":"ralscha","description":"A java library that helps sending tracking requests to Piwik","archived":false,"fork":false,"pushed_at":"2025-03-07T08:54:24.000Z","size":328,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-03T11:36:25.805Z","etag":null,"topics":["java-library","piwik","piwik-tracking"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ralscha.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":"2016-12-03T13:56:27.000Z","updated_at":"2025-03-07T08:54:28.000Z","dependencies_parsed_at":"2023-01-30T19:15:56.741Z","dependency_job_id":"f50d32d3-c2db-4e1c-b8fe-9d3005275784","html_url":"https://github.com/ralscha/piwik-tracking","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralscha%2Fpiwik-tracking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralscha%2Fpiwik-tracking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralscha%2Fpiwik-tracking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralscha%2Fpiwik-tracking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ralscha","download_url":"https://codeload.github.com/ralscha/piwik-tracking/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250712880,"owners_count":21475093,"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":["java-library","piwik","piwik-tracking"],"created_at":"2024-11-10T15:08:33.273Z","updated_at":"2025-04-24T21:30:45.485Z","avatar_url":"https://github.com/ralscha.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Test Status](https://github.com/ralscha/piwik-tracking/workflows/test/badge.svg)\n\n\npiwik-tracking is a library that helps sending tracking requests to a [Piwik](https://piwik.org/) server \nfrom a Java application.   \n\n\n## Usage\n\nFirst create an instance of PiwikConfig to configure the tracker. Mandatory input\nis the name of the server that hosts Piwik. \n\n```\n  PiwikConfig config = PiwikConfig.builder().addIdSite(\"1\")\n\t    \t\t\t.host(\"mypiwik.host.com\")\n\t    \t\t\t.authToken(\"ffffffffffffffffffffff\")\n\t\t     \t\t.build();\n```\n\nNext create an instance of the PiwikTracker.\n```\n  PiwikTracker tracker = new PiwikTracker(config);\n```\n\nThe application then has to create an instance of PiwikRequest for every action it wants\nto send a tracking request to Piwik.\n```\n  PiwikRequest request = PiwikRequest.builder().url(\"http://my.site.com/index.html\")\n\t\t \t\t.putParameter(QueryParameter.ACTION_NAME, \"anAction\")\n\t\t\t\t.putParameter(QueryParameter.VISITOR_ID, 1)\n\t\t\t\t.build();\n```\n\nand send the request to Piwik either synchronous (blocking) or asynchronous (non-blocking). \n```\n  //send blocking request\n  tracker.send(request);\n\n  //send non blocking request\n  tracker.sendAsync(request);\n```\n\nWhen the application sends asynchronous requests the http library ([OkHttp](http://square.github.io/okhttp/)) \ninternally starts an ExecutorService. To properly shutdown this service an application can call the \nshutdown method: ```tracker.shutdown();```\n\n\n### Tracking HTTP API\nFor more information about the supported request parameters see the official documentation:    \nhttps://developer.piwik.org/api-reference/tracking-api\n\n\n\n## Maven\n\nThe library is hosted on the Central Maven Repository\n\n```\n\t\u003cdependency\u003e\n\t\t\u003cgroupId\u003ech.rasc\u003c/groupId\u003e\n\t\t\u003cartifactId\u003epiwik-tracking\u003c/artifactId\u003e\n\t\t\u003cversion\u003e1.0.3\u003c/version\u003e\n\t\u003c/dependency\u003e\n```\n\n## Changelog\n\n### 1.0.3 - August 12, 2019\n  * [Issue 1](https://github.com/ralscha/piwik-tracking/issues/1): token_auth shouldn't be mandatory\n  * [Issue 2](https://github.com/ralscha/piwik-tracking/issues/2): path and scheme cannot be changed\n  * [Issue 3](https://github.com/ralscha/piwik-tracking/issues/3): Cannot add path wish slashes\n\n### 1.0.2 - September 26, 2018\n  * Replace `javax.xml.bind.DatatypeConverter` code. This package no longer exists in Java 11\n\n### 1.0.1 - December 6, 2016\n  * Remove unnecessary System.out.println call\n\n### 1.0.0 - December 3, 2016\n  * Initial release\n\n\n## License\nCode released under [the Apache license](http://www.apache.org/licenses/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralscha%2Fpiwik-tracking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fralscha%2Fpiwik-tracking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralscha%2Fpiwik-tracking/lists"}