You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+12-14Lines changed: 12 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,21 @@
1
-
2
-
3
1
# Quiver Analytics
4
2
[Quiver Analytics](https://quiver.dev/analytics/) allows you to collect analytics for games made with the [Godot engine](https://godotengine.org) in a privacy-friendly way. In just a few minutes, you can integrate Analytics in your game through this open source plugin and gain valuable insight into how players are interacting with your game. You also have fine-grained control over how your players' privacy is handled.
5
3
6
4
## Guidelines
7
-
Before you get started, note that Quiver Analytics is meant to be used to collect anonymous information about your players to understand how your game is played while respecting their privacy. Please do not track personal information like names, email addresses, physical addresses, phone numbers, IP addresses, or any other identifying information to Quiver Analytics. Doing so may cause your account to be restricted. If you have any questions, [give us a shout](https:/quiver.dev/contact/).
5
+
Before you get started, note that Quiver Analytics is meant to be used to collect non-identifying information about your players to understand how your game is played while respecting their privacy. Please do not send personal information like names, email addresses, physical addresses, phone numbers, IP addresses, or any other identifying information to Quiver Analytics. Doing so may cause your account to be restricted. If you have any questions, [give us a shout](https:/quiver.dev/contact/).
8
6
9
7
## Prerequisites
10
-
This plugin requires Godot 4.0 or later. It's also to be designed to work with GDScript. We'll add support for other languages in the future.
8
+
This plugin requires Godot 4.0 or later. It's been designed to work with GDScript. We'll add support for other languages in the future.
11
9
12
10
## Installation
13
-
* Register your account on [quiver.dev](https://quiver.dev)
14
-
* Enable Analytics by going to to the [Quiver Analytics page](https://quiver.dev/analytics/) and creating an auth token
15
-
* Grab this plugin from the Godot Asset Library (use the AssetLib view in the Godot editor) or copy the `quiver_analytics` directory in this repo to the `/addons/` directory in your project root
16
-
* Go to your Project Settings -> Plugins and make sure Quiver Analytics is enabled
11
+
* Register your account on [quiver.dev](https://quiver.dev).
12
+
* Enable Analytics by going to to the [Quiver Analytics page](https://quiver.dev/analytics/) and creating an auth token.
13
+
* Grab this plugin from the Godot Asset Library (use the AssetLib view in the Godot editor) or copy the `quiver_analytics` directory in this repo to the `/addons/` directory in your project root.
14
+
* Go to your Project Settings -> Plugins and make sure Quiver Analytics is enabled.
17
15
* Close Project Settings and reopen it again. Go to the General tab and you should see a new "Quiver" section at the bottom of the left window.
18
16
* Go to Quiver -> Analytics in Project Settings and set your auth token to the token you created on the website.
19
-
* Run your game (the default settings should post a "Game launched" event to your dashboard)
20
-
*[View the dashboard](https://quiver.dev/analytics/) to see the new event
17
+
* Run your game (the default settings should post a "Game launched" event to your dashboard).
18
+
*[View the dashboard](https://quiver.dev/analytics/) to see the new event.
21
19
22
20
## Usage
23
21
The `Analytics` autoload is added to your project automatically when you enable the plugin.
@@ -52,7 +50,7 @@ The following is not required, but you do have additional functionality if you n
52
50
53
51
### Managing consent
54
52
55
-
By default, the plugin won't ask for consent since no personally-identifying information is collected. However, you can enable opt-in data collection by going to Project Settings -> Quiver -> Analytics and set "Player Consent Required" to true. Now calls to `add_event()` will be ignored until you obtain consent. To manage consent, you can either use the built-in UI:
53
+
By default, the plugin won't ask for consent since no personallyidentifying information is collected. However, you can enable opt-in data collection by going to Project Settings -> Quiver -> Analytics and set "Player Consent Required" to true. Now calls to `add_event()` will be ignored until you obtain consent. To manage consent, you can either use the built-in UI:
56
54
57
55
if Analytics.should_show_consent_dialog():
58
56
Analytics.show_consent_dialog(parent_node)
@@ -76,9 +74,9 @@ By default, the built-in consent UI will use whatever UI theme that has been set
76
74
### Advanced Properties
77
75
If you turn on Advanced Settings for Project Settings -> Quiver -> Analytics, you'll find the following properties:
78
76
79
-
* "Config File Path": where the config file is stored
80
-
* "Auto Add Event on Launch": whether a "Launched game" event is sent automatically when the game starts
81
-
* "Auto Add Event on Quit": whether a "Quit game" event is sent automatically.
77
+
* "Config File Path": where the config file is stored, defaults to "user://analytics.cfg".
78
+
* "Auto Add Event on Launch": whether a "Launched game" event is sent automatically when the game starts, defaults to true.
79
+
* "Auto Add Event on Quit": whether a "Quit game" event is sent automatically, defaults to true.
0 commit comments