Gerenciar a coleta de dados

Manifesto de privacidade da Apple

O que são dados de rastreamento?

A Apple define “dados de rastreamento” como os dados coletados em seu app sobre um usuário final ou dispositivo que estão vinculados a dados de terceiros (como publicidade direcionada) ou a um corretor de dados. Para uma definição completa com exemplos, consulte Apple: Rastreamento.

Por padrão, o SDK da Braze não coleta dados de rastreamento. No entanto, dependendo da configuração do SDK da Braze, talvez seja necessário listar dados específicos da Braze no manifesto de privacidade do seu app.

O que é um manifesto de privacidade?

Um manifesto de privacidade é um arquivo em seu projeto Xcode que descreve o motivo pelo qual seu app e SDKs de terceiros coletam dados, juntamente com seus métodos de coleta de dados. Cada um dos seus SDKs de terceiros que rastreiam dados exige seu próprio manifesto de privacidade. Quando você cria o relatório de privacidade do seu app, esses arquivos de manifesto de privacidade são automaticamente agregados em um único relatório.

Domínios de dados de rastreamento da API

A partir do iOS 17.2, a Apple bloqueará todos os endpoints de rastreamento declarados em seu app até que o usuário final aceite um aviso de Transparência de Rastreamento de Anúncios (ATT). A Braze fornece endpoints de rastreamento para encaminhar seus dados de rastreamento e, ao mesmo tempo, permite que você encaminhe dados primários que não sejam de rastreamento para o endpoint original.

Declaração de dados de rastreamento da Braze

Pré-requisitos

A seguinte versão do SDK da Braze é necessária para implementar esse recurso:

Etapa 1: Analise suas políticas atuais

Revise as políticas atuais de coleta de dados do SDK da Braze com sua equipe jurídica para determinar se o seu app coleta dados de rastreamento conforme definido pela Apple. Se não estiver coletando dados de rastreamento, não é necessário personalizar seu manifesto de privacidade para o SDK da Braze neste momento. Para saber mais sobre as políticas de coleta de dados do SDK da Braze, consulte Coleta de dados do SDK.

Etapa 2: Crie um manifesto de privacidade

Primeiro, verifique se você já tem um manifesto de privacidade procurando um arquivo PrivacyInfo.xcprivacy em seu projeto Xcode. Se você já tiver esse arquivo, prossiga para a próxima etapa. Caso contrário, consulte Apple: Crie um manifesto de privacidade.

Etapa 3: Adicione seu endpoint ao manifesto de privacidade

Em seu projeto Xcode, abra o arquivo PrivacyInfo.xcprivacy do app, clique com o botão direito do mouse na tabela e marque Raw Keys and Values.

Em App Privacy Configuration, escolha NSPrivacyTracking e defina seu valor como YES.

Em App Privacy Configuration, escolha NSPrivacyTrackingDomains. Na matriz de domínios, adicione um novo elemento e defina seu valor como o endpoint que você adicionou anteriormente ao seu AppDelegate, prefixado com sdk-tracking.

Etapa 4: Declare seus dados de rastreamento

Em seguida, abra o AppDelegate.swift e liste cada propriedade de rastreamento que deseja declarar, criando uma lista de rastreamento estática ou dinâmica. Lembre-se de que a Apple bloqueará essas propriedades até que o usuário final aceite o prompt de ATT. Portanto, liste apenas as propriedades que você e sua equipe jurídica consideram rastreamento. Por exemplo:

• static example
• dynamic example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import UIKit
import BrazeKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

  static var braze: Braze? = nil

  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    let configuration = Braze.Configuration(apiKey: brazeApiKey, endpoint: brazeEndpoint)
    // Declare which types of data you wish to collect for user tracking.
    configuration.api.trackingPropertyAllowList = [
      .dateOfBirth,
      .customEvent(["event-1"]),
      .customAttribute(["attribute-1", "attribute-2"])
    ]
    let braze = Braze(configuration: configuration)
    AppDelegate.braze = braze
    return true
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
func applicationDidBecomeActive(_ application: UIApplication) {
  // Request and check your user's tracking authorization status.
  ATTrackingManager.requestTrackingAuthorization { status in
    // Let Braze know whether user data is allowed to be collected for tracking.
    let enableAdTracking = status == .authorized
    AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)

    // Add the `.firstName` and `.lastName` properties, while removing the `.everything` configuration.
    AppDelegate.braze.updateTrackingAllowList(
      adding: [.firstName, .lastName],
      removing: [.everything]
    )
  }
}

Etapa 5: Evite loops de repetição infinitos

