Matomo component for Edgee

This is a Rust-based Edgee component that integrates Matomo analytics using the Edgee Data Collection protocol. It allows you to send user events, page views, and user identity data directly to your Matomo instance from the edge.

---

✨ Features

• ✅ Track custom user events (track)
• ✅ Track page views (page)
• ✅ Identify users and send user properties (user)
• ✅ Built for edge execution: fast, secure, serverless
• ✅ Supports _cvar custom variables
• ✅ Automatic enrichment with context (campaign, session, client, etc.)

---

🔧 Settings

This component requires the following settings:

Key	Type	Required	Description
site_id	string	✅	Your Matomo site ID
endpoint_url	string	✅	Full URL of your Matomo instance (e.g. https://matomo.example.com)
authentication_token	string	❌	Optional token_auth if needed for enhanced tracking

---

🧪 Testing Locally

🛠️ Build the component

edgee component build

✅ Run unit tests

cargo test

🔍 Run a live test with simulated events

edgee components test \
  --event-type page \
  --settings site_id=your_site_id,endpoint_url=https://your-matomo-instance.com,authentication_token=YOUR_TOKEN \
  --make-http-request

Replace event-type with track or user to test other event types.

---

📂 Project Structure

matomo-component/
├── src/
│   └── lib.rs                 # Main component logic
├── target/
│   └── wasm32-wasip2/
│       └── release/
│           └── matomo.wasm    # Built WebAssembly output
├── matomo.png                 # Component icon
├── Cargo.toml                 # Rust dependencies
└── edgee-component.toml       # Edgee manifest

---

📚 Learn More

• Matomo Tracking API
• Edgee Developer Guide