SDK iOS Objective-C

SDK iOS Objective-C

Donne accès à l'ensemble des fonctionnalités Critizr pour vos applications iOS.

Le SDK iOS vous permet :

Installation

  • [Ajoutez le SDK] Ajoutez la ligne suivante à votre Podfile.
    pod 'Critizr-ios', '~> 1.2.3’
  • Executer la commande
    pod install
  • Importez le fichier headers Critizr.h avant d’appeler des méthodes sur le SDK :
    #import <Critizr/Critizr.h>
  • Renseignez l’APIKey Critizr dans le fichier info.plist avant d’appeler des méthodes sur le SDK :
    <key>CritizrAPIKey</key>
    <string>7f614697ac3524af3ca4ce0df9164caf</string>
  • Renseignez l’environnement Critizr dans le fichier info.plist avant d’appeler des méthodes sur le SDK (n’oubliez pas de la remplacer par la votre) :
    <key>CritizrEnvironement</key>
    <string>PreProduction</string> ou <string>Production</string>

Captures d’écran

Démo

Vous téléchargez un sample illustrant les différents cas d’utilisations du SDK.

Exemple d’utilisation

#import <Critizr/Critizr.h>

// Lancer une modale d'envoi de feedbacks sur le point de vente "velo-aix-en-provence":
// Il est possible de lancer la modal sans paramètre en passant NULL comme paramètre:
CRFeedbackDialog *feedbackDialog = [CRFeedbackDialog feedbackDialog];
NSString *storeID = @"velo-aix-en-provence";
NSDictionary *params = @{
	@"mode" : @"feedback",
	@"user" : @"YXJuYXVkfGFybmF1ZC5sYW5jZWxvdEBjcml0aXpyLmNvbQ==" 
	// user correspond à arnaud|arnaud.lancelot@critizr.com encodé en BASE64
};
[feedbackDialog presentFeedbackDialogFrom:self withParams:params];

Référence

CRFeedbackDialog / CRFeedbackDialogDelegate : lancer des interfaces

CRFeedbackDialog

+ (CRFeedbackDialog *) feedbackDialog

Retourne une instance de CRFeedbackDialog que vous pourrez utiliser pour lancer des interfaces Critizr.

[CRFeedbackDialog feedbackDialog];

- (void) presentFeedbackDialogFrom: (UIViewController *)viewController

Lance l’interface Store Locator sous forme de modale, à l’aide du UIViewController indiqué. L’utilisateur sera donc invité à choisir le point de vente auquel envoyer ses feedbacks.

[feedbackDialog presentFeedbackDialogFrom:self withParams:NULL];

- (void) presentFeedbackDialogFrom:(UIViewController *)viewController WithStoreId:(int)storeId

Lance l’interface Envoi de Feedback sous forme de modale, à l’aide du UIViewController indiqué, pour le point de vente storeId.

int storeID = 12;
[feedbackDialog presentFeedbackDialogFrom:self withStoreId:storeID withParams:NULL];

- (void) presentFeedbackDialogFrom:(UIViewController *)viewController WithStoreIdString:(NSString *)storeId

Lance l’interface Envoi de Feedback sous forme de modale, à l’aide du UIViewController indiqué, pour le point de vente storeId.

NSString *storeID = @"velo-aix-en-provence";
[feedbackDialog presentFeedbackDialogFrom:self withStoreIdString:storeID withParams:NULL];

CRFeedbackDialogDelegate

Votre UIViewController peut adhérer au protocole CRFeedbackDialogDelegate et ainsi être informé d’évènements concernant vos CRFeedbackDialog via l’appel des méthodes suivantes :

- (void) feedbackDialogDidCloseWithMessageSent: (BOOL)messageSent

Méthode appelée lorsque l’interface d’envoi de feedback s’est terminée. Si une remarque a été envoyée par l’utilisateur pendant le processus, messageSent aura comme valeur YES.

CRSdk / CRSdkDelegate : Récupérer des données

CRSDK

+ (CRSdk *) critizrSDKInstanceWithAPIKey: (NSString *)apiKey andDelegate: (id<CRSdkDelegate>)delegate;

Retourne une instance de CRSdk que vous pourrez utiliser pour récupérer des données relatives à Critizr.

CRSdk *sdk = [CRSdk critizrSDKInstance:self];

- (void) fetchRatingForPlace:(NSString *)aPlaceId withDelegate:(id<CRSdkDelegate>)aDelegate;

Permet de récupérer la note de relation client attribuée à un point de vente d’id aPlaceId. Cette méthode est asynchrone : lorsque la note de relation client est récupérée, la méthode critizrPlaceRatingFetched du CRSdkDelegate est appelée.

NSString *storeID = @"velo-aix-en-provence";
[sdk fetchRatingForPlace:storeID withDelegate:self];

CRSDKDelegate

Votre UIViewController (ou n’importe quelle classe) peut adhérer au protocole CRSdkDelegate, pour se voir appeler les méthodes suivantes :

-(void) critizrPlaceRatingFetched:(double)aPlaceRating

Méthode appelée en réponse à la méthode fetchRatingForPlace:withDelegate: de CRSdk. aPlaceRating correspond donc à la note de relation client du point de vente que vous aviez spécifié.

-(void) critizrPlaceRatingError:(NSError *)anError

Méthode appelée en réponse à la méthode fetchRatingForPlace:withDelegate:, dans le cas où une erreur est survenue.