CustomersChoice

CustomersChoice copied to clipboard

#CustomersChoice

This library can be used to make simple usability tests on live Android applications, so you can find the best choice, if you have two or more different solutions. The Customer choose the best solution. For Example, if it is better to have a red or blue purchase button.

You can check some features in the Customer's Choice Demo.

##USAGE The library is really esy to use, if it is configured.

CustomersChoice.getVariant(context,"Variant name");

###adding a Variant by code with a spreading of 50:50 with CustomersChoice.addVariant(Variant)

CustomersChoice.addVariant(new VariantBuilder("Variant name").setSpreading(new int[] { 50, 50 }).build());

###JSON structure for configurations

 { 
   "resetAll": true,
   "variants": [
     {
       "startTime": 51,
       "endTime": 53,
       "spreading": [ 1, 2 ],
       "name": "Variant1",
       "reset": true
     },
     {
       "endTime": 53,
       "spreading": [ 3, 3 ],
       "name": "Variant2"
     }
   ]
 }

global attribute

• resetAll - Resets all variants, so it can be determined again

attributes

• name - reqiured name as String
• startTime - in Milliseconds from midnight, January 1, 1970 UTC
• endTime - in Milliseconds from midnight, January 1, 1970 UTC
• spreading - integer definition of ratio between the possible variants. The amount of definition defines the amount of possible variants.
• reset - resets the the Variant, so it can be determined again

###adding several Variants by a String resource with CustomersChoice.configureByResource(Context, int).

CustomersChoice.configureByResource(this, R.string.resource);

With this you can add different configurations by locale, density and/or size.

###adding several Variants by a file one the SD Card CustomersChoice.configureBySD(String)

CustomersChoice.configureBySD("FilepathWithFileName");

###adding several Variants by a network CustomersChoice.configureByNetwork(Context, String) CustomersChoice.configureByNetwork(context, "configurationURL");

###adding a loggers

CustomersChoice.addLoggers(new AndroidLogger(), new CustomLogger());

###adding a reporters CustomersChoice.addReporters(new LogReporter(new AndroidLogger), new CustomReporter());

###report of reached Goal CustomersChoice.reachesGoal("Variant name");

###overwriting of the variant for a test scenario

add the BroadcastReceiver configuration into the manifest: ####Attention Add also permissions to the broadcast receiver in the manifest, if you want to use it on a live application.

<receiver android:name="de.alosdev.android.customerschoice.broadcast.OverwriteVariantBroadCastReceiver">
  <intent-filter>
    <action android:name="de.alosdev.android.customerschoice.demo.broadcast" />
  </intent-filter>
</receiver>

Write a broadcast Intent for overwriting the Variant in an Activity

Intent intent = new Intent("de.alosdev.android.customerschoice.demo.broadcast");
intent.putExtra(OverwriteVariantBroadCastReceiver.KEY_OVERWRITE_VARIANT, "Variant name");
intent.putExtra(OverwriteVariantBroadCastReceiver.KEY_FORCE_VARIANT, 2);
sendBroadcast(intent);

###setting LifeTime of Variants You can change the LifeTime of the variant by CustomersChoice.setLifeTime(Context, LifeTime).

• Session - only persisted in memory
• Persistent - persisted in preferences

License

• Apache Version 2.0