Documentação Experience Platform Tutorial sobre Aplicativos para dispositivos móveis

Implementar consentimento

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Saiba como implementar o consentimento em um aplicativo móvel.

A extensão para dispositivos móveis do Adobe Experience Platform Consent permite a coleta de preferências de consentimento do aplicativo móvel ao usar o SDK do Adobe Experience Platform Mobile e a extensão Edge Network. Saiba mais sobre a Extensão de consentimento na documentação.

Pré-requisitos

O aplicativo com SDKs instalados e configurados foi criado e executado com sucesso.

Objetivos de aprendizagem

Nesta lição, você vai:

Solicitar consentimento do usuário.
Atualize a extensão com base na resposta do usuário.
Saiba como obter o estado de consentimento atual.

Solicitar consentimento

Se você seguiu o tutorial desde o início, talvez se lembre de que definiu o consentimento padrão na Extensão de consentimento como Pendente - Enfileirar eventos que ocorrem antes de o usuário fornecer preferências de consentimento.

Para começar a coletar dados, você deve obter o consentimento do usuário. Em um aplicativo real, você pode consultar as práticas recomendadas de consentimento para sua região. Neste tutorial, você obtém consentimento do usuário simplesmente solicitando-o com um alerta:

Você só deseja pedir consentimento ao usuário uma vez. Você pode fazer isso combinando o consentimento do SDK móvel com a autorização necessária para rastreamento usando a Estrutura de transparência de rastreamento de aplicativos da Apple. Neste aplicativo, você presume que, quando o usuário autoriza o rastreamento, ele consente em coletar eventos.

Navegue até Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode.

Adicione este código à função updateConsent.

code language-swift

code language-swift
`// Update consent let collectConsent = ["collect": ["val": value]] let currentConsents = ["consents": collectConsent] Consent.update(with: currentConsents) MobileCore.updateConfigurationWith(configDict: currentConsents)`

// Update consent
let collectConsent = ["collect": ["val": value]]
let currentConsents = ["consents": collectConsent]
Consent.update(with: currentConsents)
MobileCore.updateConfigurationWith(configDict: currentConsents)

Navegue até Luma > Luma > Views > General > DisclaimerView no navegador Project do Xcode, que é a exibição mostrada após a instalação ou reinstalação do aplicativo e a inicialização do aplicativo pela primeira vez. O usuário é solicitado a autorizar o rastreamento de acordo com a Estrutura de transparência de rastreamento de aplicativos da Apple. Se o usuário autorizar, você também atualizará o consentimento.

Adicione o seguinte código ao fechamento ATTrackingManager.requestTrackingAuthorization { status in.

code language-swift

code language-swift
`// Add consent based on authorization if status == .authorized { // Set consent to yes MobileSDK.shared.updateConsent(value: "y") } else { // Set consent to yes MobileSDK.shared.updateConsent(value: "n") }`

// Add consent based on authorization
if status == .authorized {
   // Set consent to yes
   MobileSDK.shared.updateConsent(value: "y")
}
else {
   // Set consent to yes
   MobileSDK.shared.updateConsent(value: "n")
}

Obter estado de consentimento atual

A extensão móvel de consentimento suprime/pendente automaticamente/permite rastreamento com base no valor de consentimento atual. Você também pode acessar o estado de consentimento atual sozinho:

Navegue até Luma > Luma > Utils > MobileSDK no navegador de projetos do Xcode.

Adicione o seguinte código à função getConsents:

code language-swift

code language-swift
`// Get consents Consent.getConsents { consents, error in guard error == nil, let consents = consents else { return } guard let jsonData = try? JSONSerialization.data(withJSONObject: consents, options: .prettyPrinted) else { return } guard let jsonStr = String(data: jsonData, encoding: .utf8) else { return } Logger.aepMobileSDK.info("Consent getConsents: \(jsonStr)") }`

// Get consents
Consent.getConsents { consents, error in
   guard error == nil, let consents = consents else { return }
   guard let jsonData = try? JSONSerialization.data(withJSONObject: consents, options: .prettyPrinted) else { return }
   guard let jsonStr = String(data: jsonData, encoding: .utf8) else { return }
   Logger.aepMobileSDK.info("Consent getConsents: \(jsonStr)")
}

Navegue até Luma > Luma > Views > General > HomeView no navegador de projetos do Xcode.

Adicione o seguinte código ao modificador .task:

code language-swift
`// Ask status of consents MobileSDK.shared.getConsents()`

No exemplo acima, você está simplesmente registrando o status de consentimento no console no Xcode. Em um cenário real, você pode usá-lo para modificar quais menus ou opções são mostrados ao usuário.

Validar com garantia

Exclua o aplicativo do seu dispositivo ou simulador para redefinir e inicializar corretamente o rastreamento e o consentimento.
Para conectar seu simulador ou dispositivo ao Assurance, leia a seção instruções de instalação.
Ao mover o aplicativo da tela Página Inicial para a tela Produtos e de volta para a tela Página Inicial, você deverá ver um evento Obter Resposta de Consentimento na interface do usuário do Assurance.

SUCCESS

Agora, você ativou o aplicativo para solicitar ao usuário que inicie primeiro após a instalação (ou reinstalação) que consente o uso do SDK do Adobe Experience Platform Mobile.

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: Coletar dados do ciclo de vida

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b