NAME WWW::Sixpack - Perl client library for SeatGeek's Sixpack A/B testing framework http://sixpack.seatgeek.com/ SYNOPSIS use WWW::Sixpack; my $sixpack = WWW::Sixpack->new(); # Participate in a test (creates the test if necessary) my $alternative = $sixpack->participate('new-test', [ 'alt-1', 'alt-2' ], { ip_address => $client_ip, user_agent => $client_ua, force => 'alt-2', traffic_fraction => 0.10 }); if( $alternative->{alternative}{name} eq 'alt-1' ) { # show data for variant alt-1 } else { # show data for variant alt-2 } # Convert $sixpack->convert('new-test') SUBROUTINES/METHODS new Constructs the WWW::Sixpack object. Options that can be passed in are: "host" The sixpack server (defaults to 'http://localhost:5000'). "client_id" The client id if the "user" is known already. By default we generate a new UUID. "ua" The useragent to use (defaults to LWP::UserAgent). participate This function takes the following arguments: Arguments: "experiment" The name of the experiment. This will generate a new experiment when the name is unknown. "alternatives" At least two alternatives. "options" An optional hashref with the following options: "user_agent" User agent of the user making a request. Used for bot detection. "ip_address" IP address of user making a request. Used for bot detection. "force" (optional) Force a specific alternative to be returned "traffic_fraction" (optional) Sixpack allows for limiting experiments to a subset of traffic. You can pass the percentage of traffic you'd like to expose the test to as a decimal number here. (0.10 for 10%) convert This function takes the following arguments: Arguments: "experiment" The name of the experiment. "kpi" A KPI you wish to track. When the KPI is unknown, it will be created. _get_response Internal method to fire the actual request and parse the result AUTHOR Menno Blom, "<blom at cpan.org>" BUGS Please report any bugs or feature requests to "bug-www-sixpack at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Sixpack>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. SUPPORT You can find documentation for this module with the perldoc command. perldoc WWW::Sixpack You can also look for information at: * RT: CPAN's request tracker (report bugs here) <http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Sixpack> * AnnoCPAN: Annotated CPAN documentation <http://annocpan.org/dist/WWW-Sixpack> * CPAN Ratings <http://cpanratings.perl.org/d/WWW-Sixpack> * Search CPAN <http://search.cpan.org/dist/WWW-Sixpack/> LICENSE This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.