Set up and manage custom source-destination mappings.
Available Plans
free
starter
growth
enterprise
3 minute read
RudderStack’s custom mappings feature lets you control and manage your source-destination property mappings for Event Stream connections. It simplifies the mapping process, ensures consistency across all your events, and eliminates the chances of instrumentation errors.
With custom mappings, you can:
Reduce repetitive manual updates to your mappings.
Ensure tailored data handling and transformation based on specific requirements.
Review the updated mappings before applying them to your events.
Track the changes in your property mappings centrally.
Custom mappings is an early access feature. It is available only for the Google Analytics 4 v2 destination currently.
Set up custom mappings
Create a new destination in RudderStack.
In the Configuration tab, go to Event and property mappings and click Set up mapping:
Click Set up mapping. You will see the following two tabs:
Global Mappings: Lists distinct property mappings applicable to all events.
The Global Mappings tab summarizes all the distinct property mappings across all events. It also lets you edit/remove the mappings that are common across all the events in one go. This approach is helpful in case of destinations where there are common property mappings across multiple events.
Note that:
You cannot add a new global mapping or edit the greyed out destination fields.
Editing the mappings in this tab updates the same mapping references across all events in the Event Level Mappings tab.
You can review the updated mappings before applying the changes. Any changes or updates made to the global mappings are highlighted in green.
You can also note the impacted events while reviewing the changes.
In the above image, the first line under Changes highlights the existing mapping and the second line indicates the updated mapping.
Once you click Apply changes to save the modifications, you are automatically redirected to the Event Level Mappings tab. Here, you can update the event-level mappings and save the changes.
Event Level Mappings
This tab contains the pre-populated property mappings for each event that is mapped to a destination event.
Note that:
Any changes in this tab affect only the specific event.
The changes are saved and propagated only if you click the Save button.
Each property is mapped using the jsonpath convention.
Add new mapping
Click the Add new event mapping option to specify a new mapping. In this view, you can:
Enter the RudderStack event name and the destination event you want to map.
Expand the Map your event property section to specify the custom property mappings.
Override global mappings for specific events
RudderStack automatically populates the global mappings applicable for each event in the Event Level Mappings tab. You can override these mappings by updating an existing mapping.
Add property mapping for existing event
You can add a new property mapping for an existing event by expanding Map your event property and clicking Add row:
Once you click Save, the new/updated mappings are visible in the Global Mappings tab and persisted in the backend:
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.