Adicionar o Adobe Audience Manager

Esta lição guiará você pelas etapas para implementar o Adobe Audience Manager no SDK da Experience Platform Mobile usando o encaminhamento pelo lado do servidor.

O Adobe Audience Manager (AAM) fornece serviços líderes do setor para o gerenciamento online de dados de público-alvo, proporcionando aos anunciantes e editores as ferramentas necessárias para controlar e aproveitar seus ativos de dados e ajudar a aumentar o sucesso das vendas.

OBSERVAÇÃO

O Adobe Experience Platform Launch está sendo integrado à Adobe Experience Platform como um conjunto de tecnologias de coleção de dados. Várias alterações de terminologia foram implementadas na interface de que você deve estar ciente ao usar este conteúdo:

  • Agora o Platform launch (lado do cliente) é tags
  • O lado do servidor do Platform launch agora é event forwarding
  • As configurações de borda agora são datastreams

Objetivos de aprendizagem

No final desta lição, você poderá:

  1. Descrever as duas principais maneiras de implementar o Audience Manager em um aplicativo móvel
  2. Adicionar o Audience Manager usando o encaminhamento pelo lado do servidor do sinalizador do Analytics
  3. Validar a implementação do Audience Manager

Pré-requisitos

Para concluir esta lição, será necessário:

  1. Ter concluído as lições na seção Configurar tags, nomeadamente Criar uma propriedade de tag, Adicionar extensões, Criar uma biblioteca e Instalar o SDK do Mobile.

  2. Acesso de administrador ao Adobe Analytics para que você possa ativar o encaminhamento pelo lado do servidor para o conjunto de relatórios que estiver usando neste tutorial. Como alternativa, você pode solicitar que um administrador na sua organização faça isso seguindo as instruções abaixo.

Se ainda não tiver o Audience Manager implementado, siga estas instruções para obter seu Subdomínio do Audience Manager.

Opções de implementação

Há duas maneiras de implementar o Audience Manager em um aplicativo:

  • Encaminhamento pelo lado do servidor (Server-Side Forwarding, ou SSF) - Para clientes com o Adobe Analytics, esta é a maneira mais fácil e recomendada de implementar. O Adobe Analytics encaminha dados para o AAM no back-end da Adobe para que você não precise fazer solicitações por meio do aplicativo diretamente para o Audience Manager. Isso também permite acesso a importantes recursos de integração e está em conformidade com as práticas recomendadas para a implementação e implantação do código do Audience Manager.

  • DIL do cliente - Essa abordagem serve para clientes que não têm o Adobe Analytics. Os métodos do Audience Manager no aplicativo enviam dados diretamente para o Audience Manager. Nesse caso, você usaria a extensão Audience Manager em tags ao configurar sua propriedade de tag móvel.

Ao configurar a extensão do Analytics na seção Adicionar extensões deste tutorial, você marcou a caixa para iniciar o encaminhamento de dados pelo lado do servidor do Analytics para o Audience Manager. Isso inserirá dinamicamente o código necessário para lidar com a resposta dos segmentos do Audience Manager de volta ao aplicativo. Não adicionaremos a extensão do Audience Manager neste tutorial, pois, novamente, isso se aplica somente ao caso de uso de quando você NÃO tem o Adobe Analytics.

Ativar encaminhamento pelo lado do servidor

Há duas etapas principais para executar uma implementação do SSF:

  1. Ativar um "alternador" no Admin Console do Analytics para encaminhar dados do Analytics para o Audience Manager por conjunto de relatórios.
  2. Colocar o código do SDK em vigor, o que você fez por meio de tags simplesmente marcando a caixa na extensão do Analytics para encaminhar dados para o AAM.

Ativar o encaminhamento pelo lado do servidor no Admin Console do Analytics

Uma configuração no Admin Console do Adobe Analytics é necessária para iniciar o encaminhamento de dados do Adobe Analytics para o Adobe Audience Manager. Lembre-se de que o sistema pode levar até quatro horas para iniciar o encaminhamento dos dados, portanto, lembre-se disso ao tentar solucionar problemas de encaminhamento.

