Configurar o Assurance

Saiba como configurar o Adobe Experience Platform Assurance em um aplicativo móvel.

O Assurance, formalmente conhecido como Projeto Griffon, foi projetado para ajudá-lo a inspecionar, testar, simular e validar a maneira como você coleta dados ou veicula experiências em seu aplicativo móvel.

O Assurance ajuda a inspecionar eventos brutos de SDK gerados pelo SDK móvel da Adobe Experience Platform. Todos os eventos coletados pelo SDK estão disponíveis para inspeção. Os eventos do SDK são carregados em uma exibição de lista classificada por tempo. Cada evento tem uma exibição detalhada que fornece mais detalhes. Exibições adicionais para procurar a configuração do SDK, elementos de dados, Estados compartilhados e versões de extensão do SDK também são fornecidas. Saiba mais sobre a Garantia na documentação do produto.

Pré-requisitos

  • Aplicativo com SDKs instalado e configurado com êxito.

Objetivos de aprendizagem

Nesta lição, você vai:

  • Confirme se sua organização tem acesso (e solicite-o caso não tenha).
  • Configure seu URL base.
  • Adicione o código específico necessário do iOS.
  • Conectar-se a uma sessão.

Confirmar acesso

Confirme se sua organização tem acesso ao Assurance. Você, como usuário, deve ser adicionado ao perfil do Adobe Experience Platform. Consulte Acesso de usuário no Guia de garantia para obter mais informações.

Implementação

Além da instalação do SDK geral, que você concluiu na lição anterior, a iOS também exige a seguinte adição para iniciar a sessão do Assurance para o seu aplicativo.

  1. Navegue até Luma > Luma > SceneDelegate no navegador Project do Xcode.

  2. Adicione o código a seguir a func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

    code language-swift
    // Called when the app in background is opened with a deep link.
    if let deepLinkURL = URLContexts.first?.url {
        // Start the Assurance session
        Assurance.startSession(url: deepLinkURL)
    }
    

    Esse código inicia uma sessão de controle quando o aplicativo é colocado em segundo plano e aberto usando um deep link.

Mais informações podem ser encontradas aqui.

Definir identificador do conjunto

É necessário fornecer um identificador de pacote exclusivo para seu aplicativo.

  1. Abra o projeto no Xcode.

  2. Selecione Luma no Navegador de projetos.

  3. Selecione o destino Luma.

  4. Selecione a guia Assinatura e Recursos.

  5. Defina um Identificador de Pacote.

    note important
    IMPORTANT
    Use um identificador de conjunto exclusivo e substitua o identificador de conjunto com.adobe.luma.tutorial.swiftui, pois cada identificador de conjunto precisa ser exclusivo. Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, como com.organization.brand.uniqueidentifier. A versão Concluída deste tutorial, por exemplo, usa com.adobe.luma.tutorial.swiftui.

    Recursos de assinatura do Xcode {modal="regular"}

Configurar um URL de base

  1. Vá para o seu projeto no Xcode.

  2. Selecione Luma no Navegador de projetos.

  3. Selecione o destino Luma.

  4. Selecione a guia Informações.

  5. Para adicionar uma URL base, role para baixo até Tipos de URL e selecione o botão +.

  6. Defina Identificador para o Identificador de Pacote de sua escolha e defina um Esquemas de URL de sua escolha.

    url de garantia

    note important
    IMPORTANT
    Use um identificador de conjunto exclusivo e substitua o identificador de conjunto com.adobe.luma.tutorial.swiftui, pois cada identificador de conjunto deve ser exclusivo. Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, como com.organization.brand.uniqueidentifier. Você pode usar o mesmo identificador de conjunto usado em Definir identificador de conjunto.
    Da mesma forma, use um esquema de URL exclusivo e substitua o lumatutorialswiftui já fornecido pelo seu esquema de URL exclusivo.

Para saber mais sobre os Esquemas de URL na iOS, consulte a documentação da Apple.

