Show Menu
TÓPICOS×

Adicionar o Adobe Analytics ao seu aplicativo móvel

A Adobe recomenda usar o Editor SPA para projetos que exigem renderização do lado do cliente baseada em estrutura de aplicativo de página única (por exemplo, Reagir). Saiba mais .
Deseja criar experiências envolventes e relevantes para seus usuários de aplicativos móveis? Se você não estiver usando o SDK do Adobe Mobile Services para monitorar e medir o ciclo de vida e o uso do aplicativo, então em que você baseia suas decisões? Onde estão seus clientes mais leais? Como você pode garantir que está se mantendo relevante e otimizando as conversões?
Seus usuários estão acessando todo o conteúdo? Eles estão abandonando o aplicativo e, em caso afirmativo, onde? Com que frequência eles ficam no aplicativo e com que frequência voltam para usar o aplicativo? Que mudanças você pode introduzir e medir que aumentam a retenção? E quanto às taxas de falhas, seu aplicativo trava para seus usuários?
Tire proveito do Mobile App Analytics em seus aplicativos AEM por meio da integração com o Adobe Mobile Services .
Instrua seus aplicativos AEM a rastrear, relatar e entender como os usuários se envolvem com seu aplicativo móvel e conteúdo e a medir as principais medições de ciclo de vida, como inicializações, tempo no aplicativo e taxa de falhas.
Esta seção descreve como os desenvolvedores do AEM podem:
  • Integrar o Mobile Analytics ao seu aplicativo móvel
  • Teste o rastreamento de análises com o Bloodhound

Pré-requisitos

O AEM Mobile requer uma conta do Adobe Analytics para coletar e relatar dados de rastreamento no aplicativo. Como parte da configuração, o administrador do AEM precisará:
  • Configure uma conta do Adobe Analytics e crie um conjunto de relatórios para seu aplicativo no Mobile Services.
  • Configure um serviço da AMS Cloud no Adobe Experience Manager (AEM).

Para desenvolvedores - Integrar o Mobile Analytics ao seu aplicativo

Configurar o ContentSync para obter o arquivo de configuração

Após a configuração da conta do Analytics, será necessário criar uma configuração de Sincronização de conteúdo para inserir o conteúdo no aplicativo móvel.
Para obter detalhes adicionais, consulte Configuração do conteúdo de sincronização. A configuração precisará instruir a Sincronização de conteúdo para colocar ADBMobileConfig no diretório /www. Por exemplo, no aplicativo Geometrixx Outdoors, a configuração de Sincronização de conteúdo está localizada em: /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig . Há também uma configuração para desenvolvimento. no entanto, é idêntico à configuração de não desenvolvimento no caso do Geometrixx Outdoors.
Para obter mais detalhes sobre como baixar o ADBMobileConfig do painel Aplicativos AEM do aplicativo móvel, consulte Arquivo de configuração do Analytics - Mobile Services - Adobe Mobile Services SDK.
<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    extension="json"
    path="../../../.." 
    selector="ADBMobileConfig"
    targetRootDirectory="www"
    type="mobileADBMobileConfigJSON"/>

Cada plataforma requer que o ADBMobileConfig seja copiado para um local específico.
Se estiver criando com a CLI do PhoneGap, isso pode ser feito com scripts de gancho de construção do cordova. Isso pode ser visto no aplicativo Geometrixx Outdoors em: content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js.
Para iOS, o arquivo precisará ser copiado para o diretório Recursos do projeto XCode (por exemplo, "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Se o aplicativo for direcionado para Android, o caminho para copiar será "platforms/android/assets/ADBMobileConfig.json". Para obter mais detalhes sobre como usar ganchos durante a compilação da CLI do PhoneGap, consulte Três ganchos necessários para o projeto do Cordova/PhoneGap.
///////////////////////////
//          iOS
///////////////////////////
    ios : [
        {
            "www/ADBMobileConfig.json": "platforms/ios/<YOUR_APP_NAME>/Resources/ADBMobileConfig.json"
        }
    ],
///////////////////////////
//          ANDROID
///////////////////////////
    android: [
        {
            "www/ADBMobileConfig.json": "platforms/android/assets/ADBMobileConfig.json"
        }
    ]

Adicionar o plug-in AMS no aplicativo

Para que o aplicativo colete os dados, o plug-in Adobe Mobile Services (AMS) precisa ser incluído como parte do aplicativo. Ao incluir o plug-in como um recurso no config.xml do aplicativo, outro gancho do Cordova pode ser usado para adicionar automaticamente o plug-in durante o processo de criação do PhoneGap.
<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

O aplicativo Geometrixx Outdoors config.xml está localizado em /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml . O exemplo acima solicita uma versão específica do plug-in a ser usado adicionando um '#' e um valor de tag após o URL do plug-in. Esta é uma boa prática a ser seguida para garantir que problemas não previstos não apareçam devido à adição de plug-ins não testados durante uma compilação.
Após executar essas etapas, seu aplicativo será habilitado a relatar todas as medições de ciclo de vida fornecidas pelo Adobe Analytics. Isso inclui dados como inicializações, falhas e instalações. Se esses são os únicos dados com os quais você se importa então você está pronto. Se você quiser coletar dados personalizados, será necessário instrumentar seu código.

Instrumento seu código para o rastreamento completo do aplicativo

Há várias APIs de rastreamento fornecidas na API de plug-in do Phonegap do AMS.
Isso permitirá que você rastreie estados e ações, como para onde os usuários estão navegando no aplicativo, quais controles estão sendo mais usados. A maneira mais fácil de instruir seu aplicativo para rastreamento é usar as APIs do Analytics fornecidas pelo plug-in do AMS.
  • ADB.trackState()
  • ADB.trackAction()
Para referência, você pode observar o código no aplicativo Geometrixx Outdoors. No aplicativo Geometrixx Outdoors, todas as navegações de página são rastreadas usando o método ADB.trackState(). Para obter mais detalhes, consulte o código fonte para /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js
Ao instrumentar seu código fonte com essas chamadas de método, você pode coletar métricas completas em relação ao seu aplicativo.

Teste do rastreamento do Analytics com o Bloodhound

Opcionalmente, antes de implantar na produção, você pode usar a ferramenta Adobe Bloodhound para testar a configuração do Analytics. Para testar a configuração do Analytics, é necessário editar o arquivo ADBMobileConfig.json para apontar para o servidor em que o Bloodhound está sendo executado em vez do servidor real do Analytics. Para fazer essa alteração, a partir de ADBMobileConfig.json altere a seguinte entrada.
...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

Alteração para corresponder a esta entrada:
...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

Isso redirecionará todos os dados coletados pelo plug-in do AMS para o Bloodhound para que você possa visualizar os resultados.

Propriedades para conexão com o AMS

com.adobe.cq.mobile.mobileservices.impl.service. MobileServicesHttpClientImpl expõe as seguintes propriedades para conexão com o AMS:
Etiqueta
Descrição
Padrão
Ponto de extremidade da API
O URL básico das APIs HTTP do Adobe Mobile Services
https://api.omniture.com
Endpoint de configuração
O URL usado para recuperar a configuração do ADB Mobile para a ID de conjunto de relatórios fornecida
/ams/1.0/app/config/
Aplicativos do Mobile Service
Obter uma lista de aplicativos dentro da empresa de usuários
/ams/1.0/apps