Instalar o SDK do Adobe Experience Platform Mobile

Nesta lição, você implementará o SDK móvel com as extensões e configurações correspondentes ao ambiente de desenvolvimento da propriedade de tag.

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

Pré-requisitos

Nesta lição, começaremos a adicionar o código ao aplicativo Bus Booking, caso ainda não o tenha feito:

  1. Baixe e instale o Android™ Studio
  2. Baixe o aplicativo Bus Booking

Objetivos de aprendizagem

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

  • Obter as instruções de instalação para sua propriedade de tag móvel
  • Entender a diferença entre um ambiente de desenvolvimento, de armazenamento temporário e de produção
  • Atualize seu arquivo build.gradle para adicionar o Mobile SDK
  • Importe o Mobile SDK para seu aplicativo
  • Verificar se o SDK foi implementado com êxito
  • Ativar Medições de ciclo de vida no aplicativo

Obter as instruções de instalação

As Instruções de instalação para propriedades de tags móveis são uma coleção de trechos de código adicionados a locais específicos no aplicativo móvel.

Clique na guia Environments no começo da navegação para ir à página de ambientes. Observe que os ambientes de desenvolvimento, preparo e produção foram criados previamente para você. Esses correspondem aos ambientes típicos no processo de desenvolvimento e lançamento de código. O código é escrito pela primeira vez por um desenvolvedor em um ambiente de desenvolvimento. Quando eles concluem o trabalho, eles o enviam para um ambiente de preparo para que o controle de qualidade e outras equipes analisem. Depois que o controle de qualidade e outras equipes estão satisfeitas, o código é publicado no ambiente de produção, que é o ambiente voltado para o público, é o que seus visitantes experimentam quando baixam o seu aplicativo.

As tags permitem ambientes de desenvolvimento adicionais, que são úteis em grandes organizações nas quais vários desenvolvedores estão trabalhando em projetos diferentes ao mesmo tempo.

Desenvolvimento, preparo e produção são os únicos ambientes necessários para concluir o tutorial.

Clique em Ambientes no começo da navegação

Na linha Desenvolvimento, clique no ícone Instalar ícone para abrir a modal do código incorporado.

Clique no ícone para abrir a modal do código

Vamos conferir as instruções passo a passo.

Atualizar o arquivo build.gradle

Se você já tiver usado as propriedades das tags em sites, uma das primeiras coisas que observará é que há muito mais instruções de instalação para aplicativos móveis do que para sites.

O Mobile SDK da Adobe para Android usa o Gradle para gerenciar dependências entre seus vários componentes. Uma das primeiras coisas que faremos é adicionar as dependências do Mobile SDK da Adobe ao arquivo build.gradle do aplicativo Bus Booking.

Para atualizar o arquivo build.gradle

  1. Abra o Android™ Studio

  2. Selecione "Abrir um projeto Android™ Studio existente"

    Selecione "Abrir um projeto Android™ Studio existente"

  3. Abra o arquivo build.gradle na raiz da pasta Bus Booking Android™:

    Abra o arquivo build.gradle na raiz da pasta Bus Booking Android™

  4. Abrir a lista suspensa e alternar para a exibição Projeto

    Selecione "Projeto" na lista suspensa

  5. Abra o Android > bus > arquivo build.gradle

    Abra Android > bus > build.gradle

  6. Na interface da Coleta de dados, verifique se o sistema operacional está definido como Android

  7. Copie as dependências na área de transferência clicando no ícone Copiar

    Copie as dependências para a área de transferência na interface da Coleta de dados

  8. No Android™ Studio, cole as dependências da área de transferência logo em seguida das dependências existentes (mas antes de fechar })

  9. Clique no link "Sincronizar agora" para sincronizar o projeto

    Colar dependências no build.gradle

Atualizar o aplicativo

Agora é hora de atualizar o aplicativo para importar o SDK

