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.
-
Navegue até Luma > Luma > SceneDelegate no navegador Project do Xcode.
-
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.
-
Abra o projeto no Xcode.
-
Selecione Luma no Navegador de projetos.
-
Selecione o destino Luma.
-
Selecione a guia Assinatura e Recursos.
-
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, comocom.organization.brand.uniqueidentifier
. A versão Concluída deste tutorial, por exemplo, usacom.adobe.luma.tutorial.swiftui
.{modal="regular"}
Configurar um URL de base
-
Vá para o seu projeto no Xcode.
-
Selecione Luma no Navegador de projetos.
-
Selecione o destino Luma.
-
Selecione a guia Informações.
-
Para adicionar uma URL base, role para baixo até Tipos de URL e selecione o botão +.
-
Defina Identificador para o Identificador de Pacote de sua escolha e defina um Esquemas de URL de sua escolha.
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, comocom.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 olumatutorialswiftui
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:
-
Compile ou recompile e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando .
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. -
Na caixa de diálogo Permitir que o "Aplicativo Luma" use sua localização, selecione Permitir ao Usar o Aplicativo.
{width="300"}
-
Na caixa de diálogo "Aplicativo Luma" Deseja Enviar Notificações, selecione Permitir.
{width="300"}
-
Selecione Continuar… para permitir que o aplicativo acompanhe sua atividade.
{width="300"}
-
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:
-
Vá para a interface da Coleção de dados.
-
Selecione Garantia no painel esquerdo.
-
Selecione Criar Sessão.
-
Selecione Iniciar.
-
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://
-
Selecione Próximo.
-
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.
Se estiver usando um simulador:
-
Selecione Copiar Link.
-
Copie o deep link usando e use o deep link para abrir o aplicativo com o Safari no simulador.
-
-
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.
-
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:
-
Eventos de experiência provenientes do aplicativo.
-
Detalhes de um evento selecionado.
-
O dispositivo e a linha do tempo.
-
-
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:
-
Selecione Configurar.
-
Selecione para Versões de Extensão.
-
Selecione Salvar.
-
Selecione 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.
-
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.
Próximo: Implementar Consentimento