Topspin Redemption Codes allow you to offer your fans free downloads via unique codes generated within your account. Any digital media can be given away for a redemption code. You can generate as many codes as you want, and allow each code to be used a predetermined amount of times. The codes can consist of randomly generated characters, or be specific secret word or phrase. You can also auto-generate randomized codes directly in an email blast.

How Redemption Codes Work

There are two elements of a Redemption campaign: 

Redemption Code: the code that's required to redeem the file

Redeem Button: a button your fans must click to enter a code 

Redeem Button

This button is simply a piece of code, similar to the Offer buttons built in your Sell section. You can embed these anywhere and change their text or appearance as you would with an offer button. One important difference is that a Buy Button is unique to the products within that button, whereas a Redeem Button is generic, so you will use the same embed-code for every Redeem button, regardless of the media that's being redeemed. The Redeem Button determines which file to deliver based on the Redemption Code entered by the user.

How to Display the Redeem Button

There are two ways for your fans to access the Redeem Button: 

1) Embed the Redeem Button on your website or other HTML page (the button below is a live Topspin redemption button; go ahead, test it! Click the button and enter "test" as the code word). 

(you can also replace the default button above with an image URL of your own choosing).

2) Link to a variation of your generic Topspin Store page.

To access the default spinshop redemption URL seen above, click any redemption code in your Promote tab and go here:

Your default Spinshop Redemption URL will conform to this structure: http:// ARTIST_NAME.spinshop.com/store/redeem/ARTIST_NAME/ARTIST_ID

Embed the Redeem Button

You can embed the generic Redeem widget code anywhere, with the same flexibility as you would apply to a Buy Button. Just copy and paste the Redeem Button code that appears below. Where you see "XXXX", insert your Artist ID Number to customize this code for your account (note that there are TWO places where XXXX appears):

<script type="text/javascript" src="http://cdn.topspin.net/javascripts/topspin_core.js
?aId=XXXX&timestamp=1291316305"></script>
<a class="ts_buttonlink" href="javascript:void(0);"onclick="TSPF.RedeemButton.load
({aId:'XXXX', highlightColor: '#c9c9c9', theme:'black'});">REDEEM</a>

How To Generate Redemption Codes

There are two ways to generate Redemption Codes: 
1) Create a Redemption Code Spin 
2) Auto-generate Codes in an Email Blast

Creating a Redemption Code

1) Go to Promote > New Offer > Redemption Code

• Code Type: To generate randomized unique codes, choose Automatic. To set one custom code that will not be randomized or changed, choose Vanity. If you choose Vanity, enter the actual code in the Vanity field that appears below.
• Start Date: Redemption codes will not be accepted before the first date entered here. This is Pacific time in the US (Los Angeles or San Francisco time).
• Stop Date: Redemption codes will not be accepted after the date entered here. This is Pacific time in the US (Los Angeles or San Francisco time).
• Redemptions Per Code: This is the number of redemptions allowed per individual code. This is set to 1 by default. In the case of Automatic codes, this determines how many times one unique code can be redeemed. In the case of Vanity codes, this sets the total number of redemptions available for the code. Click "Unlimited" to hide the quantity entry window and allow an infinite number of redemptions for the campaign.
• Quantity: If you're generating randomized codes, this field determines how many codes will be created. By default, we set the quantity to 500. You can change this to any number. Click "Unlimited" to hide the quantity entry window and allow an infinite number of redemptions for the campaign. The Quantity setting is not available for Vanity.

4) Choose the product that will be delivered to the fan

• Product Type: Choose any digital product type.
• Product Title: Choose a digital-only product from your Catalog based on the above Type value.
• Format: Visible when audio or video assets are in the package - choose one audio and/or video format for the download.

5) Click the Publish button in the upper-right. 
Once you Publish, you'll see the embed-code for the Redeem button. To generate codes immediately, click the "Edit this widget" link. 

Download A List of Your Unique Codes

Now that you've created your codes, you'll probably want to download them so you can send them out to your fans. Here's how to download your codes in a spreadsheet: 
1) Edit the Redemption Code campaign you just created. You should see a new field at the bottom called Redemption Codes with two buttons, "Generate Codes" and "Download Codes". 
2) First, click "Generate Codes". A window will pop up asking you how many codes to generate. You may generate as many as you want, up to the limit you set in Quantity. The codes will appear in a table beneath the buttons. You can come back to this table to see which codes have been redeemed, and how many redemptions each code has incurred. 
3) Next, click "Download Codes". This will download a spreadsheet (CSV file) that contains all your codes. 

Auto-Generate Codes in an Email Blast

For added convenience, you can generate unique Automatic codes from right within the email-blast creation tool. So for example, if you wanted to send an exclusive MP3 to a segment of your fan base, you could use this tool to create the code, associate it with the MP3, and insert it into the email blast all within the Email Creation window. Here are step-by-step instructions:

1) Start creating an email blast by going to Promote > Email. 
2) Check the "Include Redemption Code" box and click "Configure". 

3) Enter a Name for the Redemption Code. This process will create a Redemption Code in the Promote section where you can edit the code's rules and view redemptions. 
4) Set the amount of Redemptions Per Code that you want to allow. 
5) Choose the product that will be delivered upon redemption of the code. 

6) Once you click OK, continue writing the email as usual. When you want to insert the code into the email, just add the following text: REDEMPTION_CODE

For example, you might write "To redeem your free MP3, just enter the following code: REDEMPTION_CODE ." When recipients read the email, they will see a unique code in place of the "REDEMPTION_CODE" text. This function automatically creates one unique code for every email address you send the email to.

IMPORTANT NOTE: Make sure your email includes a link to a webpage with the Redeem Button, so your fans have somewhere to go to redeem their code. For help on creating a Redeem Button, see instructions above.

<object type="application/x-shockwave-flash" height="27" width="300" id="TSWidget26492" data="http://cdn.topspin.net/widgets/redeem/TSRedemptionWidget.swf?timestamp=1276802137" bgColor="#000000">
    <param value="always" name="allowScriptAccess" /> <param name="allowfullscreen" value="true" /> <param name="quality" value="high" /> <param name="wmode" value="transparent" /> <param name="movie" value="http://cdn.topspin.net/widgets/redeem/TSRedemptionWidget.swf?timestamp=1276802137" /> <param name="flashvars" value="widget_id=http://app.topspin.net/api/v1/offers/redeem/817/&theme=black&bgAlpha=0" /> </object>

http://app.topspin.net/api/v1/offers/redeem/<artist-id>/<redemption-code>

Successful Redemption:
 { "status": "ok", "download_url": "t.opsp.in/IDsN" }
Unsuccessful Redemption:
 { "status": "error", "message": "some descriptive text"}