Para importar o SDK

  1. Abra o arquivo Aplicativo principal no aplicativo Bus Booking, que está localizado em Android > bus > src > main > java > com.adobe.busbooking > DemoApplication

    Abrir DemoApplication

  2. Na interface da Coleta de dados, role até a seção Adicionar código de inicialização.

  3. Copie as instruções de importação clicando no primeiro ícone Copiar da seção Adicionar código de inicialização:

    Copiar as instruções de importação para a área de transferência

  4. No Android™ Studio, cole essas instruções de importação antes de as importações existentes no arquivo DemoApplication. Observe que a extensão Core inclui bibliotecas para oferecer suporte a retornos de chamada, ao serviço de identidade, às medições de ciclo de vida e ao registro do console, entre outros recursos

    Cole as instruções de importação no arquivo DemoApplication

  5. Na interface da Coleta de dados, copie as duas linhas relacionadas à extensão principal clicando no segundo ícone Copiar na seção Adicionar código de inicialização. A segunda linha ativa as instruções de registro do console (as opções disponíveis são "DEBUG", "VERBOSE", "WARNING" e "ERROR")

    Copie as instruções Core na área de transferência

  6. No Android™ Studio, cole essas instruções principais no arquivo DemoApplication logo após super.onCreate()

  7. Remova os comentários // antes das linhas try e catch

    Cole as instruções Core no arquivo DemoApplication

  8. Na interface da Coleta de dados, copie as declarações de extensão clicando no terceiro ícone Copiar na seção Adicionar código de inicialização.

    Copie as declarações de extensão para a área de transferência

  9. No Android™ Studio, cole essas instruções de extensão na seção try . Observe que MobileCore.configureWithAppID contém o identificador do ambiente de desenvolvimento de tags da propriedade. Isso é importante, pois você precisará atualizar esse valor quando estivermos prontos para implantar o aplicativo no ambiente de produção

    Cole as instruções de extensão no arquivo DemoApplication

OBSERVAÇÃO

As Instruções de instalação em dispositivos móveis fornecidas na interface da Coleta de dados incluem as instruções de importação e registro para as extensões Identity, Lifecycle e Signal, bem como a inicialização das Medições de ciclo de vida. Essas extensões são consideradas parte da extensão Mobile Core. Se não quiser usar essas extensões no aplicativo, não precisará importar, registrar ou implementar outro código associado a elas.

Além disso, há opções adicionais de implementação que devem ser consideradas ao usar essas extensões (por exemplo, você pode pausar/reiniciar a coleta do Lifecycle quando o usuário colocar o aplicativo em segundo ou primeiro plano). Você pode ler mais sobre isso na documentação da extensão principal para dispositivos móveis

Verifique a implementação

  1. Salve seu projeto do Android™ Studio

  2. Execute o aplicativo e inicie-o no Emulador. Se não tiver nenhum dispositivo emulador configurado, configure um agora, certificando-se de configurar um dispositivo que execute o Android 4.1 (API 16) ou posterior

    Execute o aplicativo e inicie-o no emulador

  3. Aguarde o Emulador iniciar e abra totalmente o aplicativo na tela de reserva (isso pode levar alguns minutos)

    Aguarde até que o aplicativo seja totalmente aberto

  4. Confirme se as chamadas estão sendo feitas aos servidores do Adobe no Android™ Studio Logcat

    Aguarde até que o aplicativo seja totalmente aberto

