https://github.com/edgee-cloud/ga-component
Google Analytics 4 Edgee Component
https://github.com/edgee-cloud/ga-component
edge-computing edgee google-analytics-4 rust wasm wasm-component
Last synced: 10 months ago
JSON representation
Google Analytics 4 Edgee Component
- Host: GitHub
- URL: https://github.com/edgee-cloud/ga-component
- Owner: edgee-cloud
- License: apache-2.0
- Created: 2024-07-18T02:19:58.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-09T14:19:04.000Z (over 1 year ago)
- Last Synced: 2024-12-09T14:43:37.424Z (over 1 year ago)
- Topics: edge-computing, edgee, google-analytics-4, rust, wasm, wasm-component
- Language: Rust
- Homepage: https://www.edgee.cloud
- Size: 52.7 KB
- Stars: 1
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Google Analytics Component for Edgee
[](https://coveralls.io/github/edgee-cloud/ga-component)
[](https://github.com/edgee-cloud/ga-component/issues)
[](https://www.edgee.cloud/edgee/google-analytics)
This component enables seamless integration between [Edgee](https://www.edgee.cloud) and [Google Analytics](https://marketingplatform.google.com/about/analytics/), allowing you to collect and forward analytics data while respecting user privacy settings.
## Quick Start
1. Download the latest component version from our [releases page](../../releases)
2. Place the `ga.wasm` file in your server (e.g., `/var/edgee/components`)
3. Add the following configuration to your `edgee.toml`:
```toml
[[components.data_collection]]
id = "google_analytics"
file = "/var/edgee/components/ga.wasm"
settings.ga_measurement_id = "G-XXXXXXXXXX" # Your GA4 Measurement ID
```
## Event Handling
### Event Mapping
The component maps Edgee events to Google Analytics events as follows:
| Edgee Event | GA4 Event | Description |
|-------------|--------------|-------------|
| Page | `page_view` | Triggered when a user views a page |
| Track | Custom Event | Uses the provided event name directly |
| User | `user` | Used for user identification only |
### User Event Handling
User events serve multiple purposes:
- Triggers an `user` custom event call to GA4
- Stores `user_id`, `anonymous_id`, and `properties` on the user's device
- Enriches subsequent Page and Track events with user data
- Enables proper user attribution across sessions
## Configuration Options
### Basic Configuration
```toml
[[components.data_collection]]
id = "google_analytics"
file = "/var/edgee/components/ga.wasm"
settings.ga_measurement_id = "G-XXXXXXXXXX"
# Optional configurations
settings.edgee_anonymization = true # Enable/disable data anonymization in case of pending or denied consent
settings.edgee_default_consent = "pending" # Set default consent status if not specified by the user
```
### Event Controls
Control which events are forwarded to Google Analytics:
```toml
settings.edgee_page_event_enabled = true # Enable/disable page event
settings.edgee_track_event_enabled = true # Enable/disable track event
settings.edgee_user_event_enabled = true # Enable/disable user event
```
### Consent Management
Before sending events to Google Analytics, you can set the user consent using the Edgee SDK:
```javascript
edgee.consent("granted");
```
Or using the Data Layer:
```html
{
"data_collection": {
"consent": "granted"
}
}
```
If the consent is not set, the component will use the default consent status.
| Consent | Anonymization | Google Analytics Consent |
|---------|---------------|--------------------------|
| pending | true | analytics only |
| denied | true | analytics only |
| granted | false | fully granted |
## Development
### Building from Source
Prerequisites:
- [Rust](https://www.rust-lang.org/tools/install)
- WASM target: `rustup target add wasm32-wasip2`
- cargo-llvm-cov: `cargo install cargo-llvm-cov`
Build command:
```bash
edgee component build
```
### Contributing
Interested in contributing? Read our [contribution guidelines](./CONTRIBUTING.md)
### Security
Report security vulnerabilities to [security@edgee.cloud](mailto:security@edgee.cloud)