This document is intended to provide all technical information required to install the MYORMR links/buttons to your website. We have designed the application and it's popup link to be quick and simple, while ensuring the security of the provided music files. You are not required to host or maintain any applications on your systems or servers.
We will make technical staff available to answer questions that you may have during the installation process. Certain technical specifications about the client system will be necessary to ensure that the most appropriate set up is used to achieve the desired commercial results. The Set Up coding is very simple and easy to implement.
This document is designed to help you understand the "visitors experience" in conjunction with what happens "behind the screen". There are several steps the user must follow in order to create personalised ringtones:
The visitor browse your website, looking for music to download to his phone/computer. The user exeperience may vary from site to site, depending on how your music collection is organized (by genres/artists/albums/promotions/etc).
To help you understand where the MYORMR links/buttons must be placed, you can see below an example of a fictive/generic website called "ABC Music Download" that offers digital music downloads:
As you can see, next to each song and on the "Song detail" section/page, there is a link/button reading "Get ringtone" (or "Make ringtone", etc). For details on adding this links/buttons to your website, please read below.
In this section, you get to know the requrements/instructions for adding the "Get ringtone" link to your website, thus making your music catalog (or any part of it) available to the MYORMR application.
First of all, in the HEAD section of all* pages that contain links/buttons to MYORMR, you will have to include the following piece of code:
<script language="JavaScript">
function myormr(iorg, title, key){
var w = 764;
var h = 531;
var ww = Math.floor((screen.width-w)/2);
var hh = Math.floor((screen.height-h)/2);
var adr = "http://www.myormr.com/index.php";
adr += "?iorg=" + iorg;
adr += "&title=" + escape(title);
adr += "&key=" + escape(key);
window.open(adr, "myormr", "status=no,resizable=no,width=" + w + ",height=" + h + ",top=" + hh + ",left=" + ww);
}
</script>
To cut down the page loading time, you can save the above piece of code to a file, say "myormr.js", and then include it in all* pages that contain links/buttons to MYORMR. This way, the "myormr.js" file is cached by the visitor's browser and the MYORMR code (listed above) does not need to be downloaded each time a page loads. See example:
(*) Note: If your website has, say, over 50,000 songs/pages you probably won't need to repeat the above actions 50,000 times. As long as your website pages are projected dynamically using PHP/ASP/JSP/etc technologies (which usually happens nowadays), you will only have to write the code once in your website, not for every song/page.
In order to start the MYORMR application when the visitor clicks on the "Get ringtone" link/button, you will have to call the "myormr()" JavaScript function defined above, providing the following parameters:
iorg - Affiliate ID or Organization ID
A number that we will provide you upon installation. This parameter is required in order to instruct MYORMR that the visitor is coming from your website.
title - The title of the song
A string that will instruct MYORMR about the song title. You may also want to include the artist name in this parameter.
key - The address to the actual song file
A string that will instruct MYORMR where to get actual song file (MP3/WMA formated). Please note that this file doesn't need to be (and it's recommended not to be) the original/CD quality song file that is delivered to the visitor computer. Instead, this URL address should point to a low quality preview file, thus making it unusable for the visitor (if downloaded to his computer).
Please note that MYORMR can work with any (raw/unencrypted) MP3/WMA file. Anyway, in order to save bandwith both on your and on our end, the recommended file format is as follow:
- Format: MP3 or WMA "raw" audio files (meaning no DRM data should be attached to the files). Pleae note, MYORMR works slightly faster with MP3
- Bitrate: 64 Kbps
- Freq: 44 KHz
- Channels: Mono
Furthermore, in order to make sure that even the preview file cannot be accesed by the visitor, this parameter can be secured as follow:
If all song preview/low quality files share the same location or are dynamically served by a script on your servers, you can provide MYORMR only the last part of this URL address. As an example, if the preview files URL location look like this:
- http://www.yoursite.com/previews/eminem_business.mp3
- http://www.yoursite.com/previews/eminem_lose_it.mp3
- http://www.yoursite.com/previews/eminem_my_name_is.mp3
- http://www.yoursite.com/previews/{SOMETHING}
Or are dynamically served by a server-side script:
- http://www.yoursite.com/get.php?song=eminem_business
- http://www.yoursite.com/get.php?song=eminem_lose_it
- http://www.yoursite.com/get.php?song=eminem_my_name_is
- http://www.yoursite.com/get.php?song={SOMETHING}
You can setup the common first part of the URL address in your MYORMR acccount: http://www.yoursite.com/previews/ in the first case and: http://www.yoursite.com/get.php?song= for the second example, and then send only the last part of the URL address as the "key" parameter.
To get the actual URL address to the preview file (where the application will download the preview MP3/WMA file from), MYORMR concatenates the provided two parts: the common URL part, that was setup into your account, and the last part of the URL address, specified by the "key" parameter, sent when the user click on the "Get ringtone" link/button.
An example of a valid request to MYORMR would then look like as follow:
<a href="#" onClick="myormr(1234, 'Eminem - My name is', 'eminem_my_name_is')">Get ringtone</a>
or:
<input type="button" value="Get ringtone" onClick="myormr(1234, 'Eminem - My name is', 'eminem_my_name_is')">
Where the parameters have the following semnification:
1234
The Affiliate or Organization Id, provided by us upon your account installation. Please not that "1234" is a dummy Affiliate ID, used only for this example.
Eminem - My name is
The song title, including the artist name.
eminem_my_name_is
The key or last part of the URL address that uniquely identifies the low quality preview file for the selected song.
Once the above simple instructions are implemented into your website, you account becomes active and, when the "Get ringtone" link/button is clicked, the MYORMR popup should come up. Nothing else is required from your side, from now on, the application will interact with the visitor and will take over the ringtone creation process.
To create a customized ringtone for his mobile phone, the visitor will have to follow 3 easy steps within the MYORMR popup:
Select phone model & mobile carrier
Crop a 5 to 30 seconds clip from the selected song
Download the newly created ringtone
Please refer to the "Live demo" section in order to "live" the visitor experience while running MYORMR.
For further information, don't hesitate to contact our technical department at support@myormr.com.
Printable version