AEM tem um procedimento de aceitação para ajudá-lo a se integrar com a Adobe Analytics e a Adobe Target. Isso está disponível prontamente, como uma tarefa pré-carregada atribuída ao grupo de usuários do administrador.
Quando você faz logon como administrador, essa tarefa (Configuração do Analytics & Targeting) está disponível na Caixa de entrada. Com base nas credenciais fornecidas, isso 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 depois, 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 arquivo .properties
predefinido.
Opt out da integração.
Considere esta opção se preferir configurar manualmente a integração. Consulte também Integração de AEM com Adobe Target e Adobe Analytics usando o DTM.
Configure a configuração e o provisionamento usando um script.
Opte pela integração com:
Para ambas as opções, é necessário fornecer as informações da conta de usuário e especificar as páginas que são rastreadas.
Como opção, você pode fornecer informações de conta do Analytics e do Público alvo usando um arquivo de propriedades lido na inicialização do servidor. Consulte Fornecendo informações de conta usando um arquivo de propriedades.
Ao participar da integração, AEM executa as seguintes tarefas:
AT.js é a biblioteca de cliente padrão. Isso é configurado em configuração de serviços de nuvem de público alvo.
O Adobe recomenda usar o AT.js como a biblioteca do cliente.
Para aceitar a tarefa pré-carregada e pronta para uso:
Na caixa de entrada, selecione e Abra a tarefa Configurar o Analytics e a definição de metas](/docs/experience-manager-64/sites-authoring/inbox.html?lang=pt-BR#taking-action-on-an-item).[
Para o Analytics:
Para o Público alvo:
Selecione Próximo.
Selecione os sites para os quais o Analytics e/ou o Público alvo devem ser usados.
Selecione Concluído para concluir.
Depois de optar pela configuração, é necessário publicar o site ou as páginas afetadas para replicar essas alterações na instância de publicação.
Opt out a integração com o Analytics e o Público alvo quando você:
Não queira se integrar a esses produtos.
Preferir 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 opt out, é 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 Público alvo. Quando você usa o arquivo de propriedades, o assistente de aceitação usa automaticamente as propriedades do arquivo e a configuração da nuvem é criada de acordo.
O arquivo de propriedades é um arquivo de texto chamado marketingcloud.properties salvo no diretório de trabalho que o processo de AEM está usando (normalmente o mesmo diretório do arquivo JAR). O arquivo inclui as seguintes propriedades:
As propriedades e os valores são separados por sinais iguais (=). As propriedades do Analytics recebem o prefixo analytics
e as propriedades do Público alvo recebem o prefixo target
. Para configurar um serviço, forneça valores para todas as propriedades desse serviço. Se você não quiser configurar um serviço, não forneça valores para esse serviço.
O arquivo de exemplo .properties
a seguir 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 participar da integração usando o arquivo de propriedades.
Crie o arquivo marketingcloud.properties
no diretório de trabalho que o processo de AEM está usando (instância do autor).
Normalmente, o diretório de trabalho é o diretório que contém o arquivo jar ou license.properties
.
No entanto, também pode ser definido como um caminho absoluto pela propriedade do sistema:
mac.provisioning.file.container
Adicione os valores de propriedade de acordo com suas contas do Analytics e/ou Públicos alvos.
Start ou reinicie o servidor e faça logon usando uma conta de administrador.
Abra a tarefa Configurar análise e definição de metas conforme descrito em Configuração da integração. Em vez de solicitar suas informações de conta, o assistente usa os valores do arquivo .properties
.
Selecione Adicionar para o serviço apropriado e continue com o assistente.
Quando você configura a integração com o Analytics e o Público alvo, 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 de componentes com as propriedades do Adobe Analytics e Adicionar uma estrutura de Públicos alvos.)
Por padrão, ao optar pelo assistente de configuração do Adobe Target, a Definição de metas precisa está ativada.
Direcionamento preciso significa que a configuração do serviço de nuvem aguarda o contexto ser carregado antes de carregar o conteúdo. Como resultado, em termos de desempenho, o direcionamento preciso pode criar alguns milissegundos de atraso antes de carregar o conteúdo.
A definição de metas precisa está sempre ativada na instância do autor. Entretanto, na instância de publicação, você pode optar por desativar a definição de metas precisa globalmente, apagando a marca de seleção ao lado da Definição de metas precisa na configuração do serviço de nuvem (http://localhost:4502/etc/cloudservices.html). Você também pode ativar e desativar a definição de metas precisa para componentes individuais, independentemente de sua configuração na configuração do serviço de nuvem.
Se você já criou componentes direcionados e alterar essa configuração, suas alterações não afetarão esses componentes. É necessário fazer alterações diretamente nesses componentes.
Quando você opta pela configuração do Analytics e um reportsuite
específico é selecionado, a estrutura é 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:
Quais parâmetros você envia dependem do seguinte:
Se quiser usar o arquivo marketingcloud.properties preenchido com todas as credenciais necessárias, envie os seguintes parâmetros:
automaticProvisioning
= true
servicename
= analytics|target
path
=caminho 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 Público alvo 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 você não quiser usar o arquivo marketingcloud.properties, 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 de ondulação que cria as configurações do Analytics e do Público alvo e as anexa à página de varejo virtual 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