Tagga Web Toolkit

Abstract
The Tagga Web Toolkit (WTK) enables publishers to automatically create and update taggs.  Publishers can do this by inserting the WTK code into their webpages.  Embedding the WTK code will create a Send to Mobile button on the page that, when clicked by a user, will create or update a tagga tagg.  The Send to Mobile button will also send the tagg to the user’s mobile phone.  The tagga tagg created by the WTK refreshed with the latest publisher content on subsequent clicks off the “Send to Mobile” button, ensuring up to date information.

Audience
Any content publisher with HTML knowledge wishing to allow their users to send dynamic content to their mobile phones.

Script
The WTK script should be embedded once per page.  The script parameter ‘key’ must be set to a valid publisher key.  This means that WTK users must be registered with the tagga publisher program.  Register for the Tagga Publisher Program.

Examples:
Please take a look at our examples! Developers, please ‘View Source’ on the example pages to see the WTK implementation.

HTML Tags (not taggs)
The following are all div tags in html code that have the bold names below as their IDs (see example HTML implementation below the field definitions):

1. tagga_data defines the main div. If you want the resulting Send to Mobile button to have a custom style, please modify this div’s style attributes.
   
   1. tagga_data_tagg defines the tagg variable or keyword (e.g. Text <tagg> to 82442). Required Field - must be 4-10 characters in length, and only contains alpha-numeric characters (a-z and/or 0-9).
      
   2. tagga_data_title is the title for your tagg. Required Field - Must be between 1 and 255 characters in length.
      
   3. tagga_data_message is the SMS message you want sent to mobile phones. Required Field - (maximum of 80 characters for non-paid taggs and 120 characters for paid taggs).
   4. tagga_data_url will show up as a clickable link on tagg web pages (including mobile sites), maximum character length is 255 characters.
   5. tagga_data_logo will show up in place of Tagga’s logo on the mobile site page if specified, maximum character length is 255 character, must be a valid URL pointing to an image.
   6. tagga_data_comment_notification is a div that contains the comment notification options, valid values for the children divs are “true” or “false”
      
      1. tagga_by_sms notify tagg owner by SMS of comments on this tagg
         
      2. tagga_by_email notify tagg owner by email of comments on this tagg
   7. tagga_data_map_address is and address to show on a google map on tagg web apges, maximum size is 255 character, must be a valid address to map.
   8. tagga_data_paid is an option to make this tagg a sponsor-free text message, valid values are “true” or “false”, must have valid payment at tagga.com to set to “true”.
   9. tagga_data_daily_budget the maximum daily budget for sponsor-free sends (a required field if tagga_data_paid is set to “true”), this must be an integer value, no smaller than 5.
      
   10. tagga_data_detailed_info is more detailed info to describe your tagg, which will appear on tagg web pages, maximum character length is 255 characters
   11. tagga_data_keywords are keywords to describe your tagg, which allows for improved ad matching and makes tagg easier to find via search on tagga.com. Separate the phrases/words with commas, requires alphanumeric input.
   12. tagga_data_images is a div that can contain one to five image URLs, using the following div
       
       1. tagga_data_image_url place an image URL here, it will be visible on tagg web pages (including mobile), maximum character length is 255 characters, must be a valid url pointing to an image.
   13. tagga_data_direct_url allows you to specify if you want the tagga URL in the SMS message to link directly to the URL specified in the tagga_data_url, valid values are “true” or “false”

Sample Code:

Note:

• Include the script code once in the HTML head.
• Include the tagga_data div and associated field once in the HTML body.

<html>

<head><script
type="text/javascript"
src="http://dev.tagga.com/js/taggawebtoolkit.js?key=qAEBMaqr41aVjFZ6xrCV">
</script></head>

<body>

<div name=”tagga_data” title=”Send Listing to Mobile” style=”padding:2px; font-size:12px; color:#002C5F; font-family:arial; display:none;”>
<!– Enter the custom tagg code here i.e., the code the user texts to get the message - REQUIRED –>
<div name=”tagga_data_tagg”>SOTH2468</div>

<!– Enter the title for your tagg - REQUIRED, max characters is 255 –>
<div name=”tagga_data_title”>15574 34th Avenue</div>

<!– Enter the text message - REQUIRED, max characters is 80 for ad-sponsored, and 120 for ad-free (self-sponsored) –>
<div name=”tagga_data_message”>$1,249,000, 7802sqft, Single Family, 4 bed, 6 bath, golf close by!</div>

<!– Enter a url for this tagg - OPTIONAL, max characters is 255 –>
<div name=”tagga_data_url”>http://www.sothebysrealty.ca/listings/L2254.html</div>

<!– Enter a url for a custom logo to appear on the mobile site (requires a paid tagg, valid types are jpeg, jpg, png, gif) - OPTIONAL, max characters is 255 –>
<div name=”tagga_data_logo”>http://www.sothebysrealty.ca/graphics/topheader.gif</div>

<!– Enter how you would like to be notified by comments - OPTIONAL, values must be true or false –>
<div name=”tagga_data_comment_notification”>
<div name=”tagga_by_sms”>true</div>
<div name=”tagga_by_email”>false</div>
</div>

<!– Enter an address to show on a google map - OPTIONAL, max characters is 255 –>
<div name=”tagga_data_map_address”>15574 34th Avenue, Surrey BC</div>

<!– If you want to self-sponsor this tagg, put true below; this will only work if you have a valid credit card registered with us - OPTIONAL, value must be true or false –>
<div name=”tagga_data_paid”>true</div>

<!– if you chose paid as true above, enter your daily budget - OPTIONAL, defaults to 5 –>
<div name=”tagga_data_daily_budget”>8</div>

<!– Enter detailed information here; this information is only viewable on our website and can be more verbose - OPTIONAL, max characters is 1023 –>
<div name=”tagga_data_detailed_info”>This gorgeous home boasts 2 luxurious master suites both with sumptuous ensuites. Total of 4 bedrooms, 6 baths. The kitchen is an entertainers delight, massive island for working on, 2 ovens, gas range, lovely patio from family room with south exposure. Views of Mt.Baker and mountains. Triple car garage plus RV parking and tons of extra space for visiting guests. Basement is over 2700 sqft and is awaiting your ideas. Designer colors throughout</div>

<!– Enter search keywords here; separate each by a comma - OPTIONAL, max characters is 255 –>
<div name=”tagga_data_keywords”>Near Golf Course, Massive Kitchen Island, 2 Ovens, Gas Range, Mountain Views, Southern Exposure, </div>

<!– Enter one or more image urls in here - OPTIONAL –>
<div name=”tagga_data_images”>
<!– Place each URL in its own div below - OPTIONAL, max characters is 255 –>
<div name=”tagga_data_image_url”>http://www.sothebysrealty.ca/listingimages/1254-highlight.jpg</div>
</div>

</div>

</body>
</html>