Para ativar o SSF no Admin Console do Analytics

  1. Faça logon no Analytics por meio da interface do usuário da Experience Cloud. Se você não tiver acesso de Administrador ao Analytics, precisará conversar com o administrador da Experience Cloud ou do Analytics para atribuir acesso ou concluir essas etapas para você.

    Faça logon na interface do usuário do Adobe Analytics

  2. Na navegação superior do Analytics, escolha Admin > Report Suites e, na lista, selecione (ou selecione várias vezes) os conjuntos de relatórios que deseja encaminhar para o Audience Manager.

    Clique em Admin Console

  3. Na tela Conjuntos de relatórios e com os conjuntos de relatórios selecionados, escolha Editar configurações > Geral > Encaminhamento pelo lado do servidor.

    Selecione o menu SSF

    AVISO

    Conforme dito acima, será necessário ter privilégios de administrador para ver este item de menu.

  4. Uma vez na página Encaminhamento pelo lado do servidor, leia as informações e marque a caixa para Ativar o Encaminhamento pelo lado do servidor para os conjuntos de relatórios.

  5. Clique em Salvar

    Completar configuração do SSF

OBSERVAÇÃO

Como o SSF precisa ser habilitado por conjunto de relatórios, não se esqueça de repetir essa etapa para seus conjuntos de relatórios reais quando você estiver implantando o SSF no conjunto de relatórios do aplicativo real.

Além disso, se a opção SSF estiver acinzentada, será necessário "mapear os conjuntos de relatórios para sua organização na Experience Cloud para ativar a opção. Isso é explicado na documentação.

Esse alternador iniciará o encaminhamento real de dados para o AAM se você tiver o Adobe Experience Platform Identity Service implementado. O restante da implementação do SSF ocorre no código, que foi manipulado em tags quando você marcou a caixa na extensão do Analytics para encaminhar para o AAM.

O código de encaminhamento pelo lado do servidor agora está implementado para seu aplicativo!

Validar o encaminhamento pelo lado do servidor

A principal maneira de validar se o encaminhamento pelo lado do servidor está ativo e em execução é verificar 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 (SSF) do Analytics para o Audience Manager, então não há resposta para o sinalizador do Analytics (fora um pixel com dimensões 2x2). No entanto, quando você ativa o SSF, há itens que você pode verificar na solicitação e resposta do Analytics que informam que o recurso está funcionando corretamente.

Como o console do Xcode não mostra a resposta aos sinalizadores, você deve usar outro depurador/sniffer de pacote que mostra a resposta como, por exemplo, o Charles Proxy (que é o que mostrarei na captura de tela abaixo).

  1. Abra o depurador e o filtro para b/ss, o que limitará o que você vê às solicitações do Adobe Analytics

  2. Crie e execute seu aplicativo de amostra dos exercícios anteriores

  3. Em qualquer solicitação do Analytics, verifique a resposta. Ela deve conter um parâmetro dcs_region, um parâmetro uuid e também deve ter um objeto "stuff". Esse objeto envia IDs de segmento do AAM de volta ao navegador (para quaisquer segmentos aos quais o usuário pertence, que são atribuídos no AAM a um destino de cookie). Se você tiver o objeto "stuff", o SSF está funcionando!

    Resposta AA - objeto stuff

AVISO

Cuidado com o falso "sucesso" - se houver uma resposta e tudo parece estar funcionando, certifique-se de que você tenha esse objeto "stuff". Caso não tenha, você poderá ver uma mensagem na resposta que diz "status": "SUCCESS". Por mais louco que isso pareça, isso é prova de que NÃO está funcionando corretamente. Caso veja isso, significa que você concluiu a etapa nas tags para encaminhar para o AAM, mas o encaminhamento no Analytics Admin Console ainda não foi concluído. Nesse caso, é necessário verificar se o SSF foi ativado no Admin Console do Analytics. Se tiver ativado e ainda não tiver passado quatro horas, aguarde.

Resposta AA - falso sucesso

Próximo: "Publique sua propriedade" >

Nesta página