O Assurance funciona abrindo um URL, seja via navegador ou código QR. Esse URL começa com o URL de base que abre o aplicativo e contém parâmetros adicionais. Esses parâmetros exclusivos são usados para conectar a sessão.

Conectar-se a uma sessão

No Xcode:

  1. Compile ou recompile e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando Play .

    note tip
    TIP
    Como opção, você pode querer "limpar" sua build, especialmente quando vir resultados inesperados. Para fazer isso, selecione Limpar pasta de compilação… no menu Xcode Produto.
  2. Na caixa de diálogo Permitir que o "Aplicativo Luma" use sua localização, selecione Permitir ao Usar o Aplicativo.

    {width="300"}

  3. Na caixa de diálogo "Aplicativo Luma" Deseja Enviar Notificações, selecione Permitir.

    {width="300"}

  4. Selecione Continuar… para permitir que o aplicativo acompanhe sua atividade.

    {width="300"}

  5. Na caixa de diálogo Permitir que o "Aplicativo Luma" acompanhe sua atividade nos aplicativos e sites de outras empresas, selecione Permitir.

    {width="300"}

No navegador:

  1. Vá para a interface da Coleção de dados.

  2. Selecione Garantia no painel esquerdo.

  3. Selecione Criar Sessão.

  4. Selecione Iniciar.

  5. Forneça um Nome da Sessão, como Luma Mobile App Session e a URL Base, que são os Esquemas de URL inseridos no Xcode, seguido de :// Por exemplo: lumatutorialswiftui://

  6. Selecione Próximo.
    criar sessão de garantia

  7. Na caixa de diálogo modal Criar nova sessão:

    Se você estiver usando um dispositivo físico:

    • Selecione Digitalizar código QR. Para abrir o aplicativo, use a câmera do dispositivo físico para digitalizar o código QR e toque no link.

      código de garantia de qualidade

    Se estiver usando um simulador:

    1. Selecione Copiar Link.

    2. Copie o deep link usando Copiar e use o deep link para abrir o aplicativo com o Safari no simulador.

      Link da cópia de garantia

  8. Quando o aplicativo é carregado, uma caixa de diálogo modal é exibida solicitando que você insira o PIN mostrado na etapa 7.

    {width="300"}

    Insira o PIN e selecione Conectar.

  9. Se a conexão tiver sido bem-sucedida, você verá:

    • Um ícone do Assurance flutuando sobre seu aplicativo.

      {width="300"}

    • Atualizações de Experience Cloud provenientes da interface do usuário do Assurance, mostrando:

      1. Eventos de experiência provenientes do aplicativo.

      2. Detalhes de um evento selecionado.

      3. O dispositivo e a linha do tempo.

        eventos de garantia

Se você tiver desafios, confira a documentação técnica e a documentação geral.

Verificar extensões

Para verificar se seu aplicativo está usando as extensões mais atualizadas:

  1. Selecione Configurar.

  2. Selecione Adicionar para 123 Versões de Extensão.

  3. Selecione Salvar.

    Configurar versões de extensão

  4. Selecione 123 Versões de Extensão para ter uma visão geral das extensões mais recentes disponíveis e das extensões usadas na sua versão do aplicativo.

    Versões de extensão

  5. Para atualizar suas versões de extensão (por exemplo, Mensagens e Otimizar), selecione o pacote (extensão) de Dependências de Pacote (por exemplo, AEPMessaging) e, no menu de contexto, selecione Atualizar Pacote. O Xcode atualizará as dependências do pacote.

NOTE
Depois de atualizar suas extensões (pacotes) no Xcode, feche e exclua sua sessão atual e repita todas as etapas de Conectando-se a uma sessão e Verificar extensões para garantir que o Assurance relate corretamente as extensões corretas em uma nova sessão do Assurance.
SUCCESS
Agora você configurou seu aplicativo para usar o Assurance 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-os nesta postagem de Discussão da Comunidade Experience League

Próximo: Implementar Consentimento

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