Custom Conversion Names

Custom conversion events are designed for users who want precision tracking tailored to their business logic. These events go beyond standard conversions and allow you to define event names and behaviors that suit your specific needs.

🚧

TL;DR about Custom Conversion Names

1. Anytrack supports custom event names.
2. Custom event names can be sent via JS snippet or via Server Side integration
3. Syntax:
   1. Up to 40 characters
   2. Letters (A–Z, a–z)
   3. Numbers (0–9)
   4. Symbols: - _ * ( ) . : =

❗️

Strict rules:

• Extra characters will be trimmed
• Unsupported symbols or characters will be removed

Example:

• signup_complete@PRO!version#3🔥🔥🔥 becomes signup_completePROversion3

What Are Custom Conversion Names?

Custom events are powerful because they allow you to send exactly the conversion signals that matter to your business. They are ideal when:

• You have your own funnel or business rules
• Standard events don’t cover your use case
• You want to segment data based on highly specific actions

These events behave just like standard conversion names within AnyTrack, and all standard event attributes are supported.

⚠️

Important:

You must ensure these events are correctly mapped to your Ads platform's conversion events. Otherwise, they won’t be recognized and optimized by your ad networks.

How to Use Custom Conversion Names in Ads Platforms

To ensure compatibility, use the appropriate conversion category and naming conventions in:

• Google Ads: Match your custom event to a conversion action set up in Google Ads (e.g., signup_form, purchase_confirmed)
• Meta (Facebook Ads): Map your custom event under a custom conversion or standard event name in Events Manager

Incorrect or unmapped event names will result in dropped conversions or loss of attribution.

Rules and syntax for Custom Conversion names

✅ Allowed Syntax

1. Max 40 characters

   • If your event name exceeds this limit, it will be trimmed to the first 40 characters.

2. Allowed characters

   • Letters (A–Z, a–z)
   • Numbers (0–9)
   • Symbols: - _ * ( ) . : =

❗️

Warning:

Any other characters will be automatically removed from the event name.

Example

Input:

AnyTrack('trigger', 'signup_complete@PRO!version#3🔥🔥🔥', {
  email: '[email protected]',
});

Normalized Result:

signup_completePROversion3

And trimmed to 40 characters if necessary.

Sample Event Snippets

Use the following format to send a custom conversion event:

AnyTrack('trigger', 'custom_event_name', {
  eventValue: 100,
  currency: "USD",
  email: "[email protected]"
});

Examples:

AnyTrack('trigger', 'premium_checkout_started', {
  eventValue: 49.99,
  currency: "USD",
  email: "[email protected]"
});

AnyTrack('trigger', 'webinar_signup_bonus', {
  email: "[email protected]",
  name: "Jane Doe",
  funnel_step: "registration_page"
});