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

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
  • Criar e editar o Podfile
  • Importar o SDK do Mobile para o arquivo AppDelegate
  • Verificar se o SDK foi implementado com êxito

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 que você executa no terminal ou adiciona 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.

Crie o Podfile e instale os pods

Se você já tiver usado as propriedades das tags em sites, uma das primeiras coisas que observará é que há muito mais informações nesse modal do que nas propriedades da Web.

O SDK do Adobe Mobile para iOS usa o CocoaPods para gerenciar dependências entre seus vários componentes. Se você ainda não tiver o CocoaPods instalado em seu ambiente de desenvolvimento, siga as instruções de instalação em seu site. Além disso, se você ainda não tiver baixado o aplicativo Bus Booking, salve-o no computador local e extraia o arquivo zip no desktop.

Para criar o Podfile

  1. Abra o aplicativo Terminal no Mac®

  2. Navegue até a pasta do projeto na qual você salvou o aplicativo Bus Booking, programado em Objetive-C (por exemplo, cd Desktop/busbooking-mobileapps-master/Objective-C/)

    Navegue até o diretório do projeto

  3. Na interface da Coleta de dados, altere o sistema operacional para iOS

  4. Copie a primeira instrução pod init do iOS, clicando no ícone Copiar

    Copie a pod init para a área de transferência na interface da Coleta de dados

  5. No aplicativo Terminal, execute o comando pod init e aguarde até que ele seja concluído

    Execute o pod init

  6. No aplicativo Terminal, abra o arquivo podfile com o comando open podfile

    Execute o podfile aberto

  7. Seu computador pode abrir uma caixa de diálogo perguntando com qual aplicativo você deseja abrir o podfile. Escolha qualquer editor de texto, como o TextEdit

  8. Na interface da Coleta de dados, copie a lista de dependências clicando no ícone Copiar. Observe como há uma linha correspondente a cada uma das extensões adicionadas na lição anterior. Cada extensão tem seu próprio conjunto de códigos, que se baseia na extensão principal para dispositivos móveis e só pode ser adicionada ou removida com uma atualização do aplicativo:

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

  9. No editor de texto, cole as dependências da área de transferência logo após a linha # Pods for BusBookingObjectiveC

  10. Salve as atualizações do podfile no editor de texto

    Adicione as dependências e salve

  11. Agora você pode fechar seu editor de texto

  12. Na interface da Coleta de dados, copie a próxima instrução do iOS pod repo update clicando no ícone Copiar

    Copie o pod repo update

  13. No aplicativo Terminal, execute o comando pod repo update e aguarde até que ele seja concluído (isso pode levar alguns minutos)

    Execute o pod repo update

  14. Na interface da Coleta de dados, copie a próxima instrução do iOS pod install clicando no ícone Copiar

    Copie a pod install para a área de transferência na interface da Coleta de dados

  15. No aplicativo Terminal, execute o comando pod install e aguarde até que ele seja concluído

    Execute o pod install

  16. Agora você pode fechar sua janela do Terminal

  17. Abra uma janela do Localizador, navegue até a pasta onde você salvou o aplicativo Bus Booking e confirme se o arquivo BusBooksObjetiveC.xcworkspace, o arquivo Podfile.lock e a pasta Pods foram criados

    Confirme o pods no Localizador

Atualize o AppDelegate

