Skip to main content

Custom Events

Track app-specific actions that are relevant to your marketing team.

When to Use Custom Events

Custom events are useful when:

  • Marketing wants to trigger automation campaigns based on specific user actions
  • You need to track app-specific flows or interactions
  • Users interact with promotional content or special features

Examples:

  • User signs up for a promotion
  • User completes onboarding
  • User enables notifications
  • User refers a friend
  • User uses a specific feature

Tracking Custom Events

Ometria.trackCustomEvent('promotion_signup', {
promotionId: 'summer-sale-2024',
source: 'homepage-banner',
});

Parameters

ParameterTypeRequiredDescription
eventTypestringYesCustom event type identifier
additionalInfoobjectNoAdditional data about the event

Examples

Promotion signup:

Ometria.trackCustomEvent('promotion_signup', {
promotionId: 'black-friday-2024',
discountCode: 'BF24',
});

Feature usage:

Ometria.trackCustomEvent('feature_used', {
featureName: 'wishlist',
action: 'add_item',
itemCount: 5,
});

Referral:

Ometria.trackCustomEvent('referral_sent', {
method: 'email',
referralCode: 'USER123',
});

Survey completion:

Ometria.trackCustomEvent('survey_completed', {
surveyId: 'nps-q4-2024',
score: 9,
});