Este tutorial se aplica se você tiver o Adobe Audience Manager (AAM) e o Adobe Analytics e estiver enviando uma ocorrência da página para o AAM usando o DIL (Data Integration Library) e também enviando uma ocorrência da página para a Adobe Analytics. Como essas duas soluções existem e como elas fazem parte da Adobe Experience Cloud, você tem a oportunidade de seguir a prática recomendada de ativar o encaminhamento pelo lado do servidor, o que permite Analytics servidores de coleta de dados para encaminhar os dados de análise do site em tempo real para o Audience Manager, em vez de fazer com que o código do lado do cliente envie uma ocorrência adicional da página para o AAM. Este tutorial o guiará pelas etapas de mudança da implementação de DIL do lado do cliente mais antiga para o método de encaminhamento do lado do servidor mais recente.
Ao comparar e contrastar esses dois métodos de inserir dados do Adobe Analytics no AAM, pode ser útil visualizar as diferenças na seguinte imagem:
Se você usar esse método para inserir dados do Adobe Analytics no AAM, você terá duas ocorrências vindas das suas páginas da Web: uma vai para Analytics, e um para AAM (após ter copiado o Analytics dados na página da Web. Segments são retornados do AAM para a página, onde podem ser usados para personalização e assim por diante. Essa é uma implementação herdada e não é mais recomendada.
Além de não seguir as práticas recomendadas, as desvantagens de usar esse método incluem:
É recomendável mudar para um método de encaminhamento do lado do servidor de implementação do AAM.
Como mostrado na imagem acima, uma ocorrência vem da página da Web para o Adobe Analytics. Analytics em seguida, o encaminha esses dados para o AAM em tempo real, e os visitantes são avaliados em características de AAM e segments, como se a ocorrência tivesse vindo diretamente da página.
Segments são retornados na mesma ocorrência em tempo real para Analytics, que encaminha a resposta à página da Web para personalização e assim por diante.
Não há desvantagem de tempo para migrar para o encaminhamento pelo lado do servidor. A Adobe recomenda que qualquer pessoa que tenha Audience Manager e Analytics O usa esse método de implementação.
Há um bocado de informação nesta página, e é tudo importante, é claro. No entanto, tudo se resume em duas coisas principais que você precisa fazer:
Se você ignorar qualquer uma dessas tarefas, o encaminhamento pelo lado do servidor não funcionará corretamente. Etapas e dados adicionais foram adicionados a este documento para ajudá-lo a executar essas duas etapas corretamente para sua configuração.
À medida que você migra do encaminhamento pelo lado do cliente para o do lado do servidor, uma das tarefas que você terá é alterar o código para o novo código de encaminhamento do lado do servidor. Isso é feito usando uma das seguintes opções:
doPlugins
função dentro do seu appMeasurement.js
arquivo, se você não estiver (ainda) usando o Adobe LaunchdoPlugins
, onde quer que o outro gerenciador de tags armazene a AppMeasurement códigoExaminaremos cada um desses itens abaixo no Atualização do código seção.
As etapas a seguir descrevem a implementação.
O principal pré-requisito para migrar para o encaminhamento pelo lado do servidor é ter o Serviço de ID de Experience Cloud implementado. Isso é feito com mais facilidade se você estiver usando o Experience Platform Launch, nesse caso, basta instalar a extensão ECID e ela fará o resto.
Se você estiver usando um TMS não-Adobe ou nenhum TMS, implemente o ECID para executar antes qualquer outra solução Adobe. Consulte a Documentação da ECID para obter mais detalhes. O único outro pré-requisito é relacionado às versões de código. Portanto, como você simplesmente aplica as versões mais recentes do código nas etapas a seguir, tudo ficará bem.
Leia todo este documento antes de implementar. A seção "Intervalos" abaixo contém informações importantes sobre quando você deve implementar cada parte, incluindo a ECID (se ainda não estiver implementada).
À medida que você se prepara para mudar do código de DIL do lado do cliente para o encaminhamento do lado do servidor, a primeira etapa é identificar tudo o que você está fazendo com o código de DIL, incluindo configurações personalizadas e dados enviados para o AAM. Os aspectos a serem observados e considerados incluem:
siteCatalyst.init
módulo DIL - Você não precisa se preocupar com este, porque seu trabalho é apenas enviar o normal Analytics sobre, e isso acontece em virtude de simplesmente ter o encaminhamento pelo lado do servidor ativado.DIL.create
faça uma anotação da partner
parâmetro. Isso é conhecido como "subdomínio do parceiro", ou, às vezes, "ID do parceiro", e será necessário ao inserir o novo código de encaminhamento do lado do servidor.Entrada Opções de implementação (acima), várias opções são fornecidas em relação a como e onde você está implementando o encaminhamento pelo lado do servidor. Para que essa seção seja eficaz, precisamos dividi-la nessas seções (com duas delas combinadas). Vá para o método desta seção que melhor descreve suas necessidades.
Assista ao vídeo abaixo para saber mais sobre como mover as opções de implementação do código de DIL do lado do cliente para o encaminhamento do lado do servidor no Experience Platform Launch.
Assista ao vídeo abaixo para saber mais sobre como mover as opções de implementação do código de DIL do lado do cliente para o encaminhamento do lado do servidor no AppMeasurement código, residente em um arquivo ou em um sistema de gerenciamento de tags não-Adobe.
Até agora, neste tutorial, gastamos todo o nosso tempo na alternância do código de DIL do lado do cliente para o encaminhamento do lado do servidor. Isso é bom, porque é a parte mais difícil. Esta seção, embora você queira vê-la como super fácil, é tão importante quanto atualizar o código. Neste vídeo, você verá como virar a chave que permite o encaminhamento real de dados do Analytics para o Audience Manager.
NOTA: Conforme mencionado no vídeo, lembre-se de que levará até 4 horas para que a ativação do encaminhamento seja totalmente implementada no back-end do Experience Cloud.
Como lembrete, há duas tarefas principais para migrar do DIL do lado do cliente para o encaminhamento do lado do servidor:
Mas a questão é, qual você faz primeiro? Isso importa? OK, desculpe, foram duas perguntas. Mas as respostas são… depende, e sim, depende pode matéria. Como isso é vago? Vamos analisar isso. Mas, primeiro, uma pergunta adicional que pode surgir se você for uma grande organização com vários sites: Eu preciso fazer tudo de uma vez? Aquela é um pouco mais fácil. Não. Você pode fazer isso peça por peça.
O motivo pelo qual o tempo e o pedido são importantes é por causa do encaminhamento realmente que podem ser resumidas nos seguintes fatos técnicos:
Com base nesses detalhes técnicos, veja as recomendações para o momento do que fazer e quando:
Ligue o interruptor Analytics para cada report suite que você ativará para o encaminhamento pelo lado do servidor.
Por site, atualize seu código do DIL do lado do cliente para o encaminhamento do lado do servidor (pode estar nas tags da Platform ) ou na página, conforme discutido em outra seção acima).
Prepare e planeje para estar pronto para atualizar seu código do DIL para o encaminhamento pelo lado do servidor PER report suite que você ativará para o encaminhamento pelo lado do servidor:
Ligue o interruptor Analytics para ativar o encaminhamento pelo lado do servidor.
Assim que possível, atualize seu código do DIL do lado do cliente para o encaminhamento de lado único (isso pode estar nas tags da Platform ou na página, conforme discutido em outra seção acima).
É importante fazer essas duas etapas o mais próximo possível uma da outra, pois, entre as etapas 1 e 2 acima, você terá a duplicação de dados que entram no AAM. Em outras palavras, o encaminhamento por um único lado terá começado a enviar dados do Analytics para AAM, e como o código DIL ainda está na página, também haverá um hit indo diretamente da página para o AAM, duplicando assim os dados. Assim que você atualizar o código do DIL para o encaminhamento do lado do servidor, isso será atenuado.
Se você preferir ter uma pequena discrepância nos dados, em vez de uma pequena duplicação de dados, é possível alternar a ordem das etapas 1 e 2 acima. Mover o código do encaminhamento do lado do servidor para o DIL interromperia o fluxo de dados no AAM até que você pudesse virar a chave para ativar o encaminhamento do lado do servidor para o report suite. Normalmente, os clientes prefeririam ter uma pequena duplicação de dados, em vez de perder a oportunidade de colocar os visitantes em características e segments.
Este tópico é brevemente abordado nas seções anteriores, na medida em que a estratégia principal pode ser resumida do seguinte modo:
Migrar um site/report suite (ou grupo de sites/report suites) de cada vez.
No entanto, isso pode ser complicado com base em alguns cenários possíveis:
Por causa desses itens, pode ficar um pouco complicado. As melhores coisas que posso sugerir são:
A forma principal de validar que o encaminhamento pelo lado do servidor está em execução é observar a resposta a qualquer uma das ocorrências do Adobe Analytics que vierem do aplicativo.
Se você não estiver fazendo o encaminhamento de dados pelo lado do servidor do Analytics para o Audience Manager, então não há realmente nenhuma resposta para o Analytics sinal (fora de um pixel com dimensões 2x2). No entanto, se estiver fazendo o encaminhamento pelo lado do servidor, há itens que você pode verificar no Analytics solicitação e resposta que informam que Analytics O está se comunicando corretamente com o Audience Manager, encaminhando a ocorrência e obtendo uma resposta.
Cuidado com o falso “Sucesso”. Se houver uma resposta e tudo parecer estar funcionando, verifique se você tem a stuff
objeto na resposta. Caso não tenha, você poderá ver uma mensagem que diz "status":"SUCCESS"
. Por mais louco que pareça, isso prova que NÃO está funcionando corretamente.
Se vir isso, significa que você concluiu a atualização de código nas tags da Platform ou AppMeasurement, mas que o encaminhamento no Analytics Admin Console ainda não foi concluído. Nesse caso, é necessário verificar se o encaminhamento pelo lado do servidor foi ativado na variável Analytics Admin Console para seu report suite. Se tiver ativado e ainda não tiver passado quatro horas, aguarde, pois pode demorar para fazer todas as alterações necessárias no back-end.
Para obter mais informações sobre o encaminhamento pelo lado do servidor, consulte o documentação.