O objetivo deste manual é fornecer todas as informações necessárias para instalação e uso da ferramenta nos aplicativos desenvolvidos para plataforma iOS.
Este SDK é escrito em ObjC e realiza a coleta de dados (informações e localização) do dispositivo e envio para ClearSale. Todas as informações coletadas são dados relacionados apenas ao dispositivo, sem relação ao aplicativo integrado.
As informações de geolocalização e IDFA (Identifier for advertisers) dependem da permissão concedida pelo usuário do dispositivo,
O SDK respeita a política de privacidade da Apple para a captura dos dados do dispositivo e o nível de permissão atribuído pelo usuário (usuário do dispositivo).
Package | Digest |
---|---|
CSBehavior | MD5: 2329818ab396724b0b91362c7abced5a6a849deb |
Para consultar o checksum do artefato baixado verifique o podfile.lock, após executar o comando pod install no seu projeto.
Package | Digest |
---|---|
CSBehavior | MD5: 53dd028224a73c0ad9043899fb9def50dcfefc69 |
Para consultar o checksum do artefato baixado verifique o podfile.lock, após executar o comando pod install no seu projeto.
Package | Digest |
---|---|
CSBehavior | MD5: 0194c7a4a2a0794a823fd7b1540504eb5e814b43 |
Para consultar o checksum do artefato baixado verifique o podfile.lock, após executar o comando pod install no seu projeto.
Package | Digest |
---|---|
CSBehavior | MD5: 0194c7a4a2a0794a823fd7b1540504eb5e814b43 |
Para consultar o checksum do artefato baixado verifique o podfile.lock, após executar o comando pod install no seu projeto.
O pod está disponível em um repositório privado. Para sua utilização é necessário seguir o exemplo abaixo para o PodFile:
source 'https://dev.azure.com/CS-PublicPackages/Behavior/_git/BehaviorAnalytics.SDK.IOS.Specs'
use_frameworks!
target 'NOME_DO_PROJETO' do
pod 'CSBehavior', '3.0.1'
end
O pod está disponível em um repositório privado. Para sua utilização é necessário seguir o exemplo abaixo para o PodFile:
source 'https://dev.azure.com/CS-PublicPackages/Behavior/_git/BehaviorAnalytics.SDK.IOS.Specs'
use_frameworks!
target 'NOME_DO_PROJETO' do
pod 'CSBehavior', '3.0.2-rc.1'
end
O pod está disponível em um repositório privado. Para sua utilização é necessário seguir o exemplo abaixo para o PodFile:
source 'https://CS-PublicPackages@dev.azure.com/CS-PublicPackages/Behavior/_git/BehaviorAnalytics.SDK.IOS.Specs'
use_frameworks!
target 'NOME_DO_PROJETO' do
pod 'CSBehavior', '4.0.10'
end
O pod está disponível em um repositório privado. Para sua utilização é necessário seguir o exemplo abaixo para o PodFile:
source 'https://CS-PublicPackages@dev.azure.com/CS-PublicPackages/Behavior/_git/BehaviorAnalytics.SDK.IOS.Specs'
use_frameworks!
target 'NOME_DO_PROJETO' do
pod 'CSBehavior', '5.0.0'
end
Instruções para configuração do framework no projeto:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>clearsale.com.br</key>
<dict>
<key>NSTemporaryExceptionMinimumTLSVersion</key>
<string>TLSv1.2</string>
</dict>
</dict>
</dict>
<key>NSUserTrackingUsageDescription</key>
<string>Explicação de porque o usuário precisa conceder a permissão.</string>
#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
if (@available(iOS 14, *)) {
[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
}];
}
import AppTrackingTransparency
if #available(iOS 14, *) {
ATTrackingManager.requestTrackingAuthorization { _ in
}
}
CSBehavior é a classe responsável pela coleta das informações.
Construtores: esta classe não possui construtores públicos. A instância deverá ser feita através de um método estático.
Nome do método | Descrição |
---|---|
(CSBehavior *)getInstance:(NSString *)toApp |
Obtém a instância da classe Behavior para um AppKey. É necessário passar como parâmetro o AppKey (valor fornecido pela ClearSale). |
Nome do método | Descrição |
---|---|
(NSString *)generateSessionId | Gera e retorna um identificador de sessão. Este método deve ser utilizado somente se o aplicativo não gerar identificadores únicos para cada coleta. |
(void)collectDeviceInformation:(NSString *)toSessionId |
Realiza a coleta das informações do dispositivo vinculando ao valor
de Sessão. É necessário passar como parâmetro o SessionId, valor de sessão.
|
(void)sendEvent:(CSBUserEventType)eventType :(NSString *)sessionId | Responsável por enviar um evento de usuário específico associado a uma sessão (versão beta). |
(void)allowSecurity() | Permite a ativação de funcionalidades de segurança no gerenciador de comportamento. |
O módulo de segurança do SDK iOS é composto por uma série de funcionalidades que visam proteger nossos produtos e serviços contra ataques.
Esse módulo está disponível a partir da versão 5.0.0 do SDK. Para habilitá-lo é necessário chamar
o novo método allowSecurity()
antes da coleta.
var behavior: CSBehavior = CSBehavior.getInstance("APP_KEY");
behavior.allowSecurity();
behavior.collectionDeviceInformation("SESSION_ID");
CSBehavior *behavior = [[CSBehavior getInstance] @"APP_KEY" ];
[behavior allowSecurity];
[behavior collectDeviceInformation: @"SESSION_ID"];
O módulo de segurança possui um ciclo de vida que permite o aplicativo ser mais seguro. Ao utilizar este módulo, existirá a obrigatoriedade de sempre estar com a última versão disponibilizada, sendo as datas de disponibilização em abril e outubro de cada ano.
Essas versões possuem validade de 6 meses. E, para o funcionamento correto, é necessário realizar a atualização antes que a versão anterior expire.
CSBehavior *behavior = [CSBehavior getInstance:@"APP_KEY"];
[behavior collectDeviceInformation:@"SESSION_ID"];
CSBehavior *behavior = [CSBehavior getInstance:@"APP_KEY"];
NSString *sessionId = [behavior generateSessionId];
[behavior collectDeviceInformation:sessionId];
var behavior: CSBehavior = CSBehavior.getInstance("APP_KEY")
behavior.collectDeviceInformation("SESSION_ID")
var behavior: CSBehavior = CSBehavior.getInstance("APP_KEY")
var sessionId: NSString = behavior.generateSessionId()
behavior.collectDeviceInformation(sessionId)
É possível visualizar a implementação do SDK em um projeto de exemplo Clicando aqui.
Acesse nosso FAQ Clicando Aqui
Todas as informações coletadas pelo SDK da ClearSale são com exclusiva finalidade de prevenção à fraude e proteção ao próprio usuário, aderente à política de segurança e privacidade das plataformas Google e Apple e à LGPD. Por isso, estas informações devem constar na política de privacidade do aplicativo.
O SDK da ClearSale coleta as seguintes informações do dispositivo :
Ao realizar o download e utilizar nosso SDK você estará concordando com a seguinte licença.
Copyright © 2024 ClearSale
Todos os direitos são reservados, sendo concedida a permissão para usar o software da maneira como está, não sendo permitido qualquer modificação ou cópia para qualquer fim. O Software é licenciado com suas atuais configurações “tal como está” e sem garantia de qualquer espécie, nem expressa e nem implícita, incluindo mas não se limitando, garantias de comercialização, adequação para fins particulares e não violação de direitos patenteados. Em nenhuma hipótese os titulares dos Direitos Autorais podem ser responsabilizados por danos, perdas, causas de ação, quer seja por contrato ou ato ilícito, ou outra ação tortuosa advinda do uso do Software ou outras ações relacionadas com este Software sem prévia autorização escrita do detentor dos direitos autorais.