Skip to content


Otras personalizaciones del SDK

Nivel de registro de Braze

El nivel de registro predeterminado para el SDK de Braze para iOS es mínimo, o 8 en la siguiente tabla. Este nivel suprime la mayoría de los registros para que no se registre ninguna información sensible en una aplicación lanzada en producción.

Consulta la siguiente lista de niveles de registro disponibles:

Niveles de registro

Nivel Descripción
0 Verboso. Toda la información de registro se registrará en la consola de iOS.
1 Depuración. La información de depuración y de registro superior se registrará en la consola de iOS.
2 Advertencia. La información de advertencia y de registro superior se registrará en la consola de iOS.
4 Error. Los errores y la información de registro superior se registrarán en la consola de iOS.
8 Mínimo. Se registrará información mínima en la consola de iOS. La configuración predeterminada del SDK.

Registro detallado

Puedes configurar el nivel de registro a cualquier valor disponible. Sin embargo, establecer el nivel de registro en verboso, o 0, puede ser muy útil para depurar problemas con tu integración. Este nivel solo está pensado para entornos de desarrollo y no debe establecerse en una aplicación publicada. El registro verboso no enviará ninguna información adicional o nueva del usuario a Braze.

Configuración del nivel de registro

El nivel de registro se puede asignar en tiempo de compilación o en tiempo de ejecución:

Añade un diccionario llamado Braze a tu archivo Info.plist. Dentro del diccionario Braze, añade la subentrada de cadena LogLevel y establece el valor en 0.

Ejemplo de contenidos de Info.plist:

1
2
3
4
5

<key>Braze</key>
<dict>
  <key>LogLevel</key>
  <string>0</string>
</dict>

Añade ABKLogLevelKey dentro del parámetro appboyOptions pasado a startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions:. Establece su valor en el número entero 0.

1
2
3
4
5
6

NSMutableDictionary *appboyOptions = [NSMutableDictionary dictionary];
appboyOptions[ABKLogLevelKey] = @(0);
[Appboy startWithApiKey:@"YOUR-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

1
2
3
4

let appboyOptions: [AnyHashable: Any] = [
  ABKLogLevelKey : 0
]
Appboy.start(withApiKey: "YOUR-API-KEY", in:application, withLaunchOptions:launchOptions, withAppboyOptions:appboyOptions)

Recopilación opcional de IDFV - Swift

En versiones anteriores del SDK de Braze para iOS Swift, el campo IDFV (identificador del proveedor) se recopilaba automáticamente como ID del dispositivo del usuario.

A partir de la versión 5.7.0 del SDK Swift, el campo IDFV puede desactivarse opcionalmente y, en su lugar, Braze establecerá un UUID aleatorio como ID del dispositivo. Para más información, consulta Recopilación de IDFV.

Recopilación opcional de IDFA

La recopilación de IDFA es opcional dentro del SDK de Braze y está deshabilitada de forma predeterminada. La recopilación de IDFA solo es necesaria en Braze si pretendes utilizar nuestras integraciones de atribución de instalación. Si optas por almacenar tu IDFA, lo haremos de forma gratuita, para que puedas aprovechar estas opciones inmediatamente después de la publicación, sin trabajo de desarrollo adicional.

Por ello, te recomendamos que sigas recopilando el IDFA si cumples alguno de los siguientes criterios:

  • Estás atribuyendo la instalación de la aplicación a un anuncio publicado anteriormente.
  • Estás atribuyendo una acción dentro de la aplicación a un anuncio servido previamente.

iOS 14.5 AppTrackingTransparency

Apple exige a los usuarios que se adhieran voluntariamente a través de un mensaje de permiso para recopilar IDFA.

Para recopilar IDFA, además de implementar nuestro protocolo ABKIDFADelegate, tu aplicación tendrá que solicitar autorización al usuario utilizando ATTrackingManager de Apple en el marco de transparencia de seguimiento de aplicaciones. Consulta el artículo sobre privacidad del usuario de Apple para obtener más información.

La solicitud de autorización de transparencia de seguimiento de la aplicación requiere una entrada en Info.plist para explicar el uso que haces del identificador:

1
2

<key>NSUserTrackingUsageDescription</key>
<string>To retarget ads and build a global profile to better serve you things you would like.</string>

Implementar la recopilación de IDFA

Sigue estos pasos para implementar la recopilación de IDFA:

Paso 1: Implementar ABKIDFADelegate

Crea una clase que se ajuste al protocolo ABKIDFADelegate:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

#import "IDFADelegate.h"
#import <AdSupport/ASIdentifierManager.h>
#import <AppTrackingTransparency/AppTrackingTransparency.h>

@implementation IDFADelegate

- (NSString *)advertisingIdentifierString {
  return [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
}

- (BOOL)isAdvertisingTrackingEnabledOrATTAuthorized {
  if (@available(iOS 14, *)) {
    return [ATTrackingManager trackingAuthorizationStatus] == ATTrackingManagerAuthorizationStatusAuthorized;
  }
  return [[ASIdentifierManager sharedManager] isAdvertisingTrackingEnabled];
}

@end

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

import Appboy_iOS_SDK
import AdSupport
import AppTrackingTransparency

class IDFADelegate: NSObject, ABKIDFADelegate {
   func advertisingIdentifierString() -> String {
    return ASIdentifierManager.shared().advertisingIdentifier.uuidString
  }

  func isAdvertisingTrackingEnabledOrATTAuthorized() -> Bool {
    if #available(iOS 14, *) {
      return ATTrackingManager.trackingAuthorizationStatus ==  ATTrackingManager.AuthorizationStatus.authorized
    }
    return ASIdentifierManager.shared().isAdvertisingTrackingEnabled
  }
}
Paso 2: Configura el delegado durante la inicialización de Braze

En el diccionario appboyOptions pasado a startWithApiKey:inApplication:withAppboyOptions:, establece la clave ABKIDFADelegateKey en una instancia de tu clase conforme a ABKIDFADelegate.

Tamaño aproximado del SDK de iOS

El tamaño de archivo aproximado del framework del SDK de iOS es de 30 MB, y el tamaño aproximado del .ipa (adición al archivo de la aplicación) está entre 1 MB y 2 MB.

Braze mide el tamaño de nuestro SDK para iOS observando el efecto del SDK en el tamaño del .ipa, según las recomendaciones de Apple sobre el tamaño de las aplicaciones. Si estás calculando la adición de tamaño del SDK de iOS a tu aplicación, te recomendamos seguir Obtener un informe del tamaño de la aplicación para comparar la diferencia de tamaño en tu .ipa antes y después de integrar el SDK de Braze para iOS. Cuando compares los tamaños del informe sobre el tamaño de las aplicaciones, te recomendamos que mires también los tamaños de las aplicaciones para los archivos .ipa reducidos, ya que los archivos universales .ipa serán mayores que los binarios descargados de la App Store e instalados en los dispositivos de los usuarios.
New Stuff!