Ativação do Adobe Analytics e do Adobe Target opting-into-adobe-analytics-and-adobe-target
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 e pronto para uso, como uma tarefa pré-carregada atribuída ao grupo de usuários administrador.
Quando você faz logon como administrador, esta tarefa (Configuração do Analytics e do Targeting) fica disponível na 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 arquivo
.properties
predefinido. -
Recusar a integração.
Considere esta opção se preferir configurar manualmente a integração. Consulte também Integração do AEM com o Adobe Target e o Adobe Analytics usando o DTM.
-
Configure a configuração e o provisionamento usando um script.
Configurar a integração configuring-the-integration
Aceitar a integração com:
- Analytics para permitir o uso de seus recursos de rastreamento e análise de página.
- Target para permitir o uso de seus recursos de personalização.
Para qualquer uma das opções, é necessário fornecer as informações da conta do usuário e especificar as páginas que são rastreadas.
Quando você opta pela integração, o AEM executa as seguintes tarefas:
- Cria as configurações de nuvem que habilitam a conexão com o Analytics e o Target.
- Cria as estruturas que determinam os dados rastreados.
- Configura as páginas da Web para usar esses serviços.
Para aceitar a tarefa pré-carregada e pronta para uso:
-
Na sua Caixa de entrada, selecione e Abra a tarefa Configurar Analytics e Targeting.
-
Para o Analytics:
- Insira as informações da conta de usuário do Analytics e clique no botão Adicionar correspondente.
- As credenciais apropriadas são autenticadas.
- Quando a conta do Analytics for autenticada, selecione o conjunto de relatórios do Analytics para usar. O AEM recupera esses conjuntos de relatórios do Analytics. O status é atualizado para Adicionado.
-
Para o Target:
- Insira as informações da conta de usuário do Target e clique no botão Adicionar correspondente.
- As credenciais apropriadas são autenticadas. O status é atualizado para Adicionado.
-
Selecione Próximo.
-
Selecione os sites para os quais o Analytics e/ou Target devem ser usados.
-
Selecione Concluído para concluir.
note caution CAUTION Depois de optar pela configuração, você precisará publicar o site/páginas afetadas para replicar essas alterações na instância de publicação.
Recusar a integração opting-out-of-the-integration
Recuse a integração com o Analytics e o Target ao:
-
Não quiser integrar a esses produtos.
-
Prefira 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, você precisa concluir a tarefa pré-carregada:
Como fornecer informações da conta usando um arquivo de propriedades providing-account-information-using-a-properties-file
Instale um arquivo de propriedades que o AEM lê na inicialização do servidor para configurar as propriedades da conta para integração com o Analytics e o Target. 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 que você salva no diretório de trabalho que o processo AEM está usando (normalmente o mesmo diretório do arquivo JAR). O arquivo inclui as seguintes propriedades:
- analytics.server: o URL do data center do Analytics que você usa.
- analytics.company: a empresa associada à conta de usuário do Analytics.
- analytics.username: seu nome de usuário do Analytics.
- analytics.secret: o segredo associado ao nome de usuário do Analytics.
- analytics.reportsuite: o nome do conjunto de relatórios do Analytics que será usado.
- target.clientcode: o código de cliente associado à sua conta do Target.
- target.email: o endereço de email que você usa para autenticar sua conta do Target.
- target.password: a senha associada ao seu endereço de email.
As propriedades e os valores são separados por sinais de igual (=). 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 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 a criação de uma configuração em nuvem do 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 aderir à integração usando o arquivo de propriedades.
-
Crie o arquivo
marketingcloud.properties
no diretório de trabalho que o processo AEM está usando (instância do autor).note note NOTE O diretório de trabalho geralmente é o diretório que contém o jar ou o arquivo license.properties
.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 do Target.
-
Inicie ou reinicie o servidor e faça logon usando uma conta de administrador.
-
Abra a tarefa Configurar Analytics e Targeting conforme descrito em Configurando a Integração. Em vez de solicitar as informações da sua conta, o assistente usa os valores do arquivo
.properties
.Selecione Adicionar para o serviço apropriado e continue com o assistente.
Sobre as configurações em nuvem about-the-cloud-configurations
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 provisionada do Analytics.
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 de Destino.)
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.all
.Configuração e provisionamento via script configuring-the-setup-and-provisioning-via-script
Como administrador, talvez você queira acionar a configuração e o provisionamento com um script em vez de executar manualmente a etapa do assistente. Você pode fazer isso ao:
- Enviando uma solicitação POST para /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json com os parâmetros necessários.
Os parâmetros enviados dependem do seguinte:
-
Se você quiser usar o arquivo marketingcloud.properties preenchido com todas as credenciais necessárias, deverá enviar 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 criadas
Por exemplo, uma solicitação de ondulação que cria configurações do Analytics e do Target e as anexa à página we.retail seria:
code language-shell 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, envie as credenciais e os parâmetros. Por exemplo:
- automaticProvisioning=
true
- servicename=
analytics|target
- path=path para uma página do AEM para anexar as configurações dos serviços de nuvem criados; vários caminhos podem ser definidos
- analytics.server=
https://servername
- analytics.company=
Name of company
- analytics.username=
me
- analytics.secret=
secret
- analytics.reportsuite=
we-retail
- target.clientcode=
mycompany
- target.email=
me@adobe.com
- target.password=
password
Nesse caso, a solicitação de ondulação que cria as configurações do Analytics e do Target e as anexa à página de we-retail seria:
code language-shell 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
- automaticProvisioning=