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 o Assurance 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 do usuário no guia do Assurance para obter mais informações.

Implementação

Para além do quadro Instalação do SDK, que você concluiu na lição anterior, o iOS também exige a seguinte adição para iniciar a sessão do Assurance para seu aplicativo.

  1. Navegue até Luma > Luma > SceneDelegate no navegador de projetos 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. Selecionar Luma no Navegador de projetos.

  3. Selecione o Luma público-alvo.

  4. Selecione o Assinatura e recursos guia.

  5. Definir um Identificador do pacote.

    note important
    IMPORTANT
    Certifique-se de usar um único identificador do pacote e substitua o com.adobe.luma.tutorial.swiftui identificador de pacote, pois cada identificador de pacote precisa ser exclusivo. Normalmente, você usa um formato de DNS reverso para sequências 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 {zoom="yes"}

Configurar um URL de base

  1. Vá para o seu projeto no Xcode.

  2. Selecionar Luma no Navegador de projetos.

  3. Selecione o Luma público-alvo.

  4. Selecione o Informações guia.

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

  6. Definir Identificador ao Identificador de pacote de sua escolha e defina um Esquemas de URL de sua escolha.

    url de garantia

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

Para saber mais sobre Esquemas de URL no iOS, revise 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. Crie ou recrie e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando Reproduzir .

    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… do Xcode Produto menu.
  2. No Permitir que "Aplicativo Luma" use sua localização , selecione Permitir ao usar o aplicativo.

    img-md
    w-300
  3. No "Aplicativo Luma" Deseja Enviar Notificações , selecione Permitir.

    img-md
    w-300
  4. Selecionar Continuar… para permitir que o aplicativo acompanhe sua atividade.

    img-md
    w-300
  5. No Permitir que o "Aplicativo Luma" rastreie sua atividade nos aplicativos e sites de outras empresas , selecione Permitir.

    img-md
    w-300

No navegador:

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

  2. Selecionar Assurance do painel esquerdo.

  3. Selecionar Criar sessão.

  4. Selecionar Início.

  5. Forneça um Nome da sessão como Luma Mobile App Session e a variável URL base, que são os Esquemas de URL inseridos no Xcode, seguidos por :// Por exemplo: lumatutorialswiftui://

  6. Selecione Próximo.
    criação de sessão do assurance

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

    Se você estiver usando um dispositivo físico:

    • Selecionar 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 controle de qualidade do assurance

    Se estiver usando um simulador:

    1. Selecionar Copiar link.

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

      Link de 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.

    img-md
    w-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.

      img-md
      w-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 tiver algum desafio, revise o técnico and general documentation.

Verificar extensões

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

  1. Selecionar Configurar.

  2. Selecionar Adicionar para 123 Versões de extensão.

  3. Selecione Salvar.

    Configurar versões de extensão

  4. Selecionar 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) selecionar 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 Conectar-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-as nesta Publicação de discussão da comunidade do Experience League

Próximo: Implementar consentimento

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