Guia de preparação de atualização

OBSERVAÇÃO

A Adobe Experience Platform Launch está sendo reformulada como um conjunto de tecnologias de coleta de dados no Experience Platform. Essas alterações serão implementadas em toda a documentação do produto nas próximas semanas. Consulte o seguinte document para obter uma referência consolidada das alterações de terminologia.

O Adobe Experience Platform Launch é um sistema totalmente diferente do DTM. Conceitualmente, eles alcançam o mesmo objetivo, mas a maneira como fazem isso é diferente.

  • O _satellite objeto é diferente no em relação ao DTM. Platform Launch
  • As relações entre extensões, regras e elementos de dados também são diferentes de antes.
  • Alguns itens existentes em ambos os sistemas foram movidos para locais diferentes ou são acessados de maneiras diferentes.

O Assistente de atualização cria uma propriedade Platform Launch que funciona da maneira mais parecida possível com o comportamento na página que você tinha no DTM. Consulte as seguintes informações sobre o que se move e onde se move nos casos em que o comportamento é diferente do que pode ser esperado.

Exemplos de diferenças que são mais definidas abaixo:

  • Os componentes de regra e elementos de dados que não fazem nada na propriedade do DTM não são copiados para o Platform Launch. Exemplo: Data Element as condições definidas por um elemento de dados que não existe não são copiadas.
  • Muitas condições foram atualizadas para que as opções disponíveis na condição sejam um pouco diferentes no Platform Launch . Exemplo: a Operating System condição não é mais compatível com o Blackberry.
  • Muitos recursos são chamados de algo novo no Platform Launch para que sejam copiados com o novo nome. Exemplo: Page Top eventos são movidos para Library Loaded eventos.
  • Várias condições muito específicas foram substituídas por uma Value Comparison condição mais genérica no Platform Launch . Isso viabiliza mais opções, oferece consistência com todos os operadores de comparação e também simplifica a manutenção. Exemplo: a Cart Amount condição foi substituída pela Value Comparison condição.

Propriedades

Nome

O nome da propriedade do DTM é copiado para o Platform Launch . (DTM - yyyy-mm-dd hh:mm:ss) é adicionado ao final do nome da propriedade do Platform Launch para que você saiba exatamente quando foi migrado. Você pode remover esse carimbo de data e hora do nome da propriedade do Platform Launch.

Domínios

Os domínios na propriedade do DTM são copiados para o Platform Launch .

Se você tiver o mesmo domínio listado várias vezes no DTM, ele só será exibido na propriedade do Platform Launch uma vez. Os domínios no Platform Launch aparecem em letras minúsculas.

Se você não tiver pelo menos um domínio válido definido na propriedade do DTM, ele não será copiado.

Configurações avançadas

As configurações avançadas na propriedade do DTM são copiadas para o Platform Launch.

Ferramentas

Quando você atualiza para o Platform Launch, as ferramentas do DTM mais usadas são convertidas em uma extensão do Platform Launch instalada na propriedade.

Ferramenta do Adobe Analytics

Seleção da ferramenta

O DTM permite instalar várias instâncias da ferramenta do Analytics na propriedade. Platform Launch O permite que apenas uma única instância de cada Extensão seja instalada. Dessa forma, apenas uma ferramenta do Analytics é copiada para o Platform Launch durante a atualização.

A instância da ferramenta copiada é determinada pela transformação dos nomes para letras minúsculas e a classificação em ordem alfabética. A ferramenta que vem primeiro é copiada.

Você pode controlar qual instância da ferramenta deve ser copiada, alterando o nome da ferramenta.

Versão de avaliação do aplicativo

O DTM oferece várias opções diferentes para implantar a Avaliação do aplicativo. Cada uma é compatível com o Platform Launch, portanto, seja qual for o método usado, você terá o mesmo método no Platform Launch.

Se você estiver usando o Managed by Adobe na ferramenta do DTM, saiba que ela permite selecionar qualquer uma das cinco versões mais recentes da Avaliação do aplicativo. A extensão do Adobe Analytics para Platform Launch usa a versão mais recente da Avaliação do aplicativo, portanto, dependendo da sua seleção, copiar para o Platform Launch pode resultar em uma versão diferente da Avaliação do aplicativo usada. Se desejar que a versão corresponda, modifique a ferramenta do DTM para usar a mesma versão que o Platform Launch, antes de atualizar.

Beacon inicial

No DTM, um beacon do Analytics é acionado em todas as páginas ao carregar a Avaliação do aplicativo, mesmo que nenhuma regra tenha sido definida. No Platform Launch, essa chamada de beacon é controlada por uma regra e não ocorre automaticamente. O processo de atualização cria essa regra para você, a menos que você use a opção Page code is already present no DTM. Essa regra é chamada de “Migrado do DTM: Adobe Analytics - enviar beacon em todas as páginas” e tem a seguinte definição:

  • Evento: Page Bottom isso se aproxima mais do comportamento do DTM, embora o Platform Launch recomende Library Load em vez de Page Bottom na maioria dos casos.
  • Condições: Nenhuma
  • Exceções: Nenhuma
  • Ações: Adobe Analytics - Send Beacon

