O AEM tem um procedimento de aceitação para ajudar você a se integrar ao Adobe Analytics e ao Adobe Target. Isso está disponível imediatamente, como uma tarefa pré-carregada atribuída ao grupo de usuários do administrador.
Ao efetuar logon como administrador, esta tarefa (Configuração do Analytics & Targeting) está disponível no Caixa de entrada. Com base nas credenciais fornecidas, ele ajuda a configurar e integrar esses serviços.
Você tem as seguintes opções para configurar a integração:
Configure a integração por meio da tarefa .
Isso pode ser feito imediatamente ou posteriormente, a tarefa permanecerá na Caixa de entrada até que alguma ação seja tomada. Em ambos os casos, a configuração pode ser feita diretamente na interface do usuário ou com o uso de um .properties
arquivo.
Rejeite a integração.
Considere esta opção se preferir configurar manualmente a integração. Consulte também Integração de AEM com o Adobe Target e o Adobe Analytics usando o DTM.
Configure a configuração e o provisionamento usando um script.
Opte pela integração com:
Para qualquer opção, você precisa fornecer as informações da conta de usuário e especificar as páginas que são rastreadas.
Opcionalmente, é possível fornecer informações de conta do Analytics e do Target usando um arquivo de propriedades lido na inicialização do servidor. Consulte Fornecendo informações da conta usando um arquivo de propriedades.
Quando você opta pela integração, o AEM executa as seguintes tarefas:
AT.js é a biblioteca de clientes padrão. Isso é configurado em configuração dos serviços em nuvem do target.
O Adobe recomenda usar a AT.js como a biblioteca do cliente.
Para aceitar a tarefa pré-carregada e pronta para uso:
Em seu Caixa de entrada, selecione e Abrir Configurar o Analytics & Targeting tarefa.
Para o Analytics:
Para o Target:
Selecione Próximo.
Selecione os sites para os quais o Analytics e/ou Target deve ser usado.
Selecionar Concluído para concluir.
Depois de optar pela configuração, é necessário publicar o site/as páginas afetadas para replicar essas alterações na instância de publicação.
Rejeite a integração com o Analytics e o Target quando:
Não quiser integrar com esses produtos.
Prefere configurar as integrações manualmente.
Para obter informações sobre como configurar as integrações manualmente, consulte Integração com o Adobe Analytics e Integração com o Adobe Target.
Para recusar, é necessário concluir a tarefa pré-carregada:
Instale um arquivo de propriedades que AEM a leitura na inicialização do servidor para configurar as propriedades da conta para a integração com o Analytics e o Target. Ao usar o arquivo de propriedades, o assistente de aceitação usa automaticamente as propriedades do arquivo e a configuração da nuvem é criada adequadamente.
O arquivo de propriedades é um arquivo de texto chamado marketingcloud.properties que você salva no diretório de trabalho que o processo de AEM está usando (normalmente o mesmo diretório que o arquivo JAR). O arquivo inclui as seguintes propriedades:
Propriedades e valores são separados por sinais iguais (=). As propriedades do Analytics recebem o prefixo analytics
e as propriedades do Target recebem o prefixo target
. Para configurar um serviço, forneça valores para todas as propriedades desse serviço. Se não quiser configurar um serviço, não forneça valores para esse serviço.
O exemplo a seguir .properties
O arquivo inclui os valores de propriedade para criar uma configuração de nuvem para o Analytics:
analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=
O procedimento a seguir descreve como aceitar a integração usando o arquivo de propriedades.
Crie o marketingcloud.properties
no diretório de trabalho que o processo de AEM está usando (instância do autor).
O diretório de trabalho geralmente é o diretório que contém o jar ou license.properties
arquivo.
No entanto, também pode ser definido como um caminho absoluto pela propriedade do sistema:
mac.provisioning.file.container
Adicione os valores da propriedade de acordo com suas contas do Analytics e/ou Target.
Inicie ou reinicie o servidor e faça logon usando uma conta de administrador.
Abra a tarefa Configurar Analytics & Targeting , conforme descrito em Configurar a integração. Em vez de solicitar informações de sua conta, o assistente usa os valores da variável .properties
arquivo.
Selecionar Adicionar para o serviço adequado, continue com o assistente.
Ao configurar a integração com o Analytics e o Target, o AEM cria automaticamente as configurações e estruturas de nuvem necessárias. Por exemplo, a configuração de nuvem do Analytics é chamada de Conta do Analytics provisionada.
Não é necessário alterar as configurações de nuvem. No entanto, você pode configurar as estruturas conforme necessário. (Consulte Mapeamento de dados do componente com propriedades do Adobe Analytics e Adicionar uma estrutura do Target.)
Por padrão, quando você opta pelo assistente de configuração do Adobe Target, o Direcionamento preciso é ativado.
Direcionamento preciso significa que a configuração do Cloud Service aguarda o contexto ser carregado antes de carregar o conteúdo. Como resultado, em termos de desempenho, o direcionamento preciso pode criar um atraso de alguns milissegundos antes de carregar o conteúdo.
O direcionamento preciso é sempre ativado na instância do autor. No entanto, na instância de publicação, é possível desativar o direcionamento preciso globalmente, limpando a marca de seleção ao lado de Direcionamento preciso na configuração do Cloud Service (http://localhost:4502/etc/cloudservices.html). Você também pode ativar e desativar o direcionamento preciso para componentes individuais, independentemente das suas definições na configuração do Cloud Service.
Se você já tiver criado componentes direcionados e alterar essa configuração, suas alterações não afetarão esses componentes. Você deve alterar esses componentes diretamente.
Ao aderir à configuração do Analytics e a um reportsuite
for selecionada, a estrutura será restrita ao modo de execução de publicação. Isso significa que o rastreamento só funciona na instância de publicação.
Se o rastreamento for necessário em uma instância de criação, também o valor deverá ser alterado para all
.
Como administrador, talvez você queira acionar a configuração e o provisionamento com um script em vez de passar manualmente pelo assistente. Você pode fazer isso:
Os parâmetros enviados dependem do seguinte:
Se quiser usar a variável marketingcloud.properties arquivo preenchido com todas as credenciais necessárias, você deve enviar os seguintes parâmetros:
automaticProvisioning
= true
servicename
= analytics|target
path
=path para uma página AEM para anexar as configurações dos serviços em nuvem criadosPor exemplo, uma solicitação de ondulação que cria configurações do Analytics e do Target e as anexa à página we.retail seria:
curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
Se não quiser usar a variável marketingcloud.properties em seguida, você terá que enviar as credenciais, bem como os parâmetros; por exemplo:
true
analytics|target
https://servername
Name of company
me
secret
we-retail
mycompany
me@adobe.com
password
Nesse caso, a solicitação curl que cria configurações do Analytics e do Target e as anexa à página de web-retail seria:
curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json