Instalar SDKs do Adobe Experience Platform Mobile

Saiba como implementar o Adobe Experience Platform Mobile SDK em um aplicativo móvel.

Pré-requisitos

Objetivos de aprendizagem

Nesta lição, você vai:

  • Adicione os SDKs necessários ao seu projeto usando o Gerenciador de pacotes do Swift.
  • Registre as extensões.
NOTE
Em uma implementação de aplicativo móvel, os termos "extensões" e "SDKs" são quase intercambiáveis.

Gerenciador de pacotes Swift

Em vez de usar CocoaPods e um arquivo Pod (conforme descrito em Gerar instruções de instalação do SDK), você adiciona pacotes individuais usando o gerenciador de pacotes Swift nativo do Xcode. O projeto Xcode já tem todas as dependências de pacotes adicionadas para você. O Xcode Dependências de pacote A tela deve ter a seguinte aparência:

Dependências do pacote Xcode {zoom="yes"}

No Xcode, você pode usar Arquivo > Adicionar pacotes… para adicionar pacotes. A tabela abaixo fornece links para os URLs que você usaria para adicionar pacotes. Os links também direcionam você para mais informações sobre cada pacote específico.

Pacote
Descrição
AEP Core

A variável AEPCore, AEPServices, e AEPIdentity As extensões representam a base do SDK do Adobe Experience Platform - todos os aplicativos que usam o SDK devem incluí-las. Esses módulos contêm um conjunto comum de funcionalidades e serviços exigidos por todas as extensões do SDK.

  • AEPCore contém a implementação do Hub de eventos. O Hub de eventos é o mecanismo usado para fornecer eventos entre o aplicativo e o SDK. O Hub de eventos também é usado para compartilhar dados entre extensões.
  • AEPServices O fornece várias implementações reutilizáveis necessárias para suporte à plataforma, incluindo rede, acesso ao disco e gerenciamento de banco de dados.
  • AEPIdentity implementa a integração com os serviços de identidade da Adobe Experience Platform.
  • AEPSignal representa a extensão de sinal dos SDKs da Adobe Experience Platform que permite aos profissionais de marketing enviar um "sinal" para seus aplicativos a fim de enviar dados para destinos externos ou abrir URLs.
  • AEPLifecycle representa a extensão Lifecycle dos SDKs da Adobe Experience Platform que ajuda a coletar métricas de ciclo de vida do aplicativo, como informações de instalação ou atualização do aplicativo, informações de inicialização e sessão do aplicativo, informações do dispositivo e quaisquer dados de contexto adicionais fornecidos pelo desenvolvedor do aplicativo.
AEP Edge
A extensão móvel da Rede de borda da Adobe Experience Platform (AEPEdge) permite enviar dados para a Rede da Adobe Edge a partir de um aplicativo para dispositivos móveis. Essa extensão permite implementar os recursos do Adobe Experience Cloud de forma mais robusta, atender a várias soluções de Adobe por meio de uma chamada de rede e, simultaneamente, encaminhar essas informações para a Adobe Experience Platform.
A extensão móvel da Rede de borda é uma extensão para o SDK do Adobe Experience Platform e requer o AEPCore e AEPServices extensões para manipulação de eventos, bem como a AEPEdgeIdentity extensão para recuperar as identidades, como ECID.
Identidade da borda da AEP
A extensão móvel da AEP Edge Identity (AEPEdgeIdentity) permite a manipulação de dados de identidade do usuário de um aplicativo móvel ao usar o SDK do Adobe Experience Platform e a extensão Edge Network.
Consentimento de borda da AEP
A extensão móvel da Coleção de consentimento da AEP (AEPConsent) ativa a coleção de preferências de consentimento do aplicativo móvel ao usar o SDK do Adobe Experience Platform e a extensão Edge Network.
Perfil de usuário da AEP
A extensão móvel do perfil de usuário do Adobe Experience Platform (AEPUserProfile) é uma extensão para gerenciar perfis de usuário para o SDK do Adobe Experience Platform.
AEP Places
A extensão do AEP Places (AEPPlaces) permite rastrear eventos de geolocalização, conforme definido na interface do Adobe Places e nas regras de tag da coleção de dados do Adobe.
Mensagens AEP
A extensão Mensagens da AEP (AEPMessaging) permite enviar tokens de notificação por push e feedback de click-through de notificação por push para a Adobe Experience Platform.
Otimização da AEP
A extensão Otimizar AEP (AEPOptimize) fornece APIs para permitir workflows de personalização em tempo real nos SDKs do Adobe Experience Platform Mobile usando o Adobe Target ou o Adobe Journey Optimizer Offer Decisioning. Exige AEPCore e AEPEdge extensões para enviar eventos de consulta de personalização para a rede Experience Edge.
AEP Assurance
O Assurance (também conhecido como projeto Griffon) é uma extensão nova e inovadora (AEPAssurance) para ajudá-lo a inspecionar, testar, simular e validar a maneira como você coleta dados ou fornece experiências em seu aplicativo móvel. Essa extensão habilita seu aplicativo para Assurance.

