Upgrade Preparation Guide

Adobe Experience Platform Launch is an entirely different system than DTM. Conceptually, they achieve the same goal, but the way they do so is different.

  • The_satelliteobject looks different in Platform Launch than it does in DTM.
  • The relationships between extensions, rules, and data elements are also different than before.
  • Some things that exist in both systems have moved to different locations or are accessed in different ways.

The Upgrade Assistant creates a Platform Launch property that works as closely as possible to the on-page behavior that you had in DTM. Refer to the following information about what moves and where it moves to in cases where the behavior differs from what you might expect.

Examples of differences that are further defined below:

  • Rule components and data elements that aren’t doing anything in your DTM property are not copied to Platform Launch . Example: Data Element conditions defined by a data element that does not exist are not copied.
  • Many conditions have been updated so the options available in the condition are slightly different in Platform Launch . Example: The Operating System condition no longer supports Blackberry.
  • Many resources are called something new in Platform Launch , so they are copied with the new name. Example: Page Top events move to Library Loaded events.
  • Many very specific conditions have been replaced by a more generic Value Comparison condition in Platform Launch . This enables more options, provides consistency with all the comparison operators, and simplifies maintainance as well. Example: the Cart Amount condition has been replaced by the Value Comparison condition.

Properties

Name

The name of your DTM property is copied to Platform Launch . (DTM - yyyy-mm-dd hh:mm:ss) is added to the end of the Platform Launch property name so you know exactly when it was migrated. You can remove this timestamp from your Platform Launch property name.

Domains

The domains on your DTM property are copied to Platform Launch .

If you have the same domain listed multiple times in DTM, it only appears on your Platform Launch property once. Domains in Platform Launch appear in lower case.

If you don’t have at least one valid domain defined on your DTM property, it is not copied.

Advanced Settings

The advanced settings on your DTM property are copied to Platform Launch .

Tools

When you upgrade to Platform Launch , the most commonly used DTM tools are converted into an installed Platform Launch extension on your property.

Adobe Analytics Tool

Tool Selection

DTM allows you to install multiple instances of the Analytics tool to your property. Platform Launch only allows a single instance of each Extension to be installed. Thus, only one Analytics tool is copied to Platform Launch during the upgrade.

The tool instance that is copied is determined by transforming the names to lower case, then sorting alphabetically. Whichever tool comes first is the one that is copied.

You can control which tool instance to copy by changing the name of the tool.

App Measurement Version

DTM gives you several different options to deploy App Measurement. Each is supported in Platform Launch , so whichever method you use, you’ll get the same method in Platform Launch .

If you’re using Managed by Adobe in the DTM tool, be aware that it lets you select any of the five most recent versions of App Measurement. The Adobe Analytics extension for Platform Launch uses the latest version of App Measurement, so depending on your selection there, copying to Platform Launch may result in a different version of App Measurement being used. If you want the version to match, modify your DTM tool to use the same version as Platform Launch before you upgrade.

Initial Beacon

In DTM, an Analytics beacon is fired on every page when App Measurement loads, even if no rules have been defined. In Platform Launch , this beacon call is controlled by a rule and does not happen automatically. The upgrade process creates this rule for you unless you use the Page code is already present option in DTM. This rule is called “Migrated from DTM: Adobe Analytics - Send beacon on every page” and has the following definition:

  • Event: Page Bottom This most closely matches the DTM behavior even though Platform Launch recommendsLibrary Load rather than Page Bottom in most cases.
  • Conditions: None
  • Exceptions: None
  • Actions: Adobe Analytics - Send Beacon

The Upgrade Assistant creates this rule in Platform Launch , as long as an Analytics tool is installed in DTM. If you used a return false inside custom code in DTM to suppress the initial beacon call, then you should leave the Platform Launch rule out of your library (or delete it) after the upgrade is complete.

Other

Analytics tools that don’t define a production report suite are not copied to Platform Launch .

Evars that don’t match the pattern of eVar\#\# are not copied to Platform Launch .

Experience Cloud ID Tool

The Experience Cloud ID tool is copied to Platform Launch . There are a few things you should know about that tool.

