Integration Steps

There is a simple sequence of events that must occur for a successful integration of the speed dating application into your website:

1. First choose the web language you are using on your site. Our samples include PHP, ASP and ASPX formats. You may modify these files to support a different language as well. Then upload the files from your chosen language to your website: SDLOGIN and SDXML (PHP/ASP/ASPX).

In the SDLOGIN file there are several variable declarations that MUST be updated with your unique information provided by Randodate and the demographic information about the user you are logging in.

The first two lines you need to modify are listed as "Randodate Account Information" inside the file and look like this:


							$strDomainID      =  "";

							$strDomainSecret  =  "";

You need to substitute your account information for the strDomainID and strDomainSecret place holders as shown in the file. For example, if you received a domainID of "999" and a domainSecret of "1234567890", you would change this code to look like this:


							$strDomainID      =  "999";

							$strDomainSecret  =  "1234567890";

Next, the strUniqueUserID must be set to a unique identifier for the user you are logging in. This "ID" will be used to indentify the user on our end (thus is must be unique) and will be sent back to you if you opt to recieve notifications of matches. In PHP, for example, this could be set by using $_COOKIE["id"] or $_SESSION["id"] or any other means you use to indentify your users.

If using the cookie example mentioned above, you'd change the following line in the "User Identifiable information" section of the file:


							$strUniqueUserID  =  "";

to look like this:


							$strUniqueUserID  =  $_COOKIE["id"];

Finally, you need to update the "User Demographic Information" section of the file with the appropriate demographic/profile information for the user you are logging in. This information is most often pulled from your database, but can be set using whatever means you want.

For our example, we'll pull the information from a MySQL database and populate the correct variables with the information. To start, we'll find the section of the file that looks like this:


							$strDisplayName   =  "";

							$strCity          =  "";

							$strState         =  "";

							$strCountry       =  "";

							$strAge           =  "";

							$strGender        =  "";

							$strPhotoURL      =  "";

							$strProfileURL    =  "";

To populate these variables, we'll connect to our database, pull the fields and assign their values to the correct variables; here's a simple example:


							$db_host="localhost";

							$db_user="root";

							$db_pass="password";

							$db_name="mySchema";

							$db_connect = mysql_connect($db_host,$db_user, $db_pass) OR DIE ("Error" . mysql_error());

							mysql_select_db($db_name, $db_connect);

							$query = "SELECT uName, City, State, Country, Age, Gender, Photo, URL FROM User WHERE ID = '$_COOKIE["id"]'";



							$result = mysql_query($query);

							while($row = mysql_fetch_array($result))

							{

							   $strDisplayName   =  $row["uName"];

							   $strCity          =  $row["City"];

							   $strState         =  $row["State"];

							   $strCountry       =  $row["Country"];

							   $strAge           =  $row["Age"];

							   $strGender        =  $row["Gender"];

							   $strPhotoURL      =  $row["Photo"];

							   $strProfileURL    =  $row["URL"];

							}

At this point, you're all setup. There are a few other lines of code on the page, but you can leave them as they are. Your users will be automatically and seemlessly logged in to the Randodate video speeding service.

2. The SDXML file will need to be setup if you'd like to receive a notice from our servers every time two of your members are matched through a speed dating session. Some webmasters use these matches to initiate further communication on their site (ex. waiving initial contact fees or sending a message to both parties).

The following action needs to be implemented by you in order to integrate the speed dating application into your web site.

updateMatches ( memberID_1, memberID_2, callID )

This function will notify you when a match is made in a speed dating session. At the conclusion of each speed date, both users are asked if a match was made. When both users answer "yes", you can be notified. Webmasters can take this match information and do whatever they want. Some websites might waive initial contact fees (or even encourage them) between the two matched users, while others might simply send a follow-up message to each user. This feature can be switched on/off at any time from the account management page on Randodate.com

Parameters

domainID:: The identifier for the domain the user is on
memberID_1:: The first memberID of the match pair
memberID_2:: The second memberID of the match pair
callID:: A unique identifier for this XML call

Returns

Nothing Returned

3) The final step to integration is to log in to your account at Randodate.com and update your account. In order for us to know where to make the XML calls on your server, you need to enter the full path to the sdxml file on your server.

From your account management page, you can also specify the URL to your banner ad and set whether or not you want to be notified when matches are made.

That's it.

TRY IT OUT

Click the link below to try video speed dating for yourself. The demo rooms aren't used by live users, so you'll need a friend - or two browsers - to try.

Signup now and start offering your members video speed dating today.

LEARN MORE

Want to learn more about the integration process? Click the button below to read through the technical documentation.