Mobile-to-web and cross-domain ID sharing

Last update: January 9, 2024

CREATED FOR:

  • Developer

Overview

The Adobe Experience Platform Web SDK supports visitor ID sharing capabilities that enable customers to deliver personalized experiences more accurately, between mobile apps and mobile web content, and across domains.

Use cases

Deliver consistent personalization between mobile apps and mobile websites

A clothing company wants to personalize their customers’ experience based on their interests, and keep the personalization accurate in a mobile application that also loads WebViews. By using the mobile-to-web ID sharing feature, they can ensure that the most accurate offers are presented to customers, using the same visitor identifier in the app and mobile web content by passing the ECID to the mobile web URL.

Deliver consistent personalization across domains

A retailer with multiple online stores wants to personalize the shopper experience across their domains, based on customer interests. Using the Web SDK cross-domain ID sharing feature, the retailer can deliver accurate offers based on customer interests, across all of their domains.

Enhance visitor activity reporting

A technology retailer wants to improve their visitor activity reporting with information on when their visitors move from the mobile application to their mobile website, or to their other domains. Using the Web SDK cross-domain ID sharing feature, the marketing team can accurately track visitors across their web properties and generate activity reports.

Prerequisites

To use mobile-to-web and cross-domain ID sharing, you must use Web SDK version 2.11.0 or later.

For Edge Network mobile implementations, this feature is supported in the Identity for Edge Network extension starting with version 1.1.0 (iOS and Android).

This feature is also compatible with VisitorAPI.js version 1.7.0 or later.

Mobile-to-web ID sharing

Use the getUrlVariables API from the Identity for Edge Network extension to retrieve the identifiers as query parameters and attach them to your URL when opening webViews.

No additional configuration is required for the Web SDK to accept ECID values in the query string.

The query string parameter includes:

  • MCID: The Experience Cloud ID (ECID)
  • MCORGID: The Experience Cloud orgID that must match the orgID configured in the Web SDK.
  • TS: A timestamp parameter that cannot be older than five minutes.

Mobile-to-web ID sharing uses the adobe_mc parameter. When the adobe_mc parameter is present and valid, the ECID from the query string is automatically added to the identity map in the first request made to the Edge Network. All subsequent Edge Network interactions will use that ECID.

For more information on how to pass visitor IDs from a mobile app to a WebView, see the documentation on handling WebViews.

Implement cross-domain ID sharing

See the appendIdentityToUrl command for implementation instructions using both the Web SDK tag extension and the Web SDK JavaScript library.

Previous pageFirst-party device IDs
Next pageManage display events

Data Collection