Extension Configuration

Some variables in the DTM tool are not supported in the Platform Launch extension. The following variables are copied to Platform Launch :

  • audienceManagerServer
  • audienceManagerServerSecure
  • cookieDomain
  • cookieLifetime
  • cookieName
  • disableThirdPartyCalls
  • idSyncAfterIDCallResult
  • idSyncAttachIframeOnWindowLoad
  • idSyncContainerID
  • idSyncDisable3rdPartySyncing
  • disableThirdPartyCookies
  • idSyncDisableSyncs
  • disableIdSyncs
  • idSyncIDCallResult
  • idSyncSSLUseAkamai
  • isCoopSafe
  • loadSSL
  • loadTimeout
  • marketingCloudServer
  • marketingCloudServerSecure
  • overwriteCrossDomainMCIDAndAID
  • resetBeforeVersion
  • sdidParamExpiry
  • serverState
  • sessionCookieName
  • takeTimeoutMetrics
  • trackingServer
  • trackingServerSecure
  • allowlistIframeDomains
  • allowlistParentDomain

Variables that do not have a value are not copied to Platform Launch .

Set Customer IDs

If the ECID tool configuration in DTM contains data in the Customer Settings section, that data is copied into a Platform Launch rule. The Platform Launch rule has the following definition:

  • Event: Library Loaded
  • Conditions: None
  • Exceptions: None
  • Actions: Experience Cloud ID - Set Customer IDs

Customer IDs that don’t have names or values are not copied.

If no valid customer IDs are found, no Platform Launch rule is created.

Google Universal Analytics

Tool Selection

DTM allows you to install multiple instances of the Google Universal Analytics tool to your property. Platform Launch only allows a single instance of each extension to be installed. Thus, only one tool is copied to Platform Launch during the upgrade.

The tool instance that is copied is determined by transforming the names to lower case, then sorting alphabetically. Whichever tool comes first is the one that is copied over.

You can control which tool instance to copy by changing the name of the tool.

Initial Beacon

In DTM, a beacon is fired on every page even if no rules are defined. In Platform Launch , this beacon call is controlled by a rule and does not happen automatically. The Upgrade process creates this rule for you unless you use the Google Universal Analytics page code is already present option. This rule is called Migrated from DTM: Google Universal Analytics - Send beacon on every page and has the following definition:

  • Event: Core - Page Bottom (This most closely matches the DTM behavior even though Platform Launch recommendsLibrary Load rather than Page Bottom in most cases.)
  • Conditions: None
  • Exceptions: None
  • Actions: Google Univeral Analytics - Send Page View

Hit Callback

If you have added any JavaScript code in the Hit Callback section inside the Google Universal Analytics tool, the Upgrade Assistant creates a matching rule for you in Platform Launch . The rule is called Migrated from DTM: Google Universal Analytics - Hit Callback and has the following definition:

  • Event: Google Universal Analytics - Hit Callback
  • Conditions: None
  • Exceptions: None
  • Actions: Core - Custom Code

Rules Definition

If you defined rules in DTM where Event Category or Event Action are missing from the rule definition, these event details are not copied to Platform Launch .

If you defined rules in DTM where Event Value is not a number, these event details are not copied to Platform Launch .

Tools that are not copied

The following DTM tools installed on your property are not copied to Platform Launch extensions.

  • Adobe Audience Manager
  • Adobe Media Optimizer
  • Adobe Target
  • AEM ContextHub
  • Nielsen
  • Google Analytics

Data Elements

In DTM, if a data element resolves to a value that is falsy (e.g., "", 0, false, null, undefined), the data element will fall back to the configured default value. In Platform Launch , the data element will only fall back to the configured default value if the resolved value is null or undefined .

Cookie data element types that don’t contain a cookie name are not copied to Platform Launch .

CSS Selector

In Platform Launch , the CSS Selector data element type is called DOM Attribute, so your CSS Selector data elements types are copied into DOM Attribute data element types.

CSS Selector data element types that don’t contain a selector are not copied to Platform Launch .

CSS Selector data element types that use the get the value of Other Attribute, but have specified an empty string, are not copied to Platform Launch .

