Vincular código de inserção do DTM

A vinculação de códigos incorporados aplica-se principalmente a usuários do DTM e do Adobe Experience Platform Launch que usam hospedagem integrada do Akamai. Para quem pratica a auto-hospedagem, consulte a seção Auto-hospedagem no final deste artigo.

Código de inserção

Um código de inserção do DTM é uma <script> tag inserida no HTML da página da Web.

Essa <script> tag recupera um arquivo JavaScript publicado pelo DTM e carrega na página. Esse arquivo é o arquivo da biblioteca do DTM, normalmente chamado de tag container. Essa tag container contém todas as ferramentas, definições de elementos de dados, lógica de regras e código que você define no DTM.

O DTM publica esse arquivo de tag container no host da Web especificado, que é um local do Akamai ou seu próprio local FTP. O código de inserção fornecido pelo DTM é baseado nesse local de host.

Quando um usuário visita o site em um navegador, o navegador solicita o arquivo do DTM desse servidor, usando o código de inserção, e o carrega.

No diagrama abaixo, a Etapa 1 mostra o DTM publicando a tag container no host da Web especificado. Na Etapa 2, o navegador solicita a tag container, usando o código de inserção, e o host responde com o arquivo publicado.

Vinculação dos códigos de inserção

The linking process allows you to take the DTM Production embed code, with its matching host location, and use that same embed code with your Platform Launch production environment.

If you do this, DTM and Platform Launch share the server location and the container tag file name.

When you publish in Platform Launch , the Platform Launch container tag file overwrites the DTM file, so when the browser requests the file from the server, the Platform Launch file is returned.

In the diagram below, Step 3 represents Platform Launch publishing its container tag over the top of the DTM container tag (from Step 1). When Step 2 occurs, it gets the Platform Launch container tag instead.

IMPORTANTE

Essa substituição funciona de ambas as maneiras. If you publish Platform Launch , then subsequently publish from DTM, the DTM container tag overwrites the Platform Launch one. Você tem dois sistemas publicando no mesmo local. Isso significa que não é necessário alterar o código na página, mas significa também que você precisa ter cuidado ao publicar. Recomenda-se desativar a propriedade do DTM para evitar essa situação.

Pré-requisitos de vinculação

Antes de vincular o código de inserção:

  • A empresa do DTM deve estar conectada à mesma organização da Experience Cloud que o Platform Launch .
  • Your user account must have the Manage Environments right in Platform Launch and the Admin right in DTM.
  • Your DTM property must not already be linked to a different Platform Launch property.
  1. In Platform Launch , open the Environments tab.
  2. Crie um novo ambiente de Produção.
  3. Dê um nome ao ambiente.
  4. Ative a opção Link DTM embed code.
  5. Cole o código de inserção de produção do DTM no campo DTM Embed Code do Platform Launch .
  6. Finish configuring your Platform Launch Production environment (archive setup, etc).
  7. Clique em Save.

Platform LaunchO valida diversos itens e informa se o link foi bem-sucedido.

IMPORTANTE

Você pode ter somente um ambiente de Produção no Platform Launch . Se você já criou um nessa propriedade, é necessário excluir o ambiente de Produção existente para criar um novo ambiente vinculado. O novo ambiente não tem o mesmo código de inserção que o antigo, portanto, não faça isso a menos que esteja familiarizado com o processo.

Se você usar a vinculação do código de inserção, o processo será basicamente o mesmo que sem ela, mas com algumas diferenças em destaque:

  1. Create your property, install an extension, create data elements, and create rules in Platform Launch , as you normally would.
  2. Create your Development and Staging environments in Platform Launch as usual.
  3. Crie um ambiente de produção vinculado conforme descrito acima.
  4. Create your library in Platform Launch as usual.
  5. Teste no desenvolvimento, envie, teste no armazenamento temporário e aprove como de costume.
  6. Publicar. The Platform Launch container tag overwrites the DTM container tag and any browser with this embed code retrieves the Platform Launch container tag.
  7. Disable your DTM property to prevent accidentally publishing the DTM file over the top of the Platform Launch file.

A etapa 7 pode ser realizada a qualquer momento após a Etapa 3.

Auto-hospedagem

O DTM também oferece suporte à auto-hospedagem do arquivo de tag container do DTM. Há dois métodos para fazer isso:

  • Entrega FTP
  • Download da biblioteca

Em ambos os casos, não faz muito sentido migrar o código de inserção. Não custa tentar. Recomenda-se não usar essa opção, mas configurar os hosts e ambientes manualmente.

Entrega FTP

Due to the differences in setup between FTP and SFTP, DTM and Platform Launch cannot perform automated migrations of these settings.

Se estiver usando esse método para entrega da tag container, recomenda-se mudar para SFTP no Platform Launch . Você pode criar um host SFTP e usá-lo para qualquer ambiente.

Download da biblioteca

In Platform Launch , downloading the library no longer exists as a separate option. Se você usar um download da biblioteca no DTM, recomendamos que ignore a migração do código de inserção e configure o ambiente de produção com um host gerenciado pela Adobe e o Arquivamento ativado.

Você pode continuar usando o mesmo código de inserção utilizado com o DTM, mas é responsável por mover a biblioteca para seus próprios servidores com o nome de arquivo correto.

Nesta página