Show Menu
TÓPICOS×

Implementação principal e ciclo de vida

Esta informação ajuda a implementar a biblioteca do iOS e coletar medições de ciclo de vida, como inicializações, atualizações, sessões, usuários envolvidos e assim por diante.

Baixar o SDK

Para baixar o SDK, você deve usar o iOS 6 ou posterior.
Pré-requisitos
Antes de baixar o SDK, conclua as etapas em Criar um conjunto de relatórios na Implementação principal e no ciclo de vida para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão pré-preenchida do arquivo de configuração.
Para baixar o SDK:
  1. Baixe, descompacte o arquivo [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip e verifique se você tem os seguintes componentes de software:
    • ADBMobile.h , arquivo de cabeçalho em Objective-C usado no AppMeasurement do iOS.
    • ADBMobileConfig.json , que é o arquivo de configuração de SDK personalizado para o seu aplicativo.
    • AdobeMobileLibrary.a , um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca de dispositivos (armv7, armv7s, arm64) e dos simuladores (i386 e x86_64) do iOS.
      Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo do iOS.
    • AdobeMobileLibrary_Extension.a , um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca de dispositivos (armv7, armv7s, arm64) e dos simuladores (i386 e x86_64) do iOS.
      Esse binário deve ser vinculado quando o destino for pretendido para uma extensão do iOS.
    • AdobeMobileLibrary_Watch.a , um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca dos dispositivos (armv7k) e dos simuladores (i386 e x86_64) do Apple Watch.
      Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo de extensão do Apple Watch (watchOS 2).
    • AdobeMobileLibrary_TV.a , um binário multiarquitetura habilitado para código de bits que apresenta os builds da biblioteca dos novos dispositivos (arm64) e simuladores (x86_64) da Apple TV.
      Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo da Apple TV (tvOS).
Se você baixar o SDK fora da interface do Adobe Mobile Services, o arquivo ADBMobileConfig.json deverá ser configurado manualmente. Se você nunca usou o Analytics e o Mobile SDK, consulte Antes de começar para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão já preenchida do arquivo de configuração.

Adicionar o SDK e o arquivo de configuração ao projeto

  1. Abra o Xcode IDE e o seu aplicativo.
  2. No Navegador de projetos, arraste a pasta AdobeMobileLibrary e solte-a no seu projeto.
  3. Verifique o seguinte:
    • A caixa de seleção Copiar itens se necessário está marcada.
    • Criar grupos está selecionado.
    • Nenhuma das caixas de seleção na seção Adicionar aos destinos está marcada.
  4. Clique em Concluir .
  5. No Navegador de projetos , selecione !UICONTROL`ADBMobileConfig.json` .
  6. Em Inspetor de arquivos , adicione o arquivo JSON a todos os destinos em seu projeto que usarão o SDK da Adobe.
  7. No Navegador de projetos , conclua as seguintes etapas:
    1. Clique no seu aplicativo.
    2. Na guia Geral , selecione seus alvos e vincule as estruturas e bibliotecas necessárias nas seções Estruturas vinculadas e Bibliotecas .
    • Destinos de aplicativos iOS
      • SystemConfiguration.framework
      • WebKit.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary.a
      • CoreLocation.framework (opcional, porém obrigatório para recursos de rastreamento geográfico)
    • Destino de extensão do iOS
      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Extension.a
    • Destino Apple Watch (watchOS 2)
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Watch.a
    • Destino da Apple TV (tvOS) :
      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_TV.a
    Vincular mais de um arquivo AdobeMobileLibrary*.a ao mesmo destino resultará em um comportamento inesperado ou na incapacidade de criar o build.
  8. Verifique se o aplicativo foi criado sem erros.

Implementar medições de ciclo de vida

O iOS enviará informações de ciclo de vida fazendo ou não uma chamada com o collectlifecycledata , e o collectlifecycledata é só uma maneira de iniciar o ciclo de vida anteriormente na sequência de iniciação do aplicativo.
Após habilitar o ciclo de vida, cada vez que o aplicativo é iniciado uma ocorrência é enviada para medir as inicializações, atualizações, usuários engajados e outras Métricas de ciclo de vida .
Adicionar uma chamada collectLifecycleData / collectLifecycleDataWithAdditionalData em application:didFinishLaunchingWithOptions :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
 [ADBMobile collectLifecycleData]; 
    return YES; 
}

Incluir dados adicionais com chamadas de ciclo de vida

Para incluir dados adicionais com chamadas de ciclo de vida, use collectLifecycleDataWithAdditionalData :
Quaisquer dados transmitidos para o SDK por meio de collectLifecycleDataWithAdditionalData: serão mantidos em NSUserDefaults pelo SDK. O SDK desmonta os valores no parâmetro NSDictionary que não são dos tipos NSString ou NSNumber .
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
    NSMutableDictionary *contextData = [NSMutableDictionary dictionary]; 
    [contextData setObject:@"Game" forKey:@"myapp.category"]; 
    [ADBMobile collectLifecycleDataWithAdditionalData:contextData]; 
    return YES; 
}

Os valores dos dados de contexto adicionais enviados com o collectLifecycleDataWithAdditionalData devem ser mapeados para variáveis personalizadas no Adobe Mobile Services:
As outras medições de ciclo de vida são coletadas automaticamente. Para obter mais informações, consulte Medições de ciclo de vida .

O que fazer em seguida

Conclua as seguintes tarefas: