Adicionar o Adobe Analytics ao seu aplicativo móvel

Observação

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, integrando-se ao 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, além de 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:

  • Integre 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 da Adobe Analytics para coletar e relatar dados de rastreamento no aplicativo. Como parte da configuração, o administrador do AEM precisa primeiro:

  • Configure uma conta da Adobe Analytics e crie um conjunto de relatórios para seu aplicativo no Mobile Services.
  • Configure um Cloud Service do AMS no Adobe Experience Manager (AEM).

Para desenvolvedores - Integre o Mobile Analytics ao seu aplicativo

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

Depois que a conta Analytics for configurada, 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 o 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 seu painel de aplicativos AEM para aplicativos móveis, consulte o arquivo de configuração 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 o 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áriospara 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, em seguida, 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 pela 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 da 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.

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 na empresa dos usuários /ams/1.0/apps

Nesta página