{"id":330,"date":"2010-12-14T00:00:16","date_gmt":"2010-12-14T07:00:16","guid":{"rendered":"http:\/\/blog.monnet-usa.com\/?p=330"},"modified":"2010-12-13T20:34:25","modified_gmt":"2010-12-14T03:34:25","slug":"ab-test-your-ruby-camping-web-app-using-abingo-part-2","status":"publish","type":"post","link":"https:\/\/blog.monnet-usa.com\/?p=330","title":{"rendered":"A\/B Test Your Ruby Camping Web App Using ABingo (Part 2)"},"content":{"rendered":"
\n

Intro <\/h3>\n

In “A\/B Test Your Ruby Camping Web App Using ABingo (Part 1)”<\/a>, I introduced the ABingo A\/B testing framework<\/a> and the new Camping ABingo plugin<\/a>. In this article I will cover the following topics:\n\t\t\t\t\t<\/p>\n

    \n
  1. Look under the ABingo Hood to understand its API, object model, and underlying database tables<\/li>\n
  2. Create a draft of the ABingo Test Application<\/li>\n
  3. Integrate ABingo into our test app<\/li>\n
  4. Run and analyze experiments<\/li>\n<\/ol>\n

    Under The ABingo Hood<\/h3>\n

    Before we can dive in the integration of the Camping ABingo plugin<\/a> with our prototype application, here is a quick overview of the basics of the ABingo framework.<\/p>\n

    ABingo API<\/h4>\n

    The two most important APIs are ab_test<\/a> and bingo!<\/a>:
    \n\t\t\t\t\t\n\t\t\t\t\t<\/p>\n\n\n\n\n
    API<\/th>\nParameters<\/th>\nContext<\/th>\nPurpose\/Usage<\/th>\n<\/tr>\n

    \n\t\t<\/a>ab_test<\/td>\n    		\n
      \n
    • test name<\/li>\n
    • optional:<\/i> array of alternatives<\/li>\n
    • optional:<\/i> conversion name<\/li>\n<\/ul>\n<\/td>\n
    		View or Controller<\/td>\nSelect an alternative for the current user based on the alternatives specified for this test. If no alternatives are specified a boolean value is returned. Tracks the execution using the conversion name if provided otherwise use the test name.<\/td>\n<\/tr>\n
    <\/a>bingo!<\/td>\n\n
      \n
    • conversion name (or test name)<\/li>\n<\/ul>\n<\/td>\n
    		Controller<\/td>\nTracks a conversion for the current user and the conversion specified. The test name is the fallback option.<\/td>\n<\/tr>\n<\/table>\n

    <\/p>\n

    Note: these 2 main APIs are implemented in Camping in a helper module being included in both controllers and views. The ab_test<\/b> is syntactic sugar<\/i> over the test<\/b> method provided by the core Abingo class<\/a>.<\/p>\n

    Model<\/h4>\n

    The basic object model for the ABingo framework looks like this:
    \n\t\t\t\t\t\n\t\t\t\t\t<\/p>\n

    <\/a><\/p>\n\n\n\n\n\n\n
    Model<\/th>\nResponsibilities<\/th>\n<\/tr>\n
    <\/a>User<\/td>\nThe user account on the prototype app<\/td>\n<\/tr>\n
    <\/a>Abingo<\/td>\nABingo’s main API class<\/td>\n<\/tr>\n
    <\/a>Experiment<\/td>\nRepresents a specific test based on multiple alternatives<\/td>\n<\/tr>\n
    <\/a>Alternative<\/td>\nTracks participants and conversions for a given alternative<\/td>\n<\/tr>\n<\/table>\n

    <\/p>\n

    ABingo Database Tables<\/h4>\n

    ABingo will need to track executions of your Experiments<\/a> and their corresponding Alternatives<\/a> in the database associated with your application. So the ABingo Camping plugin will include the needed migration to add 2 tables to your schema. We’ll see this in more details later.<\/p>\n

    Create An ABingo Test Application<\/h3>\n

    Install Camping-ABingo<\/h4>\n

    First let’s install the gem. (If you don’t have Camping or any of its dependent gem they will be installed)<\/p>\n

    \r\ngem install camping-abingo\r\n<\/pre>\n
    Note: You will find the fully functional test application under the examples\/camping-abingo-test<\/b> folder in the camping-abingo gem folder. If you want to start using it right away, skip the next sections and go straight to Setting Up Our First A\/B Test<\/a><\/b>. Otherwise follow along.<\/p>\n
    Running the Skeleton pre-ABingo Test Application<\/h4>\n
    In the next sections I will show you how to integrate ABingo with the skeleton test app. But before let’s get the skeleton application up and running.<\/p>\n
      \n
    1. Locate the examples\/camping-abingo-test<\/b> folder under your camping-abingo gem folder.
      \n\t\t\t\t\t
      \n\t\t\t\t\tThere are two versions of the test app: <\/p>\n