JS Object

JS Object data element types that don’t contain a path are not copied to Platform Launch .

URL Parameter

URL Parameter data element types that don’t contain a parameter name are not copied to Platform Launch .

Rule Events

Page Top

In Platform Launch , the DTM Page Top event type is called Library Load, so all your DTM rules with Page Top events become Platform Launch rules with a Library Load event.

Rule Conditions

Browser

The Browser condition in Platform Launch has removed support for some older browsers that were supported in DTM. Only supported values are copied to Platform Launch .

Supported values in Platform Launch :

  • Chrome
  • IE
  • Firefox
  • Safari
  • Mobile Safari

Unsupported values in Platform Launch :

  • Opera
  • IE Mobile
  • Opera Mini
  • Opera Mobile
  • OmniWeb

If you use a Browser condition that contains only values that are now unsupported, the condition is not copied to Platform Launch .

Cart Amount

The DTM Cart Amount condition has been replaced by the Value Comparison condition in Platform Launch , so any Cart Amount conditions are copied to Platform Launch as Value Comparison conditions.

DTM Cart Amount conditions that don’t define a data element, or that define a data element that no longer exists, are not copied to Platform Launch .

Cart Item Quantity

The DTM Cart Item Quantity condition has been replaced by the Platform Launch Value Comparison condition, so any Cart Item Quantity conditions are copied to Platform Launch as Value Comparison conditions.

DTM Cart Item Quantity conditions that don’t define a data element, or that define a data element that no longer exists, are not copied to Platform Launch .

Data Element

The DTM Data Element condition has been replaced by the Platform Launch Value Comparison condition, so any Data Element conditions are copied to Platform Launch as Value Comparison conditions.

DTM Data Element conditions that don’t define a data element (or that define a data element that no longer exists) are not copied to Platform Launch .

Device

This condition does not exist in Platform Launch and is not copied over.

Logged In

The DTM Logged In condition has been replaced by the Value Comparison condition in Platform Launch , so any Logged In conditions are copied to Platform Launch as Value Comparison conditions.

DTM Logged In conditions that don’t define a data element, or that define a data element that no longer exists, are not copied to Platform Launch .

Operating System

The Platform Launch Operating System condition has removed support for some older operating systems that were supported in DTM. Only supported values are copied over to Platform Launch .

Supported values in Platform Launch :

  • Windows
  • MacOS
  • Linux
  • iOS
  • Android
  • Unix

Unsupported values in Platform Launch :

  • Symbian OS
  • Maemo
  • Blackberry

If you use an Operating System condition that contained only values that are now unsupported, the condition is not copied to Platform Launch .

Previous Converter

The DTM Previous Converter condition has been replaced by the Value Comparison condition in Platform Launch , so any Previous Converter conditions are copied to Platform Launch as Value Comparison conditions.

Registered User

The DTM Registered User condition has been replaced by the Value Comparison condition in Platform Launch , so any Registered User conditions are copied to Platform Launch as Value Comparison conditions.

Rule Actions

Custom Scripts

The contents of custom scripts are copied over as is. The code is not inpected to determine its purpose. It is simply copied to custom code in Platform Launch . There are a few things you should know about this process:

  • Any custom script in DTM (Non-sequential, Sequential JS, Sequential HTML) without content is not copied to Platform Launch .

  • ES6 is not supported in Platform Launch . ES6 is not supported in DTM either, but the compiler wouldn’t catch it because it didn’t exist when the DTM compiler was developed.

    IMPORTANT

    If you use ES6 code in DTM, the code is copied to Platform Launch , but your build fails with compile errors when you make the build. You can fix this before or after you upgrade.

  • In custom code, it is common to reference the _satellite object and various properties and functions that it provides. Platform Launch uses the satellite object, but it is not structured the same as before. Functions and properties that were supported in DTM move to Platform Launch , but many of the ones that were unsupported do not. If you use any of these functions in DTM, it is likely that your custom code needs to be updated. To see what is supported on the new Platform Launch satellite object, refer to the Platform Launch Object Reference.

On this page