# Custom Event
### Prerequisites
* The Analytics feature must be enabled for your app. Follow this guide for setup: [analytics](https://docs.buildnatively.com/natively-platform/features/analytics "mention")
* Availability:
* Bubble Plugin Version: 2.25.0 or higher
* JavaScript SDK Version: 2.19.1 or higher
### Bubble.io Plugin
**\[Action]** Natively - Send Custom Event
* Event name - The unique identifier that will appear in your Analytics dashboard. (e.g., `user_onboarded`, `checkout_started`)
* Event data - A JSON object containing custom parameters and values you want to send with the event
#### Usage Example (Bubble Workflow)
1. In your workflow, add the action: `Natively - Send Custom Event`.
2. Provide the Event name.
3. Provide the Event data as a JSON object (must be valid JSON). Example:
```json
{
"user_id": "12345",
"screen": "home",
"duration_seconds": 45,
"is_premium_user": true
}
```
#### Result:
The event and its custom parameters will be recorded in your Analytics dashboard.
### JavaScript SDK
Use the `natively.analyticsTrackEvent()` method to send the event name and a JavaScript object containing the custom data.
Example:
```javascript
// 1. Define custom parameters using a Map
const eventData = new Map();
eventData.set('user_id', '12345');
eventData.set('screen', 'home');
eventData.set('duration_seconds', 45);
eventData.set('is_premium_user', true);
// 2. Send the event
natively.analyticsTrackEvent('button_clicked', Object.fromEntries(eventData));
```
### How to Test in AppsFlyer
1. Add the test device to your AppsFlyer account. Follow this guide: [here](https://support.appsflyer.com/hc/en-us/articles/207031996-Registering-test-devices#register-a-device-manually)
2. In the AppsFlyer dashboard, go to Settings > SDK Integration Test > Live events.
3. Select your app and the test device, then click Continue.
4. Start the event listener. Launch the app on the test device and trigger the custom event (e.g., click the button associated with the event).
#### **Result:**
You will see the custom event and its associated data registered in the AppsFlyer Live Events dashboard.