O Assistente de atualização cria essa regra no Platform Launch, desde que uma ferramenta do Analytics esteja instalada no DTM. Se você usou um return false código personalizado interno no DTM para suprimir a chamada de beacon inicial, deixe a Platform Launch regra do fora da biblioteca (ou exclua) após a conclusão da atualização.

Outras

As ferramentas do Analytics que não definem um conjunto de relatórios de produção não são copiadas para o Platform Launch.

eVars que não correspondem ao padrão de eVar\#\# não são copiados para o Platform Launch .

Ferramenta da Experience Cloud ID

A ferramenta da Experience Cloud ID é copiada para o Platform Launch. Você deve saber algumas informações sobre essa ferramenta.

Configuração de extensão

Algumas variáveis na ferramenta do DTM não são compatíveis com a extensão do Platform Launch. As variáveis a seguir são copiadas para o 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

Variáveis que não têm um valor não são copiadas para o Platform Launch .

Definição das IDs de cliente

Se a configuração da ferramenta da ECID no DTM contiver dados na seção Customer Settings, esses dados serão copiados para uma regra do Platform Launch A regra do Platform Launch tem a seguinte definição:

  • Evento: Library Loaded
  • Condições: Nenhuma
  • Exceções: Nenhuma
  • Ações: Experience Cloud ID - Set Customer IDs

As IDs de cliente que não têm nomes ou valores não são copiadas.

Se uma ID de cliente válida não for encontrada, nenhuma regra do Platform Launch será criada.

Google Universal Analytics

Seleção da ferramenta

O DTM permite instalar várias instâncias da ferramenta do Google Universal Analytics na propriedade. Platform Launch O permite que apenas uma única instância de cada extensão seja instalada. Dessa forma, apenas uma ferramenta é copiada para o Platform Launch durante a atualização.

A instância da ferramenta copiada é determinada pela transformação dos nomes para letras minúsculas e a classificação em ordem alfabética. A ferramenta que vem primeiro é copiada.

Você pode controlar qual instância da ferramenta deve ser copiada, alterando o nome da ferramenta.

Beacon inicial

No DTM, um beacon é acionado em todas as páginas, mesmo se nenhuma regra estiver definida. No Platform Launch, essa chamada de beacon é controlada por uma regra e não ocorre automaticamente. O processo de atualização cria essa regra para você, a menos que você use a opção Google Universal Analytics page code is already present. Essa regra é chamada de Migrado do DTM: Google Universal Analytics - enviar beacon em todas as páginas e tem a seguinte definição:

  • Evento: Core - Page Bottom (isso se aproxima mais do comportamento do DTM, embora o Platform Launch recomende Library Load em vez de Page Bottom na maioria dos casos.)
  • Condições: Nenhuma
  • Exceções: Nenhuma
  • Ações: Google Univeral Analytics - Send Page View

Retorno de chamada de hit

Se você tiver adicionado um código JavaScript na seção Retorno de chamada de hit da ferramenta do Google Universal Analytics, o Assistente de atualização cria uma regra correspondente para você no Platform Launch. A regra é chamada de Migrated from DTM: Google Universal Analytics - Hit Callback e tem a seguinte definição:

  • Evento: Google Universal Analytics - Hit Callback
  • Condições: Nenhuma
  • Exceções: Nenhuma
  • Ações: Core - Custom Code

Definição de regras

Se você definir regras no DTM onde a Categoria do evento ou a Ação do evento estiver ausente na definição de regras, esses detalhes do evento não serão copiados para o Platform Launch.

Se você definiu regras no DTM onde o Valor do evento não é um número, esses detalhes do evento não serão copiados para o Platform Launch.

Ferramentas que não são copiadas

As seguintes ferramentas do DTM instaladas na propriedade não são copiadas para as extensões do Platform Launch.

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

Elementos de dados

No DTM, se um elemento de dados resultar em um valor falsy (por exemplo, "", 0, false, null, undefined), o elemento de dados voltará ao valor padrão configurado. No Platform Launch, o elemento de dados voltará ao valor padrão configurado somente se o valor resultante for null ou undefined.

Cookie os tipos de elemento de dados que não contêm um nome de cookie não são copiados para o Platform Launch.

Seletor de CSS

No Platform Launch, o tipo de elemento de dados do Seletor de CSS é chamado de Atributo de DOM, de modo que os tipos de elemento de dados do Seletor de CSS são copiados para os tipos de elemento de dados do Atributo de DOM.

CSS Selector os tipos de elemento de dados que não contêm um seletor não são copiados para o Platform Launch.

