​
Introduction to Mappings

Event Mappings tell Converge how to translate your Converge events to a Destination. For example, consider this mapping:
mapping
This mapping tells Converge to forward an AddToCart-event to the Destination, whenever an Added To Cart-event is tracked in Converge.

​
Default vs Custom Mapping

For every Destination, Converge supports two mapping modes:
  • Default Mapping: Use the predefined Converge recommended mapping for the Destination.
  • Custom Mapping: Freely map your Converge events to the Destination.
default vs custom mapping
Use Custom Mapping only if you have a specific use case and understand its impact.

​
Forwarding modes

Event Mappings define not only how event names are translated, but also how events are forwarded. There are three forwarding modes:
  • Client: Forward the event to the Destination client-side.
  • Server: Forward the event to the Destination server-side.
  • Client & Server: Forward the event to the Destination client-side and server-side.
Some Destinations support only one forwarding mode. In those cases, you can map only events that match that mode.For example, if your Cancelled Subscription-event is implemented only server-side, you cannot map it to a Destination that supports only client-side forwarding.

​
Modify your Event Mapping configuration

Converge allows you to leverage custom mapping in all of your Destinations.
  1. Navigate to the Destinations Tab in your Converge dashboard
  2. Click on the Destination for which you want to modify your mapping configuration.
  3. Click on the Configuration, then click on Event mapping in the dropdown menu.
    event mapping
  4. Click on the mapping configuration you’d like to modify, if you’d like to map a new event, click on Add new mapping.
    The default mappings can only be turned on or off, you cannot modify them.
  5. Select an existing event or type in a new event you’d like to forward and then fill in the name you want to forward it as. Also choose the forwarding mode you’d like to use.
    For example, in the screenshot below, we forward an AddToWishlist event whenever a Started Checkout event triggers in Converge. The forwarding mode is set to Client & Server.
    set up custom event
  6. Make any additional changes as needed. When you’re satisfied with your mapping, click Save.
  7. Use the Destination Log to confirm that your event is forwarding correctly.
Your configuration may take up to 10 minutes to take effect. Clearing your browser cache can help ensure you’re testing the latest settings.