Configurando preferências para Aplicativos
Caso você possua vários aplicativos você pode criar uma chave de API para cada um e configurar diferentes preferências para cada aplicação.
Passo 1 - Crie a sua aplicação
Acesse o menu “SDK Mobile” e clique no botão “Adicionar novo app”. Preencha as informações básicas e pronto, você já tem um conjunto de chaves para poder fazer as integrações conforme o manual de integração abaixo.
Passo 2 - Configure as preferência de cada aplicativo
Após criar a sua aplicação, clique no botão “+” para adicionar novas preferências. A plataforma sugere alguns tipos de preferências comuns em aplicativos como:
Push - Autorização para Receber notificações
Storage - Permissão para ler e gravar no storage
Camera - Permissão para utilizar a câmera do dispositivos
GPS - Autorização para coleta da localização em GPS
Caso a sua preferência não esteja na lista basta criar uma personalizada. O campo “Código da Permissão” é muito importantepois é com ele que o desenvolvedor do aplicativo irá trabalhar para detectar mudanças de preferências.
Acompanhando logs e auditoria
Na lista de aplicações você pode clicar ainda no último ícone na direita para acessar os logs de auditoria das autorizações dos usuários.
Manual de Integração
Variáveis
Em sua área interna na sessão “SDK Mobile” você tem à disposição as variáveis:
API_KEY | Chave da API para integração com o backend |
PUBLIC_KEY | Chave pública para criptografia |
PRODUCTION | Envie “true” caso esteja usando ambiente de produção ou “false” em caso de testes em sandbox |
PERMISSION_CODE | É o código de cada preferência do usuário |
Android - Instruções de instalação
Bibliotecas necessárias:
Code Block | ||
---|---|---|
| ||
implementation "org.bouncycastle:bcprov-jdk15on:1.60" implementation "org.bouncycastle:bcpkix-jdk15on:1.60" privacymodule-release.aar <-- Você pode fazer o download dessa biblioteca na sua área interna |
Inicialização
Code Block | ||
---|---|---|
| ||
PrivacyBuilder.init( "API_KEY", "PUBLIC_KEY", "PRODUCTION", "Seu objeto Context"); // Habilitar Console PrivacyLog.getInstance().debug = switchDebugConsole.isChecked //Ler o Listener - opção para o programador ler os logs como dado PrivacyLog.getInstance().delegate = PrivacyLog.PrivacyLogDelegate { text -> activity?.runOnUiThread { print("Recebeu " + text) } } |
Comando para abrir a popup
Code Block | ||
---|---|---|
| ||
PrivacyBuilder.showPrivacyPreferences("Seu objeto activity"); |
Comando para criar eventos
Code Block |
---|
PrivacyBuilder.addPrivacyEvent("Permission code",PrivacyEvent(){ public void onAuthorize(){ //on authorize permission } public void onForbidden(){ //on remove permission } }); |
IOS - Instruções para instalação
Adicionar o framework ao projeto
Embed o arquivo PrivacyConsentMobile.framework ao projeto. O arquivo você encontra em sua área interna.
Importar o módulo no código-fonte
Code Block |
---|
import PrivacyConsentMobile |
Adicionar o delegate à classe
Code Block |
---|
class ViewController: UIViewController, ConsentDelegate { func onAuthorize(code: String) { print ("onAuthorize -> \(code)") } func onForbidden(code: String) { print ("onForbidden -> \(code)") } } |
Chamar a tela de Preferências
Code Block | ||
---|---|---|
| ||
let APIKEY = "SUA API_KEY" let PUBLICKEY = "SUA PUBLIC_KEY" ... let consentBuilder = ConsentBuilder() consentBuilder.delegate = self let controller = consentBuilder.showConsent(apiKey: APIKEY, publicKey: PUBLICKEY, production: false) controller.modalPresentationStyle = .fullScreen self.present(controller, animated: true, completion: nil) ... |
Download das bibliotecas iOS e Android
Segue abaixo o download da biblioteca iOS(para Xcode 12.4)
View file | ||
---|---|---|
|
Segue abaixo o download da biblioteca iOS(para Xcode 11.3)
View file | ||
---|---|---|
|
Segue abaixo o download da biblioteca Android
View file | ||
---|---|---|
|