Para evitar que o SDK entre em um loop infinito de repetição, use o método set(adTrackingEnabled: enableAdTracking) para lidar com as permissões de ATT. A propriedade adTrackingEnabled em seu método deve ser tratada de forma semelhante à seguinte:

1
2
3
4
5
6
7
8
func applicationDidBecomeActive(_ application: UIApplication) {
    // Request and check your user's tracking authorization status.
    ATTrackingManager.requestTrackingAuthorization { status in
      // Let Braze know whether user data is allowed to be collected for tracking.
      let enableAdTracking = status == .authorized
      AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)
    }
}

Desativar o rastreamento de dados

Para desativar a atividade de rastreamento de dados no Swift SDK, defina a propriedade enabled como false na sua instância da Braze. Quando enabled é definido como false, o SDK da Braze ignora qualquer chamada para a API pública. O SDK também cancela todas as ações em andamento, como solicitações de rede, processamento de eventos, etc.

Limpeza de dados armazenados anteriormente

Você pode usar o método wipeData() para limpar completamente os dados do SDK armazenados localmente no dispositivo de um usuário.

Para as versões 7.0.0 e posteriores do Braze Swift, o SDK e o método wipeData() geram aleatoriamente um UUID para o ID do dispositivo. No entanto, se o seu useUUIDAsDeviceId estiver definido como false ou se estiver usando o Swift SDK versão 5.7.0 ou anterior, também será necessário fazer uma solicitação POST para /users/delete, já que o seu IDFV (Identifier for Vendors) será automaticamente usado como o ID do dispositivo desse usuário.

Se você usa integração manual de push e seu app chama wipeData() e depois reativa o SDK na mesma execução do app, chame registerForRemoteNotifications() novamente para que a Braze possa receber um token de dispositivo atualizado. Para saber mais, consulte configuração de notificações por push.

Retomada do rastreamento de dados

Para retomar a coleta de dados, defina enabled como true. Lembre-se de que isso não restaurará nenhum dado apagado anteriormente.

Coleta de IDFV

Nas versões anteriores do SDK da Braze para iOS, o campo IDFV (Identifier for Vendor) era coletado automaticamente como o ID do dispositivo do usuário. A partir do Swift SDK v5.7.0, o campo IDFV passou a poder ser desativado opcionalmente e, em vez disso, a Braze definia um UUID aleatório como o ID do dispositivo. A partir do Swift SDK v7.0.0, o campo IDFV não é coletado por padrão, e um UUID é definido como o ID do dispositivo.

O recurso useUUIDAsDeviceId configura o Swift SDK para definir o ID do dispositivo como um UUID. Tradicionalmente, o SDK do iOS atribuía o ID do dispositivo igual ao valor IDFV gerado pela Apple. Com esse recurso ativado por padrão em seu app iOS, todos os novos usuários criados por meio do SDK receberão um ID de dispositivo igual a um UUID.

Se você ainda quiser coletar o IDFV separadamente, poderá usar set(identifierforvendor:).

Considerações

Versão do SDK

No Swift SDK v7.0.0+, quando useUUIDAsDeviceId estiver ativado (padrão), todos os novos usuários criados receberão um ID de dispositivo aleatório. Todos os usuários existentes manterão o mesmo valor de ID do dispositivo, que pode ter sido IDFV.

Quando esse recurso não estiver ativado, os dispositivos continuarão a receber o IDFV no momento da criação.

Downstream

Parceiros de tecnologia: Quando esse recurso estiver ativado, todos os parceiros de tecnologia que derivam o valor IDFV do ID do dispositivo da Braze não terão mais acesso a esses dados. Se o valor IDFV derivado do dispositivo for necessário para a integração com parceiros, recomendamos que você defina esse recurso como false.

Currents: useUUIDAsDeviceId definido como true significa que o ID do dispositivo enviado no Currents não será mais igual ao valor IDFV.

Perguntas frequentes

Essa mudança afetará meus usuários existentes na Braze?

Não. Quando ativado, esse recurso não substituirá nenhum dado de usuário na Braze. Novos IDs de dispositivo UUID serão criados apenas para novos dispositivos ou quando wipedata() for chamado.

Posso desativar esse recurso depois de ativá-lo?

Sim, esse recurso pode ser ativado e desativado a seu critério. Os IDs de dispositivos armazenados anteriormente nunca serão substituídos.

Ainda posso capturar o valor do IDFV pela Braze em outro lugar?

Sim, você ainda pode coletar opcionalmente o IDFV por meio do Swift SDK (a coleta está desativada por padrão).