Skip to content


Autres personnalisations du SDK

Niveau de journalisation de Braze

Le niveau de journalisation par défaut du SDK Braze pour iOS est minimal, soit 8 dans le tableau suivant. Ce niveau supprime la majeure partie de la journalisation afin qu’aucune information sensible ne soit consignée dans une application publiée en production.

Consultez la liste suivante des niveaux de journalisation disponibles :

Niveaux de journalisation

Niveau Description
0 Prolixe. Toutes les informations de journalisation seront consignées dans la console iOS.
1 Débogage. Les informations de débogage et de niveau supérieur seront consignées dans la console iOS.
2 Avertissement. Les informations d’avertissement et de niveau supérieur seront consignées dans la console iOS.
4 Erreur. Les informations d’erreur et de niveau supérieur seront consignées dans la console iOS.
8 Minimal. Les informations minimales seront consignées dans la console iOS. Paramètre par défaut du SDK.

Journalisation prolixe

Vous pouvez configurer le niveau de journalisation sur n’importe quelle valeur disponible. Cependant, définir le niveau de journalisation sur prolixe, soit 0, peut s’avérer très utile pour déboguer les problèmes liés à votre intégration. Ce niveau est uniquement destiné aux environnements de développement et ne doit pas être activé dans une application publiée. La journalisation prolixe n’enverra aucune information supplémentaire ou nouvelle sur l’utilisateur à Braze.

Réglage du niveau de journalisation

Le niveau de journalisation peut être défini soit au moment de la compilation, soit au moment de l’exécution :

Ajoutez un dictionnaire nommé Braze à votre fichier Info.plist. À l’intérieur du dictionnaire Braze, ajoutez la sous-entrée de type chaîne de caractères LogLevel et définissez la valeur sur 0.

Exemple de contenu Info.plist :

1
2
3
4
5

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

Ajoutez ABKLogLevelKey dans le paramètre appboyOptions transmis à startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions:. Définissez sa valeur sur l’entier 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)

Collecte IDFV facultative - Swift

Dans les versions antérieures du SDK Swift iOS de Braze, le champ IDFV (identifiant du fournisseur) était automatiquement collecté en tant qu’ID d’appareil de l’utilisateur.

À partir du SDK Swift v5.7.0, le champ IDFV peut être désactivé de manière facultative et Braze générera à la place un UUID aléatoire en tant qu’ID d’appareil. Pour plus d’informations, reportez-vous à la section Collecte de l’IDFV.

Collecte IDFA facultative

La collecte IDFA est facultative dans le SDK Braze et désactivée par défaut. La collecte IDFA n’est requise dans Braze que si vous avez l’intention d’utiliser nos intégrations d’attribution d’installation. Si vous choisissez de stocker votre IDFA, nous le stockerons gratuitement, afin que vous puissiez profiter de ces options dès leur disponibilité sans travail de développement supplémentaire.

Par conséquent, nous vous recommandons de continuer à collecter l’IDFA si vous remplissez l’un des critères suivants :

  • Vous attribuez l’installation de l’application à une publicité déjà diffusée
  • Vous attribuez une action dans l’application à une publicité déjà diffusée

iOS 14.5 AppTrackingTransparency

Apple exige que les utilisateurs donnent leur consentement via une invite d’autorisation pour collecter l’IDFA.

Pour collecter l’IDFA, outre l’implémentation de notre protocole ABKIDFADelegate, votre application devra demander l’autorisation de l’utilisateur en utilisant le ATTrackingManager d’Apple dans le cadre de transparence du suivi des applications. Pour plus d’informations, reportez-vous à l’article d’Apple sur la protection de la vie privée des utilisateurs.

L’invite d’autorisation de transparence du suivi des applications nécessite une entrée Info.plist pour expliquer votre utilisation de l’identifiant :

1
2

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

Implémentation de la collecte IDFA

Suivez ces étapes pour implémenter la collecte IDFA :

Étape 1 : Implémenter ABKIDFADelegate

Créez une classe conforme au protocole 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
  }
}
Étape 2 : Définir le délégué lors de l’initialisation de Braze

Dans le dictionnaire appboyOptions transmis à startWithApiKey:inApplication:withAppboyOptions:, définissez la clé ABKIDFADelegateKey sur une instance de votre classe conforme à ABKIDFADelegate.

Taille approximative du SDK iOS

La taille approximative du fichier du framework du SDK iOS est de 30 Mo, et la taille approximative du .ipa (ajout au fichier de l’application) est comprise entre 1 Mo et 2 Mo.

Braze mesure la taille de son SDK iOS en observant l’effet du SDK sur la taille du .ipa, conformément aux recommandations d’Apple sur le dimensionnement des applications. Si vous calculez l’ajout de taille du SDK iOS à votre application, nous vous recommandons de suivre Obtenir un rapport sur la taille de l’application pour comparer la différence de taille de votre .ipa avant et après l’intégration du SDK Braze pour iOS. Lorsque vous comparez les tailles à partir du rapport d’amincissement des applications, nous vous recommandons également d’examiner les tailles d’applications pour les fichiers .ipa allégés, car les fichiers .ipa universels seront plus volumineux que les binaires téléchargés depuis l’App Store et installés sur les appareils des utilisateurs.
New Stuff!