Trial Tracking Using the Automation Client
Trial tracking data can also be posted to the SOLO Server trialsignup.asp page using the automation client functions SK_PostEvalData and SK_PostEvalDataEx. This is useful if you distribute a trial through a means other than online download.
To implement this into your program, first refer to the function documentation for the functions following these links:
Use of this function with the trialsignup.asp page requires that for the <url> parameter, the following value is used:
- /solo/products/trialsignup.asp?ProductID=<ProductID>&FromApp=true (note that for users running their own SOLO Server instance with solo installed in the root, the "/solo" portion of this should be dropped)
Also, the <email> parameter is required to be a valid value, as this is the field used to tie new customers to existing trial sign ups, so you should not pass in an empty value for this field.
Due to the limited number of parameters supported by these functions, a majority of the fields available when posting a form to this page are not available as function parameters. To get around this, you can pass these parameters in the querystring of the <url> parameter. Refer to the trial signup sample page at http://secure.softwarekey.com/solo/templates/TrialSignupSample.htm for the field names you can use in the querystring for these additional parameters. Note that the <firstname>, <lastname>, <email>, and <phone> parameters are the same as those on the form, and the <ud1> through <ud5> parameters in the function correspond to the Misc1 - Misc5 fields on the form, so all of these fields should be passed as parameters and not through the querystring. Note that if you decide to pass along the state/province and/or postal code, if the address is US or Canadian, you should ensure that the state/province and postal code is valid. If the country is passed along, it should be a valid SOLO Server country string. See State Codes and Country Strings as well as Client Validation Script for details on validation.
SOLO Server will return the following codes as the Registration Result to indicate the success or failure of the posting:
- 0 - Success. In this case the <regid> parameter will be populated by the Registration ID
- 100 - Failure. Invalid Product - No ProductID was passed in.
- 101 - Failure. Invalid Product - Invalid ProductID was passed in.
- 102 - Failure. Trial Disabled - Trial tracking is not enabled.
- 103 - Failure. Missing Email - No email address passed in.
- 104 - Failure. Invalid Email - An invalid email address was passed in.
- 105 - Failure. Invalid Parameters - FromApp=true is missing from the querystring.