Using frames to mask your white label

The easiest way to integrate our stats into your own web site is to use HTML frames or iframes. If the entire page is going to be just for the stats, normal frames are fine. However, iframes are certainly a bit more "hip" and "with it", and we recommend this method if only a part of the page will be for the stats - for example, if the rest of your normal interface will be "around" the stats (which is also more convincing that this is entirely your own service).

Regardless of the method you use, the only thing you need to do to make this work is to set the frame source to the site's private link. This will allow the stats to load for that site without the user having to login to the service. The user won't even need an account with this method; all sites can remain as part of your "master" account. The private link for any site is available in the site administration area of your white label service.

Using the private link gives the person read-only access to the stats. If you wish to have them actually "logged in" to an account, instead point your iframe to this:
http://stats.yoursite.com/user/login?username=X&password=Y&site_id=1&remember=1

Replace X and Y with their actual username and password. This will automatically log them in, and if you specify site_id=1 (yes, leave it as "1"), it will also redirect them to the stats for the "first" site in their account. If you leave off the site_id paramter, they will instead be redirected to their user homepage. The "remember" parameter is not required, but recommended, as it will set a cookie for 1 year to automatically log them in. The reason this is recommended is because if their session times out (e.g. they're away from their computer for an hour but their stats-via-iframe page is still open) then they come back and try to view their stats again, their session will automatically resume. Otherwise, they may be presented with a login screen which could cause confusion.

With either method (private link or user login), you can also include an extra parameter in the URL, "iframe=1". When this variable is set, the header and footer of your white label is completely hidden on the stats pages, which helps them integrate much better with whatever page you are including them on. We've gone ahead and put an iframe on this page showing you exactly what it will look like if you did it on your own web site. View the page source to see the dead simple implementation.

(Note: our logo is shown because our own stats are not setup as a white label account. To prevent people from trying to get cheap/fake white label with a normal Pro account, the logo is only hidden if the site actually belongs to a white label account).

Back to white label home