Show Menu
SUJETS×

Méthodes de configuration

Voici une liste des méthodes fournies par la bibliothèque iOS.
Le SDK prend actuellement en charge plusieurs solutions Adobe Experience Cloud, notamment Analytics, Target, Audience Manager, ainsi que le service d’identification Adobe Experience Platform.
  • setAppExtensionType
    Configure le paramètre du SDK Adobe Mobile de façon à déterminer le type d’extension en cours d’exécution.
    Valeurs possibles :
    • ADBMobileAppExtensionTypeRegular - l’extension est regroupée avec une application contenante.
    • ADBMobileAppExtensionTypeStandAlone - l’extension n’est pas regroupée avec une application contenante.
    Utilisez cette méthode uniquement si votre application possède une extension ou est une extension autonome. Pour plus d’informations, voir ADBMobileAppExtensionType ci-dessous.
    • Voici la syntaxe de cette méthode :
      + (void) setAppExtensionType:(ADBMobileAppExtensionType)type;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile setAppExtensionType:ADBMobileAppExtensionTypeStandAlone]; 
      
      
  • version
    Renvoie la version actuelle de la bibliothèque Adobe Mobile.
    • Voici la syntaxe de cette méthode :
      +(NSString*) version;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSString*libraryVersion = [ADBMobileversion];
      
      
  • privacyStatus
    Renvoie la représentation d’énumération de l’état de confidentialité pour l’utilisateur actuel :
    • ADBMobilePrivacyStatusOptIn  : les accès sont immédiatement envoyés.
    • ADBMobilePrivacyStatusOptOut - les accès sont ignorés.
    • ADBMobilePrivacyStatusUnknown  : si le suivi hors ligne est activé, les accès sont enregistrés jusqu’à ce que l’état de confidentialité soit défini sur inclusion (les accès sont envoyés) ou sur exclusion (les accès sont ignorés). Si le suivi hors ligne n’est pas activé, les accès sont ignorés jusqu’à ce que l’état de confidentialité soit défini sur inclusion (opt-in). La valeur par défaut est définie dans le fichier ADBMobileConfig.json .
    • Voici la syntaxe de cette méthode :
      + (ADBMobilePrivacyStatus) privacyStatus;
      
      
    • Voici l’exemple de code pour cette méthode :
      ADBMobilePrivacyStatus privacyStatus = [ADBMobileprivacyStatus];
      
      
  • setPrivacyStatus
    Définit l’état de confidentialité pour l’utilisateur actuel sur status .
    Valeurs possibles :
    • ADBMobilePrivacyStatusOptIn  : les accès sont immédiatement envoyés.
    • ADBMobilePrivacyStatusOptOut - les accès sont ignorés.
    • ADBMobilePrivacyStatusUnknown  : si le suivi hors ligne est activé, les accès sont enregistrés jusqu’à ce que l’état de confidentialité soit défini sur inclusion (les accès sont envoyés) ou sur exclusion (les accès sont ignorés). Si le suivi hors ligne n’est pas activé, les accès sont ignorés jusqu’à ce que l’état de confidentialité soit défini sur inclusion (opt-in).
    • Voici la syntaxe de cette méthode :
      + (void) setPrivacyStatus:(ADBMobilePrivacyStatus)status;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile setPrivacyStatus:ADBMobilePrivacyStatusOptIn];
      
      
  • lifetimeValue
    Renvoie la valeur du cycle de vie de l’utilisateur actuel. La valeur par défaut est 0 .
    • Voici la syntaxe de cette méthode :
      + (NSDecimalNumber *) lifetimeValue;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSDecimalNumber *lifeValue = [ADBMobile lifetimeValue];
      
      
  • trackingIdentifier
    Renvoie l’identifiant visiteur généré automatiquement. Il s’agit d’un identifiant visiteur unique propre à l’application qui est généré par les serveurs d’Adobe. Si les serveurs d’Adobe ne sont pas joignables au moment de la génération, l’identifiant est généré au moyen du CFUUID d’Apple. La valeur est générée au lancement initial, puis stockée et utilisée par la suite. Cet identifiant est conservé entre les mises à niveau de l’application, enregistré et restauré lors du processus de sauvegarde de l’application standard, puis supprimé lors de la désinstallation.
    Si votre application est mise à niveau du SDK Experience Cloud 3.x vers 4.x, l’identifiant visiteur précédent (personnalisé ou généré automatiquement) est récupéré et stocké en tant qu’identifiant utilisateur personnalisé. Pour plus d’informations, voir la ligne userIdentifier ci-dessous. Ceci permet de conserver les données visiteur entre les différentes mises à niveau du SDK. Pour les nouvelles installations sur le SDK 4.x, l’identifiant de l’utilisateur a la valeur nil et l’identifiant de suivi est utilisé.
    • Voici la syntaxe de cette méthode :
      + (NSString *) trackingIdentifier;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSString *tid = [ADBMobile trackingIdentifier];
      
      
  • userIdentifier
    Si un identifiant personnalisé a été défini, l’identifiant de l’utilisateur est renvoyé. Si aucun identifiant personnalisé n’est défini, la valeur nil est renvoyée. La valeur par défaut est nil .
    Si votre application est mise à niveau du SDK Experience Cloud 3.x vers 4.x, l’identifiant visiteur précédent (personnalisé ou généré automatiquement) est récupéré et stocké en tant qu’identifiant utilisateur personnalisé. Cela permet de conserver les données du visiteur entre les mises à niveau du SDK.
    Pour les nouvelles installations sur le SDK 4.x, l’identifiant de l’utilisateur a la valeur nil tant qu’il n’a pas été défini.
    • Voici la syntaxe de cette méthode :
      +(NSString *) userIdentifier;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSString *uid = [ADBMobileuserIdentifier];
      
      
  • setUserIdentifier
    Définit l’identifiant d’utilisateur sur identifier .
    • Voici la syntaxe de cette méthode :
      +(void)setUserIdentifier:(NSString*)identifier;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile setUserIdentifier:@"billybob"]; 
      
      
  • debugLogging
    Renvoie la préférence de consignation de débogage actuelle. La valeur par défaut est NO .
    • Voici la syntaxe de cette méthode :
      + (BOOL) debugLogging;
      
      
    • Voici l’exemple de code pour cette méthode :
      BOOL debugging = [ADBMobile debugLogging];
      
      
  • setDebugLogging
    Définit la préférence de journalisation de débogage sur debug .
    • Voici la syntaxe de cette méthode :
      + (void) setDebugLogging:(BOOL)debug;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile setDebugLogging:YES];
      
      
  • keepLifecycleSessionAlive
    Indique au SDK que la prochaine reprise depuis l’arrière-plan ne doit pas commencer une nouvelle session, quelle que soit la valeur de temporisation de la session du cycle de vie dans le fichier de configuration.
    Cette méthode est conçue pour les applications qui s’inscrivent aux notifications quand elles sont en arrière-plan et doit uniquement être appelée depuis le code qui s’exécute pendant que votre application se trouve en arrière-plan.
    • Voici la syntaxe de cette méthode :
      + (void) keepLifecycleSessionAlive;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile keepLifecycleSessionAlive]; 
      
      
  • collectLifecycleData
    Indique au SDK que les données du cycle de vie doivent être collectées pour être utilisées à l’échelle de toutes les solutions dans le SDK. Pour en savoir plus, voir la section Mesures de cycle de vie .
    L’emplacement privilégié pour appeler cette méthode se trouve dans application:didFinishLaunchingWithOptions: .
    • Voici la syntaxe de cette méthode :
      + (void) collectLifecycleData;
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile collectLifecycleData];
      
      
  • collectLifecycleDataWithAdditionalData:
    Vous permet de transmettre des données supplémentaires lors de la collecte de mesures de cycle de vie.
    Cette méthode doit être appelée à partir du point d’entrée de votre application. Le cas échéant, la ou les méthodes application:didFinishLaunchingWithOptions: et/ou applicationWillEnterForeground: peuvent être incluses dans votre classe AppDelegate.
    Les données transmises au SDK par l’intermédiaire de collectLifecycleDataWithAdditionalData: sont conservées dans NSUserDefaults par le SDK. Le SDK supprime du paramètre NSDictionary les valeurs qui ne sont pas de type NSString ou NSNumber . Pour utiliser collectLifecycleDataWithAdditionalData: , vous devez disposer de la version 4.4 ou supérieure du SDK.
    • Voici la syntaxe de cette méthode :
      + (void) collectLifecycleDataWithAdditionalData:(nullableNSDictionary*)data; 
      
      
    • Voici l’exemple de code pour cette méthode :
      [ADBMobile collectLifecycleDataWithAdditionalData:@{@"entryType":@"appShortcutIcon"}]; 
      
      
  • overrideConfigPath
    Vous permet de charger un fichier de configuration JSON ADBMobile distinct au démarrage de l’application. Cette autre configuration est utilisée jusqu’à la fermeture de l’application.
    Pour utiliser overrideConfigPath , vous devez disposer de la version 4.2 ou supérieure du SDK.
    • Voici la syntaxe de cette méthode :
       + (void) overrideConfigPath: (nullableNSString *) path;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSString *filePath = [[NSBundle mainBundle] pathForResource:@"ExampleJSONFile" ofType:@"json"]; 
      [ADBMobile overrideConfigPath:filePath];
      
      
  • setPushIdentifier
    Définit le jeton d’appareil pour les notifications Push.
    Cette méthode doit uniquement être utilisée dans la méthode application:didRegisterForRemoteNotificationsWithDeviceToken: .
    • Voici la syntaxe de cette méthode :
      + (void) setPushIdentifier:(NSData *)deviceToken;
      
      
    • Voici l’exemple de code pour cette méthode :
      - (void) application:(UIApplication *) application  didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 
      [ADBMobile setPushIdentifier:deviceToken];  
      }
      
      
  • setAdvertisingIdentifier
    Définit l’IDFA dans le SDK. L’IDFA est envoyé dans le cycle de vie s’il a été défini dans le SDK. Il est également accessible dans Signals (Signaux) (Postbacks).
    Vous devez récupérer l’IDFA d’API Apple uniquement si vous utilisez un service publicitaire. Si vous récupérez l’IDFA, mais ne l’utilisez pas correctement, il est possible que votre application soit rejetée.
    • Voici la syntaxe de cette méthode :
      +(void) setAdvertisingIdentifier:(NSString*)identifier;
      
      
    • Voici l’exemple de code pour cette méthode :
      NSString *idfa = [[[ASIdentifierManager sharedManager]advertisingIdentifier] UUIDString]; 
      [ADBMobile setAdvertisingIdentifier:idfa]; 
      
      

ADBMobileAppExtensionType enum

/** 
 * @brief An enum type. 
 * The possible types of app extension you might use 
 * @see setAppExtensionType 
 */ 
typedef NS_ENUM(NSUInteger, ADBMobileAppExtensionType) { 
    ADBMobileAppExtensionTypeRegular = 0, /*!< Enum value ADBMobileAppExtensionTypeRegular. */ 
    ADBMobileAppExtensionTypeStandAlone = 1 /*!< Enum value ADBMobileAppExtensionTypeStandAlone. */ 
};