API d’identification d’écran mobile

Last Updated novembre 29, 2022

Download as PDF

Aperçu général

Le SDK WalkMe Mobile peut utiliser un écran en tant que variable disponible pour la segmentation et les objectifs basés sur les règles. Le SDK utilise également des écrans au sein d'un contexte dans lequel un élément est capturé, afin de pouvoir l'identifier ultérieurement.

À partir de la version 1.18.0, vous pouvez utiliser l'API setScreenID pour définir le contexte le plus précis pour WalkMe en fonction du comportement de votre application et des cas d'utilisation.

Il est important de noter que si l'API est utilisée pour identifier un écran, WalkMe ne tentera pas d'identifier les écrans en utilisant l'algorithme régulier au fur et à mesure qu'ils changent, il est de la responsabilité du développeur de s'assurer que l'ID d'écran est correctement défini et de réinitialiser quand l'écran change. Si un ID d'écran n'est pas réinitialisé, WalkMe continuera d'utiliser le dernier identifiant d'écran défini dans l'application, ce qui peut causer des perturbations dans le comportement de WalkMe.

Pour cette raison, il est conseillé d'utiliser l'API setScreenID uniquement lors de l'identification d'un besoin unique, et avec beaucoup d'attention.

Comment mettre en œuvre l'API d'identification d'écran

Applications Android

Pour définir un ID d'écran, appelez l'API setScreenId avec un ID unique dans onResume() , et appelez-la à nouveau avec une valeur nulle dans onPause() .

/**
*  Set ID for a specific screen.
*  When used, this should be called every time the screen shows
*
*   @param screenID the ID to set for a specific screen
*
**/

public static void setScreenID(String screenID)

Applications iOS

Pour définir un ID d'écran, appelez l'API setScreenId avec un id unique dans viewWillAppear , et appelez-la à nouveau avec une valeur nulle dans viewWillDisappear pour réinitialiser la valeur au fur et à mesure que l'écran change.

/**
* Set ID for a specific screen.
*/
+ (void)setScreenID:(NSString *)screenID;

Exemples d'utilisation d'iOS :

[ABBI setScreenID:@"my_unique_screen_id"];

ABBI.setScreenID("my_unique_screen_id")