Agora é hora de atualizar o aplicativo para importar o SDK:

  1. Abra o arquivo BusBookingObjectiveC.xcworkspace no XCode.

  2. Abra o arquivo AppDelegate.m.

    Abra o arquivo AppDelegate

  3. Na interface da Coleta de dados, role até a seção Adicionar código de inicialização e escolha Objetivo C como o idioma iOS que você está usando.

  4. 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

  5. No XCode, cole essas declarações de importação no arquivo AppDelegate.m após a importação para o AppDelegate.h

    Cole as declarações de importação no arquivo AppDelegate

  6. 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 primeira linha ativa as instruções de registro do console (as opções disponíveis são "debug", "verbose", "warning" e "error") A segunda linha aponta para o identificador exclusivo do ambiente de tags. Isso é importante, pois você precisará atualizar esse valor quando estivermos prontos para implantar o aplicativo no ambiente de produção

    Copie as instruções principais para a área de transferência

  7. No XCode, cole essas instruções principais no arquivo AppDelegate na parte superior do método application(_:didFinishLaunchingWithOptions:):

    Cole as instruções principais no arquivo AppDelegate

  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 XCode, cole essas declarações de extensão no arquivo AppDelegate logo antes da linha return true do método application(_:didFinishLaunchingWithOptions:):

    Cole as declarações de extensão no arquivo AppDelegate

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 no XCode

  2. Execute o aplicativo e inicie-o no Simulador. Se você não tiver nenhum dispositivo com simulador configurado, configure um agora, certificando-se de configurar um dispositivo executando o iOS 10+. Gostamos de usar um simulador do iPhone 8 porque é fácil clicar no botão Home com um mouse.

    Execute o aplicativo e inicie-o no emulador

  3. Aguarde o simulador 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 da Adobe no console do XCode

    Procure chamadas no console

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

  1. Chamadas para recuperar a configuração das tags (filtrar o console 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:

    2019-03-13 16:53:26.633816-0400 BusBookingObjectiveC[56630:3854917] [AMSDK DEBUG <RulesDownloader>]: Successfully downloaded Rules from 'https://assets.adobedtm.com/launch-EN360aefc739b04410816f751a95861744-development-rules.zip'
    
    {"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 (filtrar o console usando demdex.net) Neste exemplo, a ID (d_mid) já foi definida e está sendo reportada novamente

    2019-03-13 16:53:26.655908-0400 BusBookingObjectiveC[56630:3854937] [AMSDK DEBUG <com.adobe.module.identity>]:
    
    Sending request (https://dpm.demdex.net/id?d_rtbd=json&d_ver=2&d_orgid=7ABB3E6A5A7491460A495D61@AdobeOrg&d_mid=67027929491180584128922600814231770586)
    
  3. Resposta do Identity Service (filtre seu console usando ID Service). Observe como o valor mid corresponde ao valor d_mid na solicitação acima:

    2019-03-13 16:53:27.397048-0400 BusBookingObjectiveC[56630:3854937] [AMSDK DEBUG <com.adobe.module.identity>]:
    
    ID Service - Got ID Response (mid: 67027929491180584128922600814231770586, blob: j8Odv6LonN4r3an7LhD3WZrU1bUpAkFkkiY1ncBR96t2PTI, hint: 9, ttl: "604800000 ms")
    
  4. Solicitação do Analytics (filtre seu console usando Analytics request)

    2019-03-13 16:53:27.689061-0400 BusBookingObjectiveC[56630:3855024] [AMSDK DEBUG <AnalyticsHitDatabase>]: Analytics request was sent with body
    
    (ndh=1&c.&a.&AppID=BusBookingObjectiveC%201%20%281.0%29&CarrierName=%28null%29&DailyEngUserEvent=DailyEngUserEvent&DayOfWeek=4&DeviceName=x86_64&HourOfDay=16&InstallDate=3%2F13%2F2019&InstallEvent=InstallEvent&LaunchEvent=LaunchEvent&Launches=1&MonthlyEngUserEvent=MonthlyEngUserEvent&OSVersion=iOS%2012.1&Resolution=750x1334&RunMode=Application&TimeSinceLaunch=1&internalaction=Lifecycle&locale=en-US&.a&.c&ce=UTF-8&cp=foreground&mid=67027929491180584128922600814231770586&pageName=BusBookingObjectiveC%201%20%281.0%29&pe=lnk_o&pev2=ADBINTERNAL%3ALifecycle&t=00%2F00%2F0000%2000%3A00%3A00%200%20240&ts=1552510406)
    

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

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

Nesta página