Participant Counter - Revision history

Wilbert.vanham: consistency, remove participant_counter2.php, announce new features

2020-06-04T08:35:29Z

consistency, remove participant_counter2.php, announce new features

Wilbert.vanham: /* Adding a participant identifier from the panel system */

2020-05-29T14:49:38Z

Adding a participant identifier from the panel system

Wilbert.vanham: /* Adding a participant identifier from the panel system */

2020-05-29T14:49:19Z

Adding a participant identifier from the panel system

Wilbert.vanham: /* Adding a participant identifier from the panel system */

2020-05-29T14:40:31Z

Adding a participant identifier from the panel system

Wilbert.vanham: /* experiment finished in time, finalizing successful */

2020-05-29T14:36:17Z

experiment finished in time, finalizing successful

Wilbert.vanham: /* experiment takes too long and finalizing fails */

2020-05-29T14:35:16Z

experiment takes too long and finalizing fails

Wilbert.vanham at 14:34, 29 May 2020

2020-05-29T14:34:26Z

Wilbert.vanham: /* Automatic forwarding to experiment */

2020-05-29T14:33:43Z

Automatic forwarding to experiment

Wilbert.vanham at 14:30, 29 May 2020

2020-05-29T14:30:15Z

Wilbert.vanham: first edit

2020-05-25T14:12:48Z

first edit

New page

Imagine you are building an online experiment that will use an external panel system.
The participants will reach the experiment via a link supplied by the panel system
The panel system will give you a participant identifier like this: ''ae56b232''. Now you want to
counterbalance your conditions. Normally you would do this by making a list of conditions:
{| class="wikitable"
|-
! participant !! condition a !! condition b
|-
| 0 || Red || Horizontal
|-
| 1 || Green || Horizontal
|-
| 2 || Red || Vertical
|-
| 3 || Green || Vertical
|}

Now you would normally use the participant number to determine the condition: participant 0 get red, horizontal,
participant 1 get green horizontal, participant 0 get red, vertical,
participant 2 get green vertical en participant 2 gets red, horizontal again. (in real life the number of conditional can be much larger of course)
This nice system is ruined by the fact that we have no consecutive participant numbers. Using the random participant numbersfrom the panel system
may work if the number of participant is very large and the number of conditions is very small, but otherwise our counterbalancing is ruined.

Use the participant counter to solve this. Just give the participant counter a nice unique name for our experiment and each time you call it, it will
give you a new number. It has some additional features as well.

= just count =
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
{"experiment":"1","counter":"0","timeout":""} # first counter value
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
{"experiment":"1","counter":"1","timeout":""} # a new counter value
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
{"experiment":"1","counter":"2","timeout":""} # and yet another counter value

= count with timeout =
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
{"experiment":"1","counter":"3","timeout":"10"} # ppn is released after ten seconds
# sleep 15
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
{"experiment":"1","counter":"3","timeout":"10"} # we get the same counter value again

== finalizing counter at the end of an experiment ==
=== experiment finished in time, finalizing successfull ===
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
{"experiment":"1","counter":"3","timeout":"10"}
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&counter=3'
{"experiment":"1","counter":"3","timeout":""} # nu lukt het finalizen wel, want je was op tijd, je krijgt je counter terug

=== experiment takes too long and finalizing fails ===
# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10' # nog een keer
{"experiment":"1","counter":"3","timeout":"10"}
# sleep 15 # wait too long
curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&counter=3' # attempt to finalize counter
{"experiment":"1","counter":"","timeout":""} # attempt fails, your were late (counter is not returned)

= Automatic forwarding to experiment =
= Adding a participant identifier from the panel system =

@@ Line 65: / Line 65: @@
 = Adding a participant identifier from the panel system =
 ''This feature only works in the experimental version participant_counter2.php''
 You can add the participant value that you received from the panel system. This way, if the participant returns (for instances presses f5) he will receive the same counter value and hence the same version of the experiment.

@@ Line 68: / Line 68: @@
   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