Importar extensões

No Xcode, navegue até Luma > Luma > AppDelegate e verifique se as importações a seguir fazem parte desse arquivo de origem.

// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance

Faça o mesmo para Luma > Luma > Utils > MobileSDK.

Atualizar AppDelegate

Navegue até Luma > Luma > AppDelegate no navegador do Projeto Xcode.

  1. Substitua o @AppStorage value YOUR_ENVIRONMENT_ID_GOES_HERE para environmentFileId ao valor da ID do arquivo do ambiente de desenvolvimento que você recuperou das tags na Gerar instruções de instalação do SDK.

    code language-swift
    @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
    
  2. Adicione o seguinte código à application(_, didFinishLaunchingWithOptions) função.

    code language-swift
    // Define extensions
    let extensions = [
        AEPIdentity.Identity.self,
        Lifecycle.self,
        Signal.self,
        Edge.self,
        AEPEdgeIdentity.Identity.self,
        Consent.self,
        UserProfile.self,
        Places.self,
        Messaging.self,
        Optimize.self,
        Assurance.self
    ]
    
    // Register extensions
    MobileCore.registerExtensions(extensions, {
        // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection
        Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)")
        MobileCore.configureWith(appId: self.environmentFileId)
    
        // set this to false or comment it when deploying to TestFlight (default is false),
        // set this to true when testing on your device.
        MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true])
        if appState != .background {
            // only start lifecycle if the application is not in the background
            MobileCore.lifecycleStart(additionalContextData: nil)
        }
    
        // assume unknown, adapt to your needs.
        MobileCore.setPrivacyStatus(.unknown)
    })
    

O código acima faz o seguinte:

  1. Registra as extensões necessárias.
  2. Configura o MobileCore e outras extensões para usar a configuração de propriedade da tag.
  3. Ativa o log de depuração. Mais detalhes e opções podem ser encontrados na Documentação do SDK do Adobe Experience Platform Mobile.
  4. Inicia o monitoramento do ciclo de vida. Consulte Ciclo de vida etapa no tutorial para obter mais detalhes.
  5. Define o consentimento padrão como desconhecido. Consulte Consentimento etapa no tutorial para obter mais detalhes.
IMPORTANT
Atualize o MobileCore.configureWith(appId: self.environmentFileId) com o appId com base no environmentFileId no ambiente de tags que você está criando para (desenvolvimento, armazenamento temporário ou produção).
SUCCESS
Agora você instalou os pacotes necessários e atualizou seu projeto para registrar corretamente as extensões do SDK do Adobe Experience Platform Mobile necessárias que usará para o restante do tutorial.
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Mobile SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta Publicação de discussão da comunidade do Experience League

Próximo: Configurar o Assurance

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b