Estes são exemplos de algumas chamadas específicas que você pode procurar:

  1. Chamadas para recuperar a configuração das tags (filtre Logcat para adobedtm.com). Observe as configurações de extensão inseridas na lição anterior. Embora a adição da extensão exija uma atualização do aplicativo, essas configurações podem ser gerenciadas externamente em tags e alteradas a qualquer momento:

    03-14 16:30:29.484 24869-24930/com.adobe.busbooking D/ADBMobile: ConfigurationExtension - Cached configuration loaded.
     {"target.propertyToken":"","target.timeout":5,"global.privacy":"optedin","analytics.backdatePreviousSessionInfo":true,"analytics.offlineEnabled":true,"build.environment":"dev","rules.url":"https://assets.adobedtm.com/launch-EN360aefc739b04410816f751a95861744-development-rules.zip","experienceCloud.org":"7ABB3E6A5A7491460A495D61@AdobeOrg","target.clientCode":"techmarketingdemos","target.autoFetch":true,"target.fetchBackground":false,"lifecycle.sessionTimeout":300,"target.environmentId":"busbookingapp","analytics.server":"tmd.sc.omtrdc.net","analytics.rsids":"tmd-mobile-dev1","analytics.batchLimit":0,"property.id":"PRb4881271498b4f2cbaf67d38a8f3891a","global.ssl":true,"analytics.aamForwardingEnabled":true}
    
  2. Solicitação ao Identity Service (filtre o Logcat usando IdentityExtension) Neste exemplo, a ID (d_mid) já foi definida e está sendo enviada para relatórios novamente)

    03-14 17:01:18.526 7743-7803/com.adobe.busbooking D/ADBMobile: IdentityExtension - Sending request (https://dpm.demdex.net/id?d_mid=59651426340521082405908216148091920022&d_ver=2&d_orgid=7ABB3E6A5A7491460A495D61%40AdobeOrg)
    
  3. Solicitação do Analytics (filtrar Logcat para AnalyticsExtension)

    03-14 17:01:18.509 7743-7777/com.adobe.busbooking D/ADBMobile: AnalyticsExtension - Sending Analytics ID call (https://tmd.sc.omtrdc.net/id?mcorgid=7ABB3E6A5A7491460A495D61%40AdobeOrg&mid=59651426340521082405908216148091920022)
    

Parabéns, você adicionou o SDK a um aplicativo móvel!

Ativar Medições de ciclo de vida no aplicativo

As métricas do Lifecycle são métricas e dimensões baseadas no ambiente que podem ser facilmente ativadas em um aplicativo usando o SDK móvel da Experience Platform. Como elas podem ser usadas por várias soluções da Experience Cloud, nós as ativaremos aqui, antes de irmos mais a fundo nas soluções individuais. Basta adicionar algumas linhas de código ao nosso aplicativo no lugar certo.

Importar a biblioteca principal para o arquivo BusBooksActivity

Para fazer chamadas de API por meio do Mobile SDK da Adobe Experience Platform, é necessário importar as bibliotecas para os arquivos apropriados. Nesse caso, para utilizar a chamada da API Lifecycle, precisamos importar a biblioteca Core.

  1. Com seu aplicativo aberto no Android™ Studio, abra o arquivo BusBooksActivity, que está no mesmo diretório do arquivo DemoApplication no qual você está trabalhando.
  2. Na parte superior do arquivo, adicione a seguinte instrução de importação do MobileCore para poder usar as chamadas de API associadas
    import com.adobe.marketing.mobile.MobileCore;

Importar a biblioteca principal móvel

Adicione o código de ciclo de vida

Agora, você adicionará o código do Lifecycle à função principal onResume() no aplicativo para acionar as funções do Lifecycle.

  1. Abra o arquivo BusBooksActivity

  2. Role para baixo perto da parte inferior do arquivo e localize a função onResume()

  3. Adicione as duas linhas de código a seguir abaixo da linha super.onResume():

     MobileCore.setApplication(getApplication());
     MobileCore.lifecycleStart(null);
    

Inserir código de ciclo de vida

Validar a ocorrência do ciclo de vida

Ao executar seu aplicativo, agora você deve obter uma ou mais mensagens do Lifecycle na seção de depuração do Android™ Studio.

  1. Execute uma criação e selecione um simulador para executar o aplicativo
  2. Depois que o simulador estiver funcionando, clique na seção "Executar" do depurador no Android™ Studio
  3. Fazer uma pesquisa para internalaction=Lifecycle
  4. Verifique se há linhas que incluem esse par de chave/valor, bem como outras medições do Lifecycle

Observe que as linhas que você verá são chamadas do Analytics com métricas do Lifecycle.

Validar o Lifecycle

Próximo "Adicionar o Serviço de identidade da Adobe Experience Platform" >

Nesta página