Adobe Experience Platform - Session URLs via Tealium iQ

This guide focuses on capturing the URL from Fullstory and adding it to the Tealium Data Layer (UDO). The key challenge is that the Fullstory session URL is not available until after the Fullstory script has fully initialized and started a session, which can create a race condition with Tealium's tags.

The best practice is to use a Pre Loader extension in Tealium to define the official _fs_ready callback. This ensures that as soon as Fullstory is ready, it populates the Tealium Data Layer, making the URL available for all subsequent tracking calls.

Prerequisites

Step 1: Create a JavaScript Extension in Tealium iQ

This extension will set up a listener. When the Fullstory script is ready, it will grab the session URL and push it directly into the utag.data object.

1. Navigate to iQ Tag Management in your Tealium profile.
2. Go to the Extensions tab.
3. Click + Add Extension .
4. Select the JavaScript Code extension.
5. Give the extension a descriptive Title , such as "Set Fullstory Session URL".
6. In the Scope dropdown, select After Load Rules . This is critical as it ensures your listener is set up before any tags (including AEP) fire.

In the code editor, paste the following JavaScript:

// Ensure the utag data object exists
window.utag = window.utag || {};
window.utag.data = window.utag.data || {};

try {
    if (typeof window.FS === 'function') {
        var fsURL = window.FS('getSession', { format: 'url' });
        // If we successfully got the URL, add it to the UDO
        if (fsURL) {
            window.utag.data.fullstory_session_url = fsURL;
        }
    }
} catch (e) {
    // Optional: log an error to the console for debugging
    console.log("Tealium <Fullstory> Extension Error: " + e);
}
  

7. Click Save .

Step 2: Add the Variable to Your Data Layer

Now that the extension is populating utag.data.fullstory_session_url , you must officially define this variable in Tealium's Data Layer so it can be used by tags.

1. Go to the Data Layer tab in Tealium iQ.
2. Click + Add Variable .
3. In the Source field, enter the exact name you used in the JavaScript extension: fullstory_session_url .
4. In the Type dropdown, select UDO Variable .
5. Give it a user-friendly Alias (e.g., Fullstory Session URL).
6. Click Apply .

Step 3: Map the Variable to Adobe Experience Platform (AEP)

With the variable in the Tealium Data Layer, you can now map it to your AEP tag to send to the Experience Platform.

1. Under the iQ Tag Management menu click on the Tags tab.
2. Find and click on your Adobe Experience Platform Web SDK tag to edit its configuration.
3. Click on the Mapped Variables tab.
4. Find the Mapped Variables dropdown and search for Fullstory Session URL (or whatever alias you created).
5. Click the Add Mapping button, and you need to map your Fullstory Session URL to your desired XDM field. You will need to:
   • Select Custom Destination and enter the full XDM path for the field you created in AEP to store this URL.
   • Example XDM Path: _yourtenantid.fullstorySessionUrl or web.webPageDetails.sessionReplayUrl (depending on your specific XDM schema).
   • Click Done .
6. Click Apply. 

Step 4: Save, Publish, and Validate

1. In the top right corner click Save/Publish to save your changes in Tealium iQ.
2. Publish your work to your development or QA environment.
3. Validate your work:
   • Check the Data Layer: Open your website in a browser with the developer console. After the page loads, type utag.data.fullstory_session_url and press Enter. You should see the Fullstory session URL returned as a string.
   • Check the AEP Beacon: Use the Adobe Experience Platform Debugger browser extension. Load your page and look at the "Network" events for the AEP Web SDK. Inspect the payload (the events array) to find your XDM field and verify it contains the Fullstory URL.