Add new spec for Rudderstack integration

content/collections/session-replay/en/session-replay-rudderstack-integration.md

@@ -0,0 +1,96 @@
+---
+id: 5416910c-32f8-4e80-be0f-88a10509c029
+blueprint: session-replay
+title: 'Session Replay Wrapper for Rudderstack'
+landing: false
+exclude_from_sitemap: false
+updated_by: 5817a4fa-a771-417a-aa94-a0b1e7f55eae
+updated_at: 1723742318
+---
+Amplitude provides a wrapper for integrating Rudderstack and Amplitude's Session Replay.
+
+{{partial:admonition type="note" heading=""}}
+This integration snippet supports [Rudderstack Cloud-mode](https://www.rudderstack.com/docs/destinations/rudderstack-connection-modes/#cloud-mode).
+{{/partial:admonition}}
+
+## Before you begin
+
+Use the latest version of the Session Replay SDK, which is {{sdk_versions:session_replay_standalone}}
+
+## Install the wrapper
+
+Use npm or yarn to install the package. This includes the Amplitude Session Replay SDK.
+
+{{partial:tabs tabs="npm, yarn"}}
+{{partial:tab name="npm"}}
+```bash
+npm install @amplitude/session-replay-browser --save
+```
+{{/partial:tab}}
+{{partial:tab name="yarn"}}
+```bash
+yarn add @amplitude/session-replay-browser
+```
+{{/partial:tab}}
+{{/partial:tabs}}
+
+## Use
+
+For information about the `sessionReplayOptions`, see the [Session Replay Standalone SDK configuration](/docs/session-replay/session-replay-standalone-sdk#configuration) section.
+
+```js
+import * as sessionReplay from "@amplitude/session-replay-browser";
+
+amplitude.init(AMPLITUDE_API_KEY, user_id, config).promise.then(() => {
+      window.rudderAnalytics.ready(function() {
+        const rudderAnonymousId = rudderAnalytics.getAnonymousId();
+
+        sessionReplay.init(AMPLITUDE_API_KEY, {
+            deviceId: rudderAnonymousId,
+            sessionId: rudderAnalytics.getSessionId(),
+            sampleRate: .1 // 10% of sessions will be captured 
+        }).promise;
+
+        // Update track method to include sessionReplayProperties
+        const rudderAnalyticsTrack = rudderAnalytics.track;
+        rudderAnalytics.track = function (eventName, eventProperties, options, callback) {
+          const sessionReplayProperties = sessionReplay.getSessionReplayProperties();
+          eventProperties = {
+            ...eventProperties,
+            ...sessionReplayProperties,
+          };
+          rudderAnalyticsTrack(eventName, eventProperties, options, callback);
+        };
+
+        // Update page method to include sessionReplayProperties
+        const rudderAnalyticsPage = rudderAnalytics.page;
+        rudderAnalytics.page = function (category, name, properties, options, callback) {
+          const sessionReplayProperties = sessionReplay.getSessionReplayProperties();
+          properties = {
+            ...properties,
+            ...sessionReplayProperties,
+          };
+          rudderAnalyticsPage(category, name, properties, options, callback);
+        };
+
+        sessionReplay.set(rudderAnalytics.getSessionId())
+      });
+    }
+);
+```
+
+## Rudderstack integration
+
+This integration updates Rudderstack's request architecture, which ensures that all `track` and `page` events include the required Amplitude `Session Replay ID` event property. 
+
+## Required field mapping
+
+Amplitude maps the [Rudderstack Anonymous ID](https://www.rudderstack.com/docs/event-spec/standard-events/identify/#anonymous-id) to the [Amplitude Device ID](/docs/faq/instrumentation#icon-chevron-down), and the [Rudderstack Session ID](https://www.rudderstack.com/docs/sources/event-streams/sdks/session-tracking/) to the [Amplitude Session ID](/docs/data/sources/instrument-track-sessions#how-amplitude-tracks-your-sessions). If you use another field for device ID, contact [Amplitude Support](https://support.amplitude.com). 
+
+## Troubleshooting
+
+{{partial:admonition type="warning" heading="Session replay and ad blockers"}}
+Session Replay isn't compatible with ad blocking software.
+{{/partial:admonition}}
+
+For troubleshooting information, see [Session Replay Standalone SDK | Troubleshooting](/docs/session-replay/session-replay-standalone-sdk#troubleshooting)

content/trees/navigation/en/session_replay.yaml

@@ -24,3 +24,6 @@ tree:
       -
         id: 6dce7130-8885-48eb-80c4-7b634fe560c3
         entry: 951b924e-d18a-44cc-b5b0-51142ffb4e75
+      -
+        id: 25c81e16-709f-42e1-9655-bbb6eb0fc606
+        entry: 5416910c-32f8-4e80-be0f-88a10509c029