Manifesto de privacidade

Se o SDK do Braze coletar dados de rastreamento, a Apple exige que você adicione um manifesto de privacidade que descreva o motivo e o método de coleta de dados de rastreamento.

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á vinculado a dados de terceiros (como publicidade direcionada) ou a um corretor de dados. Para obter 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 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 pontos de extremidade 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 do Braze

Etapa 1: Analise suas políticas atuais

Revise as políticas atuais de coleta de dados do SDK do 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: Criar 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 verifique Chaves e Valores Brutos.

Em Configuração de privacidade do app, escolha NSPrivacyTracking e defina seu valor como SIM.

Em Configuração de privacidade do app, escolha NSPrivacyTrackingDomains. Na matriz de domínios, adicione um novo elemento e defina seu valor como o ponto de extremidade que você adicionou anteriormente ao seu AppDelegate, prefixado com sdk-tracking.

Etapa 4: Declare seus dados de rastreamento

Em seguida, abra o site 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:

• exemplo estático
• exemplo dinâmico

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: Evitar 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)
    }
}