You can use RudderStack's Transformations feature with the device mode-supported destinations like Firebase, Hotjar, etc.

To learn more about the use cases of device mode transformations, refer to the Use case section.

Client Transformation service architecture

RudderStack provides the Client Transformation service to facilitate the Transformations feature for device mode destinations. It ensures that the event ingestion to RudderStack backend isn't affected, assuring minimum response time from the RudderStack backend.

When you add a transformation and connect it to a destination supporting the device mode, the following steps are performed:

1. RudderStack SDK sends the event to the Client Transformation service. It multiplexes the event for different destinations and connects with the transformations attached to these device mode destinations.
2. Client Transformation service sends the event to the RudderStack Transformation service to transform the event according to the functions defined in the attached transformations.
3. After the transformation is applied, the transformed event is returned to the Client Transformation service.
4. Client Transformation service responds to the SDK with the transformed events for all the destinations.
5. Finally, the SDK parses the transformed events and forwards them to the specified device-mode destinations.

SDK setup

After adding a transformation and connecting it to a destination supporting device mode, you can connect your SDK source to it.

Further, follow the below steps for setting up the required SDK:

Copy
<script type="text/javascript">
!function(){var e=window.rudderanalytics=window.rudderanalytics||[];e.methods=["load","page","track","identify","alias","group","ready","reset","getAnonymousId","setAnonymousId","getUserId","getUserTraits","getGroupId","getGroupTraits","startSession","endSession","getSessionId"],e.factory=function(t){return function(){e.push([t].concat(Array.prototype.slice.call(arguments)))}};for(var t=0;t<e.methods.length;t++){var r=e.methods[t];e[r]=e.factory(r)}e.loadJS=function(e,t){var r=document.createElement("script");r.type="text/javascript",r.async=!0,r.src="https://cdn.rudderlabs.com/v1.1/beta/dmt/v1/rudder-analytics.min.js";var a=document.getElementsByTagName("script")[0];a.parentNode.insertBefore(r,a)},e.loadJS(),
e.load(<WRITE_KEY>,<DATA_PLANE_URL>),
e.page()}();
</script>

Copy
implementation 'com.rudderstack.android.sdk:core:1.8.0-beta.1'

Copy
pod 'Rudder', '1.8.0.beta.1'

Limitations

The following limitations are applicable when invoking a transformation in device mode:

• The network unavailability can lead to higher latency than expected while sending the events to the destinations. RudderStack doesn't lose data due to the network loss and stores the events in the client device until those are successfully delivered to the destination.

• The iOS SDK does not support the background processing of an event when the app is closed. However, the pending events are sent the next time the app is opened.

• The following memory and time limits must be followed:

  Parameter	Limit
  Memory limit	128 MB
  Execution time limit	4 seconds