Skip to content

Commit 32af8db

Browse files
committed
Merge remote-tracking branch 'origin/main'
2 parents 251d6b3 + a4679e8 commit 32af8db

1 file changed

Lines changed: 12 additions & 14 deletions

File tree

README.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,21 @@
1-
2-
31
# Quiver Analytics
42
[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.
53

64
## 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/).
86

97
## 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.
119

1210
## 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.
1715
* 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.
1816
* 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.
2119

2220
## Usage
2321
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
5250

5351
### Managing consent
5452

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 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:
5654

5755
if Analytics.should_show_consent_dialog():
5856
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
7674
### Advanced Properties
7775
If you turn on Advanced Settings for Project Settings -> Quiver -> Analytics, you'll find the following properties:
7876

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.
8280

8381
### Notes and Limitations
8482

0 commit comments

Comments
 (0)