SDK Android

SDK Android

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

Le SDK Android vous permet :

Installation

Manuellement

Téléchargez le SDK de pre-production ou production

  • Ajouter le fichier dans un dossier libs/ à la racine de votre module.
  • Ajouter la ligne suivante dans la partie dependencies du builde.gradle de votre module en remplacant [env] et [version] par celles du SDK téléchargé :
	repositories {
	   flatDir {
	       dirs 'libs'
	   }
	}

	dependencies {
	   compile name:'critizr-sdk-[env]-[version]', ext:'aar'
	}
	

Implémentation

  • Vérifiez la présence des permissions suivantes dans votre fichier Manifest :
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  • Ajoutez l’activité suivante dans votre fichier Manifest :
  <activity android:name="com.CritizrSDK.CritizrActivity"/>
  • Récupérez une instance de CritizrSDK à l’aide de votre API Key Critizr. Vous appellerez les différentes méthodes du SDK sur cette instance.
  CritizrSDK critizrSDK = CritizrSDK.getInstance(apiKey);

Captures d’écran

Démo

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

Exemple d’utilisation

// 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:
CritizrSDK critizrSDK = CritizrSDK.getInstance(CRITIZR_API_KEY);
JSONObject object = new JSONObject();
try {
   object.put("mode", "quiz");
   object.put("user", "YXJuYXVkfGFybmF1ZC5sYW5jZWxvdEBjcml0aXpyLmNvbQ=="); 
   // user correspond à arnaud|arnaud.lancelot@critizr.com encodé en BASE64
} catch (JSONException e) {
   e.printStackTrace();
}
critizrSDK.openFeedbackActivity(this, this, "velo-aix-en-provence", object);

Référence

class CritizrSDK

public void openFeedbackActivity(Context context, CritizrListener aListener, JSONObject parameters)

Lance l’interface Store Locator dans une nouvelle activité. Ainsi, l’utilisateur est invité à choisir le point de vente auquel envoyer ses feedbacks.

L’activité est liée à un CritizrListener qui écoutera des évènements concernant cette activité.

  critizrSdk.openFeedbackActivity(this, this, null);
  

public void openFeedbackActivity(Context context, CritizrListener aListener, int placeId, JSONObject parameters)

Lance l’interface d’Envoi de Feedbacks dans une nouvelle activité pour le point de vente donné par placeId. L’activité est liée à un CritizrListener qui écoutera des évènements concernant cette activité.

  critizrSdk.openFeedbackActivity(this, this, 12, null);

public void openFeedbackActivity(Context context, CritizrListener aListener, String placeId, JSONObject parameters)

Comme précédemment, sauf que vous passez placeId sous forme de String.

  critizrSdk.openFeedbackActivity(this, this, "velo-aix-en-provence", null);

public void getPlaceRating(String placeId, CritizrListener aListener)

Permet de récupérer la note de relation client attribuée à un point de vente d’id placeId. Cette méthode est asynchrone : lorsque la note de relation client est récupérée, la méthode [onRatingResult] du CritizrListener est appelée.

  critizrSdk.getPlaceRating("velo-aix-en-provence", this);

interface CritizrListener

Votre activité (ou tout autre classe de votre application) peut implémenter l’interface CritizrListener. Ainsi, elle pourra se voir appeler les méthodes suivantes :

public void onFeedbackSent()

Méthode appelée lorsque l’interface d’envoi de feedback s’est terminée avec succès (une remarque a bien été envoyée).

public void onRatingResult(double rating)

Méthode appelée en réponse à la méthode getPlaceRating de CritizrSDK. rating correspond donc à la note de relation client du point de vente que vous aviez spécifié.

public void onRatingError()

Méthode appelée en cas d’erreur lors de l’appel à la méthode getPlaceRating de CritizrSDK.