CSS Selector os tipos de elemento de dados que usam o get the value of Other Attribute, mas especificaram uma cadeia de caracteres vazia, não são copiados para o Platform Launch.

Objeto JS

JS Object os tipos de elemento de dados que não contêm um caminho não são copiados para o Platform Launch.

Parâmetro de URL

URL Parameter os tipos de elemento de dados que não contêm um parâmetro não são copiados para o Platform Launch.

Eventos de regras

Início da página

No Platform Launch, o tipo de evento Page Top do DTM é chamado de Library Load, para que todas as regras do DTM com eventos Page Top se tornem regras do Platform Launch com um evento Library Load.

Condições da regra

Browser

A condição do Navegador no Platform Launch removeu o suporte para alguns navegadores mais antigos que eram compatíveis com o DTM. Somente os valores compatíveis são copiados para o Platform Launch.

Valores compatíveis no Platform Launch:

  • Google Chrome
  • IE
  • Firefox
  • Safari
  • Mobile Safari

Valores incompatíveis no Platform Launch:

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

Se você usar uma condição do Navegador que contenha apenas valores incompatíveis, a condição não será copiada para o Platform Launch.

Montante do carrinho

A condição Cart Amount do DTM foi substituída pela condição Value Comparison no Platform Launch, portanto, todas as condições Cart Amount são copiadas para o Platform Launch como condições Value Comparison.

As condições do DTM Cart Amount que não definem um elemento de dados ou que definem um elemento de dados que não existe mais não são copiadas para o Platform Launch.

Quantidade de itens do carrinho

A condição do DTM Cart Item Quantity foi substituída pela condição Platform Launch do Value Comparison, portanto, quaisquer Cart Item Quantity condições são copiadas para o como Platform Launch condições.Value Comparison

As condições do DTM Cart Item Quantity que não definem um elemento de dados ou que definem um elemento de dados que não existe mais não são copiadas para o Platform Launch.

Elemento de dados

A condição do DTM Data Element foi substituída pela condição Platform Launch do Value Comparison, portanto, quaisquer Data Element condições são copiadas para o como Platform Launch condições.Value Comparison

As condições do DTM Data Element que não definem um elemento de dados (ou que definem um elemento de dados que não existe mais) não são copiadas para o Platform Launch.

Dispositivo

Essa condição não existe no Platform Launch e não é copiada.

Conectado

A condição Logged In do DTM foi substituída pela condição Value Comparison no Platform Launch, portanto, todas as condições Logged In são copiadas para o Platform Launch como condições Value Comparison.

As condições do DTM Logged In que não definem um elemento de dados ou que definem um elemento de dados que não existe mais não são copiadas para o Platform Launch.

Sistema operacional

A condição do Platform Launch Operating System removeu o suporte para alguns sistemas operacionais mais antigos que eram compatíveis com o DTM. Somente os valores compatíveis são copiados para o Platform Launch.

Valores compatíveis no Platform Launch:

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

Valores incompatíveis no Platform Launch:

  • Symbian OS
  • Maemo
  • BlackBerry

Se você usar uma condição de Sistema operacional que contenha apenas valores que são incompatíveis agora, a condição não será copiada para o Platform Launch.

Conversor anterior

A condição Previous Converter do DTM foi substituída pela condição Value Comparison no Platform Launch, portanto, todas as condições Previous Converter são copiadas para o Platform Launch como condições Value Comparison.

Usuário registrado

A condição Registered User do DTM foi substituída pela condição Value Comparison no Platform Launch, portanto, todas as condições Registered User são copiadas para o Platform Launch como condições Value Comparison.

Ações da regra

Scripts personalizados

O conteúdo de scripts personalizados é copiado como está. O código não é inspecionado para determinar sua finalidade. Eles é simplesmente copiado para o código personalizado no Platform Launch. Você deve saber algumas informações sobre esse processo:

  • Qualquer script personalizado no DTM (não sequencial, JS sequencial, HTML sequencial) sem conteúdo não é copiado para o Platform Launch.

  • O ES6 é incompatível com o Platform Launch. O ES6 também é incompatível com o DTM, mas o compilador não detectava isso porque ele não existia quando o compilador do DTM foi desenvolvido.

    IMPORTANTE

    Se você usar o código ES6 no DTM, ele será copiado no Platform Launch, mas a build falhará, pois ocorrerão erros ao gerá-la. Você pode corrigir isso antes ou depois da atualização.

  • No código personalizado, é comum fazer referência ao objeto _satellite e às várias propriedades e funções fornecidas. Platform Launch O usa o satellite objeto, mas não está estruturado da mesma maneira que antes. As funções e propriedades compatíveis com o DTM são movidas para o Platform Launch, mas muitas das que eram incompatíveis não são movidas. Se você usar qualquer uma dessas funções no DTM, provavelmente o código personalizado precisará ser atualizado. Para ver o que é compatível com o novo objeto Platform Launch satellite, consulte a Platform Launch Referência de objeto.

Nesta página