-  {"experiment":"1","counter":"0","timeout":""} # first counter value
+  {"experiment":"1","counter":"0","timeout":"","participant:"john"} # first counter value
   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
-  {"experiment":"1","counter":"0","timeout":""} # The same counter value that john received last time.
+  {"experiment":"1","counter":"0","timeout":"","participant:"john"} # The same counter value that john received last time.
 If you combine a ''participant'' value with a ''timeout'', the ''timeout'' will be reset to the new value, giving the participant more time to complete the experiment. Setting timeout on a finalized experiment will not result in an error, but will not reset the ''timeout'' value.

← Older revision		Revision as of 14:40, 29 May 2020
Line 65:		Line 65:
	= Adding a participant identifier from the panel system =		= Adding a participant identifier from the panel system =
	''This feature only works in the experimental version participant_counter2.php''		''This feature only works in the experimental version participant_counter2.php''
		+	You can add the participant value that you received from the panel system. This way, if the participant returns (for instances presses f5) he will receive the same counter value and hence the same version of the experiment.
		+
		+	# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
		+	{"experiment":"1","counter":"0","timeout":""} # first counter value
		+	# curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
		+	{"experiment":"1","counter":"0","timeout":""} # The same counter value that john received last time.
		+
		+	If you combine a ''participant'' value with a ''timeout'', the ''timeout'' will be reset to the new value, giving the participant more time to complete the experiment. Setting timeout on a finalized experiment will not result in an error, but will not reset the ''timeout'' value.

← Older revision		Revision as of 14:34, 29 May 2020
Line 64:		Line 64:

	= Adding a participant identifier from the panel system =		= Adding a participant identifier from the panel system =
		+	''This feature only works in the experimental version participant_counter2.php''

@@ Line 55: / Line 55: @@
 = Automatic forwarding to experiment =
-This feature only works in the experimental version participant_counter2.php
+''This feature only works in the experimental version participant_counter2.php''
-   https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10&url=http://www.nu.nl #forward to http://www.nu.nl?ppn=COUNTER
+You need not read the result as JSON. In order to get a 302 temprary redirect to https://www.nu.nl/?experiment=1&counter=8&timeout=10 use:
 = Adding a participant identifier from the panel system =

@@ Line 23: / Line 23: @@
 Use the participant counter to solve this. Just give the participant counter a nice unique name for our experiment and each time you call it, it will
-give you a new number. It has some additional features as well.
+give you a new counter value. It has some additional features as well.
 = just count =
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
-   {"experiment":"1","counter":"0","timeout":""} # first counter value
+   # {"experiment":"1","counter":"0","timeout":""} # first counter value
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
-   {"experiment":"1","counter":"1","timeout":""} # a new counter value
+   # {"experiment":"1","counter":"1","timeout":""} # a new counter value
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1'
-   {"experiment":"1","counter":"2","timeout":""} # and yet another counter value
+   # {"experiment":"1","counter":"2","timeout":""} # and yet another counter value
 = count with timeout =
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
-   {"experiment":"1","counter":"3","timeout":"10"} # ppn is released after ten seconds
+   # {"experiment":"1","counter":"3","timeout":"10"} # ppn is released after ten seconds
-   # sleep 15
+   sleep 15
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
-   {"experiment":"1","counter":"3","timeout":"10"} # we get the same counter value again
+   # {"experiment":"1","counter":"3","timeout":"10"} # we get the same counter value again
 ==  finalizing counter at the end of an experiment ==
 === experiment finished in time, finalizing successful ===
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10'
-   {"experiment":"1","counter":"3","timeout":"10"}
+   # {"experiment":"1","counter":"3","timeout":"10"}
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&counter=3'
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&counter=3'
-   {"experiment":"1","counter":"3","timeout":""} # counter value is finalized, no other participant will receive this value in the future
+   # {"experiment":"1","counter":"3","timeout":""} # counter value is finalized, no other participant will receive this value in the future
 === experiment takes too long and finalizing fails ===
-   # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10' # get counter value
+   curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10' # get counter value
-   {"experiment":"1","counter":"3","timeout":"10"}
+   # {"experiment":"1","counter":"3","timeout":"10"}
-   # sleep 15 # wait too long
+   sleep 15 # wait too long
    curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&counter=3' # attempt to finalize counter
-   {"experiment":"1","counter":"","timeout":""} # attempt fails, your were late (counter is not returned)
+   # {"experiment":"1","counter":"","timeout":""} # attempt fails, your were late (counter is not returned)
 = Automatic forwarding to experiment =
 You need not read the result as JSON. In order to get a 302 temprary redirect to https://www.nu.nl/?experiment=1&counter=8&timeout=10 use:
-   https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter2.php?experiment=1&timeout=10&url=http://www.nu.nl
+   firefox https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10&url=http://www.nu.nl
 All the other features work in combination with the ''url'' parameter as well.
 = Adding a participant identifier from the panel system =
-''This feature only works in the experimental version participant_counter2.php''
+You can add the participant value that you received from the panel system. This way, if the participant returns to your page (or for instances presses F5) he will receive the same counter value and hence the same version of the experiment.
-You can add the participant value that you received from the panel system. This way, if the participant returns (for instances presses f5) he will receive the same counter value and hence the same version of the experiment.
+ curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
- # curl 'https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&participant=john'
+If you combine a ''participant'' value with a ''timeout'', the ''timeout'' will be reset to the new value, giving the participant more time to complete the experiment. Setting timeout on a finalized experiment will not result in an error, but will not reset the ''timeout'' value.
-If you combine a ''participant'' value with a ''timeout'', the ''timeout'' will be reset to the new value, giving the participant more time to complete the experiment. Setting timeout on a finalized experiment will not result in an error, but will not reset the ''timeout'' value.
+= Maximum counter value =

← Older revision		Revision as of 14:30, 29 May 2020
Line 55:		Line 55:

	= Automatic forwarding to experiment =		= Automatic forwarding to experiment =
		+	This feature only works in the experimental version participant_counter2.php
		+
		+	https://www.socsci.ru.nl/wilberth/nocms/radcloud/participant_counter.php?experiment=1&timeout=10&url=http://www.nu.nl #forward to http://www.nu.nl?ppn=COUNTER
		+
	= Adding a participant identifier from the panel system =		= Adding a participant identifier from the panel system =