Campaigner


For simple SMS Query/Response Campaigns Campaigner can not be beaten.

 

Campaigner takes the technical challenge out of enabling your systems and information to be utilised by a mobile community.

 

With the global connectivity of Bulletin Connect and the extensive experience of bulletin in this arena, Campaigner is positioned as a low cost, easy to use system for SME, SOHO and growing corporate organisations.

 

Campaigner takes the cost out of setting up your SMS campaigns. By providing a set of common numbers, and assistance in obtaining dedicated premium numbers, Bulletin can get you up and running with minimum cost or technical knowledge.

 

The interface to Campaigner allows you to quickly setup your keywords and relevant actions. If the actions you need are not available then our developers can assist in custom building one to your requirements.

 

With your keywords and actions configured and ready to use you can start to generate interest in them via the mass media, billboards etc, inviting people to text in for more information or to initiate an action.

 

Benefits:

  • Low cost structure. 
  • Rapid account setup.
  • Shared numbers for low cost campaigns, or
  • Dedicated numbers for branded campaigns.
  • International campaigns can use common numbers.
  • GSM WAP Push messaging for a richer user experience.
  • Publish your keywords to generate traffic.
  • Manage your own keywords. No more delays in making changes to your campaign.

Features:

  • Comprehensive Message logging and online Reporting 
  • Large range of standard actions to suit most situations
  • Customised development available for your specific needs
  • Easy to understand online userguide
  • Assistance with obtaining and maintain premium numbers
  • Dynamic Message handling for customised responses
  • Simple Media Gallery to use in your responses
  • Remote access to report data for integration into your applications

   Important 


In order for us to provide enhanced support please notify Bulletin when you are promoting your campaign.


Enhanced Messaging

Campaigner exposes WAP Push functionality and enables content to be easily uploaded, stored and delivered in response to SMS requests.

 

Using WAP push allows you to deliver content that is automatically (or with minimal user intervention) managed by the handset. This content could be calendar appointments, contacts and business cards as well as media such as images, sounds and video.


Browser Requirements

Campaigner uses Javascript and is designed for 1024/768 screen size.

 

The Campaigner website uses pop-up pages for Keyword and Gallery Management. Ensure that your browsers (and any other add-ins) are configured to allow pop-up windows and javascript for the Campaigner site.


Table of Contents

 

  1. Configuration
    1. Numbers
      1. Default Numbers
        1. Default (Shared) Number Details
      2. Dedicated Numbers, Short Codes and Premium Billing
        1. Application Process
    2. Keywords
      1. Advanced Keywords
        1. Default Fallback
        2. Email Address
        3. Number
        4. Starts With...
      2. Actions
      3. Details
      4. Restricted Keywords
      5. Restricted Characters
    3. Message Log
    4. Number Details
    5. Reports
      1. Running Reports Remotely
        1. Process
        2. Using Your Report Data
  2. Dynamic Response Tags
    1. System Tags
      1. Date Tools 
      2. Shakespearean Insulter
  3. Action List and Descriptions
    1. Simple Actions
      1. Echo the Message
      2. Reply with Static Message
      3. Forward the message to an email address
      4. Forward the message to another mobile
      5. Forward Campaigner to a WebService
      6. Send Business Card Details
      7. Send a vCalendar
      8. WAP Push your Gallery Media
      9. WAP Push Internet Content
      10. SMS an Extract of a Web Page
      11. Lookup SMS Response from a File
    2. Send Email To Supplied Address
  4. Publishing your Keywords
  5. Managing your Media
  6. Supported Media
  7. Administration
    1. Testing your Setup
    2. Reports
      1. Customised Automated Reports
  8. Need more control over your messages?
  9. FAQ

 

 

 

Configuration


Campaigner is designed for you to have multiple keywords on multiple Numbers. This gives you the flexibility and power to create a range of campaigns from the simple through to advanced. Most actions can be configured quickly and for more complex ones that require rate codes, Premium Billing, Short Codes or Development of Custom Actions, contact Bulletin for assistance.

 

Back to Top 


Numbers

Numbers will be accessible at one of the following levels.
  • International
  • National
  • Carrier Specific

Depending on your requirements for Branding, Accessibility and Billing you may choose to use one of the existing default Numbers or use one or more dedicated ones for your organisation. See the Application Process section for information on the application process.


International

These are generally mobile like numbers setup and maintained by Bulletin for all Campaigner users. Some international numbers are available for specific accounts (setup and ongoing costs apply).

Advantages: 

  • These numbers can be reached by most mobile phones around the world.
  • No additional costs to you to use them if you want to use the existing ones in Campaigner. 

Disadvantages: 

  • The user may incur additional charges for international SMS messages.
  • Unable to premium bill any inbound and/or outbound messages.
  • Shared by other Campaigner users so specific unique keywords are required (no fall through action available).
  • They look like mobile numbers and may not be marketable. 


National

These are also mobile like numbers but the carrier does not accept messages from outside of their country for whatever reason. Some national numbers may be available in your target market if required for specific accounts (setup and ongoing costs apply).

 

Advantages:

  • These numbers can be reached by most mobile phones within the target country.
  • No additional costs to you to use them if you want to use the existing ones in Campaigner.
  • Suitable for local workforce messaging. 

Disadvantages:

  • Unable to premium bill any inbound and/or outbound messages.
  • They look like mobile numbers and therefore may not be suitable for marketing. 

 

Carrier Specific

Carrier specific short codes or numbers can usually obtained if you require additional billing options or more marketable numbers. Each carrier has their own application process, restrictions and terms of use that Bulletin can assist with.

 

Advantages:

  • Can premium bill inbound and/or outbound messages.
  • Short and Memorable.
  • Easy to use in Marketing/Advertising.

Disadvantages:

  • Additional costs to setup and maintain.
  • Can only receive messages from users on the specific network.
  • For campaigns on multiple networks the same short code may be required which may add to the cost.

 

Back to Top 


Default Numbers

These numbers are shared by multiple Campaigner users. This is the low cost way to get your campaign up and running as there are no additional charges for dedicated numbers such as short codes and premium billed numbers.

 

Back to Top 

 

Default (Shared) Number Details

The shared numbers for all Campaigner accounts are:


Number

Country

Access Restrictions

Costs(HTTP)

+19414219850 USA No Restrictions No Restrictions
4040 New Zealand Only available for:
  • Vodafone New Zealand 
  • Spark New Zealand
Only available for: Vodafone New Zealand Telecom New Zealand
+61416906004 Australia Available on any GSM phone and probably most other networks Standard SMS Costs

 

Back to Top  

 

Dedicated Numbers, Short Codes and Premium Billing

If your campaign requires dedicated numbers that will provide you with more flexibility and consistency in your branding then please see the Application Process described below. This also applies if you want to use short codes on specific carriers or need to utilise premium billing on either inbound or outbound messages.

 

Back to Top 

 

Application Process

Contact Bulletin to get assistance in applying for Short Codes and Premium Billed numbers.

 

Back to Top 

 

Keywords

Keywords are the key to Campaigner. These unique identifiers allow Campaigner to respond to queries or requests with defined actions and messages. Keywords are need to be unique per Number so if you are using a shared (public) number then someone else may already be using the one you want.

 

Keywords are the first word in any SMS message sent to Campaigner. You can ask for more information to be included in the SMS (eg send "vote" and your preference to 4040) which will be available to your when forwarding and responding using Dynamic Response Tags. 

 

   Information on Special Characters


When using special characters in keywords you should test them from all phones and networks you want to support.

Some networks translate or change message content when it includes special characters which may mean that messages sent from a handset may not be the same as delivered to Campaigner and therefore will not match your keyword.

 

Advanced Keywords 

There are situations where having strictly defined keywords may not suit your promotion or workflow. If you are using dedicated numbers for your Campaigner account then you can also make use of the Default Fallback, Email Address and Number advanced keyword classes as described below. These can be accessed when setting up or editing a keyword by selecting the advanced option. 

 

   At a technical level first word matches are attempted in the following order: 

  1. Exact match against a defined keyword.
  2. Exact match against an Email Address class.
  3. Exact match against a Number class.
  4. Partial match of the beginning of the SMS against a Starts With class with the best match taking priority. eg SMS "barrywhite" will match the Starts With class of "barry" rather than one of "bar" (its a longer/better match).
  5. Failing all of the above, if there is a Default Fallback configured then this action will occur. If no Default Fallback is setup then the message is dropped. 

  

Back to Top 

 

Default Fallback

The Default Fallback keyword class is used as the last resort when processing your inbound messages. If the SMS message does not start with any of your explicit keywords and does not match any of the other special classes described here then the Default Fallback action will occur if you set it up. 

 

Back to Top 


Email Address

An Email Address keyword class will look at the first string (upto the first space) of the SMS message to see if it looks like an email address. Basically, it checks if there is a set of letters or numbers then an at (@) symbol with more letters/numbers then a dot and a few more letters.

 

This is useful if you want to collect email addresses as part of your campaign or want to act immediately. For example you could configure the Email Address keyword to forward the message to your webserver that will store the email address in your CRM system and send out a welcome email with a voucher for free stuff.


You could also use the Send Email action to react automatically with Campaigner, acknowledging the message and sending an email to the address received by SMS. This Email Address keyword class and the Send Email action are only truly useful if you have your own dedicated numbers in Campaigner. 

 

Back to Top 


Number

An Number keyword class will look at the first string (upto the first space) of the SMS message to see if it is a number (integer). This could be used for phone numbers, bids, donation pledges, votes etc.

  

Back to Top 


Starts With...

This option is not available via the Advanced menu. If you want to setup a keyword class that matches the begining of the first word in the SMS (e.g. it starts with a consistent string) then contact us and we can assist.

 

If this option is used then there is on additional Dynamic Response Tag available to be used in your action.

 

To Use...

Add This Response Tag

The part of the string with the start is removed (eg the part that matched) $!{keyword-remainder}

 

Back to Top 


Actions

The action describes, in plain english, what happens when a keyword is requested. You can change the action for a keyword by editing it. When you change the action then you may need to changes some or all of the details.

 

Back to Top 

 

Details

The details section shows specific information about your response to a keyword request. What is displayed here will depend on the type of action.

 

Back to Top 


Restricted Keywords

Some keywords are restricted due to potential abuse or misuse. While you may be able to create and edit Campaigner actions with these restricted keywords they will only be fully functional from your registered Bulletin Online mobile number. Other users will be able to make the requests but will receive a standard reply and not your content.

 

To gain full functionality on these restricted words contact Bulletin. Permission to use these keywords will be granted if the use of the word is acceptable.

 

Back to Top 


Restricted Characters

The following is a list of characters that should be avoided in both your keywords and your response messages.


  •  ç
  • á
  • à
  •  é
  • ó
  • ú
  •  ã
  • õ
  • ü

 

Other characters may also cause issues and if they are not listed here then please contact us.

 

If you do use them then you should test them thoroughly on all your supported networks where you expect messages to be sent from and delivered to.

 

Back to Top 


Message Log

All messages in and out of Campaigner that match your keywords are listed here for the last 180 days. You can see information on the Campaigner and what was sent out in response.

 

If you need more detailed reports then Contact Bulletin with your reporting requirements (costs apply) or see whether your requirements are met with the existing reports.

 

Back to Top 


Number Details

The details of the number are described here. Depending on the configuration some or all of the following information may be available to view and this should be the first place to check if you have any questions about the number. 

  1.  Network - which network is the number on. 
  2. Status - indication of the number status. May indicate if it is still in the application process, available for use or suspended for some reason. 
  3. Accessibility - are there any known issues with sending messages to this number from other networks/countries. 
  4. Premium billing details - generally only available for short code numbers and indicate costs charged to the handset by the network operator independent of charges incurred for sending messages from Campaigner. 
    1. MO rate - how much will users be charged for sending a message to this number. 
    2. MT rate - how much will users be charged for receiving a message from this number. 
  5. Access Fees - charged by the network for using the number. 
  6. Expiry Date. 

 

If you have questions about the number, contact Bulletin.

 

Back to Top  


Reports

You are able to report on message activity for each of your Numbers using one of the predefined reports and you are even able to access the reports remotely (with a little work). 

  • Incoming Messages 
  • Message Count 
  • Sender Count 
  • Message Details 


Incoming Messages

The Incoming Message report display the details of all messages received for the time period.

 


Message Count

The Message Count report returns the first word of the message and how many times this was used.

 

The first word of the message will usually correspond to the keyword you have setup unless you are using a wildcard action on your dedicated number. You also have the option of only showing the most popular requests by limiting the results to show the top nn.

 

You are able to drill down into the data to see the specific messages for each result. 


Sender Count

The Sender Count report returns a list of all the numbers that accessed this keyword and how many times they have accessed it during the time period.

 

Select the date range required for the report and decide if you want to limit it to the top nn senders.

 

You are able to drill down into the data to see the specific messages for each sender.


Message Details

 

The Message Details report display the details of all messages received and sent for the time period.

 

Select the date range required for the report and both incoming requests and outgoing responses will be displayed.

 

Back to Top  


Running Reports Remotely

This advanced feature allows you to run reports remotely without needing to login, browse and run the report each time. A standard (but very long) web URL that includes all the parameters for the report you want to access (and your user credentials) can then be accessed using another application such as Microsoft Excel or 3rd Party charting software.

 

   The steps involved in this process require some patience and are not for the faint hearted. Bulletin can assist with getting the data out of Campaigner but if you have questions about how you can use it in your application please contact the provider of that software.

 

  • Make sure you test the URL in your browser after each change as you may find it difficult to trouble shoot later. 
  • The examples shown below will not work for you (if you copy it) because your URL will include unique information that is different to that shown here as a guide.


Process 

    1. Using the website reports interface configure and run the report that you want to use as source data for your application. 
      1. Message Count report is good for charting. 
      2. The Incoming Messages report would be good for retrieving message content to display elsewhere (e.g. a Blog). 
    2. Run the report and then we get to the first tricky part... 
    3. Extract the URL of the report you want to use by getting the shortcut properties of the relevant Export Option(from the bottom of the page). 
      1. CSV Format can be used by charting software or Excel. 
      2. XML can be used in website applications. 
      3. Excel, PDF and RTF Formats are not really useful for using in remote applications. 
    4. Copythe Export Shortcut Properties (this is the CSV report) and paste them into notepad which will look something like the following... take a deep breath, it is computer generated and can scare people: 
      http://mquery.net/reports/messageCountReportPopup.html?startDay=2005%2F02%2F01&msisdnId=3&endMinute=10&reportName=messageCount&
      showPercentage=false&endHour=10&limited=false&startHour=10&6578706f7274=1&d-6389698-e=1&startMinute=10&endDay=2010%2F05%2F31 

       

    1. This is a form encoded URL that has almost all the information you need but now we need to edit it. 
    2. Add your username and password to the end of the URL, for example: 
      ...endDay=2010%2F05%2F31&username=YOURID&password=YOURPASSWORD
  • Remember to use your proper ID and password (case sensitive). 
  • Copy this URL into your browser address bar and see what happens. If everything is correct then you will be prompted to download a CSV file that is the same as you initially ran. 
  • If everything works then you can now learn about the detail and make changes to suit. 
    1. You can change the type of report by changing the (rather random looking) key d-6389698-e 

      Format of Report

      Key/Value

      CSV d-6389698-e=1
      Excel d-6389698-e=2
      XML d-6389698-e=3
      PDF d-6389698-e=5
      RTF d-6389698-e=6
      HTML remove the key entirely

       

    2. To show percentage values rather than real numbers change showPercentage=false to showPercentage=true. 
    3. To Limit the results to the top 20 you need may need to add or modify the properties[SP:'limit']=20 key/value to meet your requirements and also ensure that limited=true. 
    4. Remove all the end..time parameters from the URL to use the current date/time and be more futureproof. e.g: 
      1. endDay
      2. endHour
      3. endMinute
    5. You should be able to rearrange the key=value pairs but make sure each pair is separated by the ampersand (&) but make sure you test that it still works. 
    6. You can replace the encoded slashes (%2F) with forward slashes in the dates (e.g. change 2010%2F05%2F31 to 2010/05/31). 

      

    Back to Top 


    Using Your Report Data

    Now you have the data you probably want to use it. A possible use is to use 3rd party software to make a chart that can be updated from your live data. Or, you may like to use Microsoft Excel's Web Query functionality to analyse the data, chart or otherwise process.

     

    You can also use other 3rd party charting software that can make live web queries. For assistance with these 3rd party packages see the software vendor.

     

       Microsoft Excel has a limit on the length of the URL it can use for Web Queries. To get around this limit use http://tinyurl.com to change your long Campaigner URL into a shorter one. If you have to make changes to the URL you will have to regenerate the TinyURL again. Other software may also have the same limitation on URL length.

     

    The basic steps to use your data in MS Excel are as follows. If you have any specific questions about Excel or any other 3rd party product then please refer to their documentation.

      1. Create and modify your report as detailed above and ensure you use the HTML format report, e.g. remove the d-6389698-e=1 value from the URL entirely.
      2. TinyURL the report URL.
      3. In Excel (Example using Excel 2003):
        1. Go to Data | Import External Data | New Web Query.
        2. Paste the TinyURL into the Address bar and wait for the report to open. Note: You may get a debugging error that is safe to ignore.
          1. You will see the HTML report containing your data.
        3. Select the yellow arrow next to the header row in the report and it will highlight all the data and tick the box.
        4. Press the Import button.
        5. Choose the location you want the data to go in your spreadsheet.
        6. Wait a moment as the data is imported.
        7. Congratulations! You now have a spreadsheet with live data from your Campaigner Account.
      4. When you want to refresh the data (if Excel does not do it automatically), right click the table and choose Refresh Data.
      5. You can build a chart or pivot table on this data too!

      

    Back to Top 


    Dynamic Response Tags


    If your response needs to reuse any of the SMS message for a URL or for personalised messages it is simple to do. Each word in the request is assigned a number based on it's location in the message, with each of the parameters counted from 1 to n after the keyword.

     

    For example an SMS message sent from 61497777777 to the Campaigner 4040 number that reads:

     


    search conspiracy theory


     

    Could be responded to with a URL that is sent to the requester as WAP Push Internet Content.

     

    To Use...

    Add This Response Tag*

    from=61497777777&to=4040&arg1=conspiracy&arg2=theory& args=conspiracy+theory&keyword=search&body=search+conspiracy+theory $!{url-params}
    search conspiracy theory $!{body}
    search $!{keyword}
    conspiracy theory $!{args}
    conspiracy_theory $!{args-underscore}
    conspiracy-theory $!{args-dash}
    conspiracy.theory $!{args-dot}
    conspiracy $!{arg1}
    theory $!{arg2}
    61497777777 $!{from}
    4040 $!{to}

     

    * tag must be lower case

     

    Note that in addition to the message content, the sending and receiving numbers are exposed and can be used as Dynamic Response Tags.

      

    URL setup for the search keyword:

     


    http://en.wikipedia.org/wiki/$!{args-underscore}

     

    The URL that is Pushed back to the handset responding to the original request would be (preview): 



    http://en.wikipedia.org/wiki/conspiracy_theory


    System Tags

    For the techies Campaigner uses some of the Velocity Tools for templating. 

    • Date Tool 
    • Shakespearean Insulter 

     

    Back to Top 


    Date Tool

    Velocity Date Tool allows you to use dynamic date strings/ values in your messages.

     

    For this to appear in a message

    Use this tag in the action

    20031019T215400 ${date.get("yyyyMMdd'T'HHmm'00'")}
    2003-10-19 21:54:50 ${date.get('yyyy-M-d H:m:s')}
    Sunday, October 19, 2003 ${date.full_date}

     

    At this time no time zone can be specified so we use New Zealand as the reference point. Any date/time values used with this are calculated at the time the message is processed by Campaigner.

      

    Back to Top 


    Shakespearean Insulter

    For a bit of fun this dynamic tag generates a random Shakespearean insult. More for fun than business we suspect.

     

    For this to appear in a message

    Use this tag in the action

    O thou gorbellied, fat-kidneyed puttock.
    or
    O thou spleeny, earth-vexing gudgeon.
    or
    some other random message
    ${fn.insult()}

     

    Back to Top 


    Action List and Descriptions


    Each request will cause Campaigner to do and action and most of the time send a message back. 

     

    These actions, the information required to set them up, and the results are explained in later sections.


    Back to Top 


    Simple Actions

    Simple action replies are charged at the standard Campaigner rate unless the reply exceeds a single SMS message (160 characters). If the reply exceeds one SMS message it is charged in the following manner.

      

    length <= 160 char

    1 message
    length <= 300 2 messages
    length <= 450 3 messages

      

    Back to Top 


    Echo the Message

    This is a test feature to check connectivity between the handset and the Campaigner Service. There is no known useful function for this action aside from testing. If you find a useful function then feel free to tell us about it so we can update this section.

     

    Back to Top 


    Reply with Static Message

    The most basic action simply replies with an acknowledgement message. This is useful for: 

    • Obtaining expressions of interest. 
    • Being notified of events. 
    • Using as a fall through action when the request doesn't match any of your other keywords. 

     

    The sender gets acknowledgement and you are able to report on who has sent messages and follow up where necessary.


    For a bit of fun try setting up your own 'SMS text based game' by responding to each keyword with a short story line and additional reply options for the user. Lead them through a fantasy scenario with text and then reward them with videos and sound samples. Your first Reply could be



    You are standing on a stairwell, You are confused and don't know how you got here.

    Do you go "upstairs", "downstairs" or open the "firedoor" beside you?


     

    The story can change and grow as you much as you want by creating and editing the upstairs, downstairs and firedoor keywords and any others you create for your game. 


    Static replies can be taken to another level with Dynamic Response Tags. These tags allow you to customise a message sent back to the user depending on the request content.


    Back to Top 


    Send an embedded URL by SMS

    While Campaigner can deliver WAP Pushed media messages, some handsets may not be able to support them. A broader acceptance can be gained by including a URL in a SMS response.


    Using Dynamic Response Tags you can personalise your static message and deliver SMS messages with tailored URL's embedded in them that users can open on their handset and/or an internet connected PC.


    Handset support of URL's in SMS messages varies. Some handsets immediately recognise them as a Web Link, others require the user to manually 'search' the SMS message for email or web links and some do not recognise them at all. The benefit of sending the full URL is that the recipient can always enter the address in their PC browser if the phone does not support the link or the page.

     

    Back to Top 


    Forward the message to an email address

    This is a simple way of receiving SMS messages by email. Simply set up the email address you want messages forwarded to, the subject of the message and the content of the reply SMS. You can also choose between your own email address (configured in Bulletin Online) or use the Bulletin Messenger format.


    Combined with the Bulletin Messenger email to sms feature, mobile users can initiate a threaded conversation between your email and their handset using patented mTag technology.

      

    Important


    To reply using Bulletin Messenger:

    • You need to be subscribed to the Messenger service. 
    • The email address you use to send messages needs to be configured in the service. Contact Bulletin to add your email address to your Bulletin Messenger Account.
    • Replies sent by Bulletin Messenger will use a different sender number than the automated ones from Campaigner.


    Use Dynamic Response Tags to customise the email subject line and SMS reply content. If you do not want the sender to receive an acknowledgement SMS or further information then this can be configured here.

     

    Back to Top 


    Forward the message to another mobile

    This allows you to receive messages on any phone that are sent to a short code or a static number. This is useful when: 

    • You don't want to publicise your private mobile number. 
    • You have different people needing to get a message at different times. Simply change the forwarding number (use international number format) and new messages will be routed immediately. 

     

    You have the option of including the keyword or the sender mobile number in the message that is forwarded to you. If you choose to include the number then the keyword will be replaced.

     

    Back to Top 


    Forward Campaigner to a WebService

    Bulletin Campaigner can integrate with your own applications through a simple HTTP POST redirector based on the Bulletin Connect PUSH interface. Campaigner will deliver all Dynamic Response Tags to the web service allowing you to concentrate on content delivery, enterprise integration and user-contributed ecologies while leaving the SMS initiation to Campaigner.


    Example PUSH message

     

      • Handset 642987654321 sends the following message to the New Zealand short code 4040 which has keyword of stockchart setup with a REST forward action passing messages to www.yourstockcharts.com/sms/in, which could be used to send back a dynamically generated chart as a WAP PUSHed image:  

     

    stockchart goog month

     

      • Campaigner will push the message out with a HTTP POST of: 

     

    http://www.yourstockcharts.com/sms/in?from=642987654321&to=4040&body=stockchart+goog+month
    &args=goog+month&keyword=stockchart&arg1=goog&arg2=month


    Campaigner will include all the Dynamic Response Tags as parameters and you should parse these as named pairs rather than by location as further parameters may be added in the future.


    Note that the value pairs of arg1, arg2 etc will not exist if the SMS message only contains a keyword.

     

    For additional developer information and options see the Bulletin connect - Developer Guide. 

     

    Important

    • This action should be used in conjunction with a Bulletin Connect account that will be used to send reply messages as, by default, Campaigner does not send any replies for this action except for a basic SMS acknowledgements.
    • Users of the Shared Public Numbers can not reply using the same number as a mobile sends the request to.
    • Users of dedicated numbers can request a rateCode that is used to set the source number when sending a message.

     

     

    Back to Top 


    Send Business Card Details 

    A vCard is an electronic business card in a standard format. These Business Cards are supported by handsets with smart address book features.


    When configuring a vCard in Campaigner you should fill out as much of the information as possible although only the following fields are required. Fields that are not supported by the recipient device are ignored. 

    • Name. 
    • Phone - Work. 

     

    When someone sends a keyword request for a Business Card, the message is sent back in an EMS format. How this is displayed to the recipient depends on the recipients network and handset configuration. Generally they will be told that they have been sent a business card and asked if they would like to add it to their address book.


    When you advertise a vCard service be sure to tell people that their handsets require vCard support. You may also choose to configure another Static Reply action that sends a basic SMS message with your Name and contact details in a short message (SMS).

     

    Back to Top 

     

    Send a vCalendar

    A vCard is an electronic calendar item (appointment or event) in a standard format. These are supported by handsets with smart calendar features.


    When configuring a vCalendar Appointment in Campaigner you should fill out as much of the information as possible although only the following fields are required. Fields that are not supported by the recipient device are ignored. 

    • Summary. 
    • Start Date/ Time. 
    • End Date/ Time. 

     

    When someone sends a keyword request for a vCalendar, the vCalendar item is sent back in an EMS format. How this is displayed to the recipient depends on the recipients network and handset configuration.

     

    Generally they will be told that they have been sent a appointment and asked if they would like to add it to their calendar.


    When you advertise a vCal service be sure to tell people that their handsets require vCal support.

     

    Back to Top 


    WAP Push your Gallery Media

    A WAP Push message is a special format EMS message that is generally used on 2nd and third generation GSM handsets that use advanced features on the phone.


    When setting up Media replies from your Campaigner Gallery you will be asked to select the media file/s (image, sound or video) and add a short message/subject for the page. This description will be used in all the messages the media is used in. You can select more than one bit of media and each will be included in your message.


    When someone sends a keyword request for this action a WAP Push message EMS is sent back to the handset. Depending on the handset the process of opening and viewing this content may vary but is usually very simple.


    Messages can include sound and image files and while the images will be displayed on the handset when the recipient opens the message, sound files will need to be downloaded by them, usually simply by 'clicking' the link to the file in the message.


    Campaigner Dynamic Response Tags can not be used in the Description for Gallery Media message configurations.


    New media can be uploaded using the Media Manager tool.


    Images

    GIF and JPG images can be distributed via Campaigner. Images that are larger than 30KB or 200px (width/height) are resized and optimised. Animated GIF files may lose their animation during the optomisation process.

     

    Video

    3GP video format is supported for mobile delivery. This video standard has been designed for mobile devices and provides the greatest level of handset support.


    There are a number of software tools available on the internet if you need to convert your existing video files to 3GP format.

    For some introductory information on handset video support see this supplementary page

     

    Audio

    Campaigner supports distribution (upload and delivery) of MIDI and MP3 format audio files. Sound files are not optimised by Campaigner and tend to be large files. Be aware that user may incur data charges for downloading media.


    Back to Top 


    WAP Push Internet Content

    If you have content on the internet that is suitable for WAP delivery (search results, images, simple web pages) then you can setup keywords to reply with a WAP push message containing a link to that data.


    This is useful if the internet content changes regularly (eg new image each day) or the website delivers dynamic content depending on userdefined requests.

     

    Using the Campaigner Dynamic Response Tags you can build a URL that will deliver tailored content based on additional words in an SMS query. This powerful feature unleashes dynamic internet content for your users.

     

    Back to Top 


    SMS an Extract of a Web Page

    Campaigner can deliver live content from dynamic webpages and blogs so you don't have to maintain your information in two places.


    In a couple of easy steps you can configure the *Send extract from a web page" action in Campaigner:

    1. Enter the full URL of the webpage or blog you want to get the information from. 
      1. Use the Open Page button to confirm it is the right page 
    2. Use the View Text button to see the page as Campaigner does. This cleans up the text and makes it easy for you to locate what you need. 
      1. If you can see the content in the "open page" but not in the "view text" then it maybe that the webpage includes frames or javascript content. Generally you can do a view source on the webpage and see if there is another URL you can use. 
    3. Decide if you want to: 
      1. show the first n characters of the page (default), or 
      2. Define the start and/or endstrings to locate and extract text inside a page. 
        1. If you choose both start and end strings then Campaigner will attempt to send upto 420 characters from between those points. 
        2. If you choose only a start string then Campaigner will send 300 characters (2 SMS messages) from that point in the page. 
        3. If you enter only the end string then Campaigner will extract upto 300 characters before that point in the page. 
        4. If you choose this option but do not enter a start and end string then the first 300 characters of the page will be sent (2 SMS messages) 
        5. If you want to use a line break as the start or end string then use "\n" to indicate this. 
    4. Preview the Extract. 
    5. A new window will open with the content extracted based on your rules. You can then adjust the rules (e.g. Exclude or include the start and/or end strings from the results) and preview until the content matches your expectations. 
    6. Save your Campaigner. 

     

    Example

    This is what is displayed in the "View Text" window and I want to provide as much relevant detail as possible in 420 characters.



    Feedback

    Remuera

    Back

    LEAFY EUROPEAN HIDEAWAY

    Click image to enlarge

    Townhouse

    4 Bedrooms

    Double

    1 Sep Bathrooms, 1 Sep WC's, 1 Ensuite, Bath

    No lawns to mow. No roads to cross. A few doors from & on the same side as

    King's Prep, this restful Warren & Mahoney-designed haven - is a peaceful

    slice of heaven, sheltering in a leafy garden. Spacious interconnecting

    living areas, an upstairs conservatory and 3 of 4 bedrooms bask in sun.

    For absolute ease, bi-folds open ground floor living to a courtyard and

    terrace garden. Sort out your priorities in a superbly designed home that

    makes city living exceptionally relaxing!

    For Sale

    $1,575,000

    Contact

    Leila MacDouglas

    m. 027 928 9222

    p. 214-0147

    broker@bananasales.co.nz

    Reference Number

    327164

    38114/2732

    Open Home - 98 Portway Rd


      

    By looking at a number of pages on this site I see that the format is always the same. This makes it very easy to configure Campaigner to "scrape" the site using dynamic tags in the URL (e.g. the property ID/Reference) to get different information depending on the Campaigner request. 

     

    If you are building your own webservice, that will react to requests from Campaigner, then consider building it with the $!{url-params} dynamic tag in mind. This one dynamic tag will pass your web server all the information relevant to the SMS request and send the results from your application back to the Mobile.


    This means that we look after the messages and you look after the content. It could not be easier!

     

    Important: Do not add the dynamic tags until after you have setup and fully tested the action with a real URL



    I select the start string as Click image to enlarge and exclude it. The end string could be left blank so the maximum messages will be sent however some of the property descriptions are short and I don't want to send message unnecessarily. Instead I set the end string to Reference Number and exclude it.

      

    This is what is now sent to the phone as shown in the preview.

     


    Townhouse

    4 Bedrooms

    Double

    1 Sep Bathrooms, 1 Sep WC's, 1 Ensuite, Bath

    No lawns to mow. No roads to cross. A few doors from & on the same side as

    King's Prep, this restful Warren & Mahoney-designed haven - is a peaceful

    slice of heaven, sheltering in a leafy garden. Spacious interconnecting

    living areas, an upstairs conservatory and 3 of 4 bedrooms bask in sun.

    For absolute ease, bi-folds open ground floor li 


     

    It may not be the full story but now anyone standing outside this property, or reading the newspaper, can get a little more information and you get their phone number for follow up!


    For greater impact you could start to factor Campaigner into your website design so that key information is easily extracted.

      

    Important

    • Use of third party web site content may violate copyright laws.
    • Content of website must be publically accessible for this Action. Any site that relies on cookies or user authentication can not normally be used easily.
    • If the URL is not valid when the request is made, no response will be sent.
    • This action uses a HTTP GET method.

     

    Back to Top 


    Lookup SMS Response from a File 

    Campaigner can deliver content from files up upload and store in the Application.


    In a couple of easy steps you can configure the Lookup From File action in Campaigner:

    1.  Prepare your file 
      1. We recommend an INI file format as being the easiest to work with. This format has key and value pairs that makes it easy for users to send the key in an SMS and get the value as the SMS response. 
        The file should not be larger than 200KB for performance reasons. If your file is larger than 200KB please contact Bulletin for assistance and alternative suggestions. 
        For a working example of this sort of file see here. 
    2. Upload the file in the Lookup From Fileset up screen. 
      1. View the file if necessary. 
    3. Add a Comment if necessary that will be shown before or after the content in each message. This is optional. 
    4. Set the start string which will usually be what the user sends in their SMS request. Familiarise yourself with Dynamic Response Tagsas these are important for this action. 
      1. If you are using a specific keyword then the Start String will be the second word of the SMS message, e.g. "$!{arg1}" (this is the default). 
      2. If you are using the file as you sole source of response messages (eg using a * wildcard) for your dedicated number) then the start string will need to be "$!{keyword}". 
      3. Usually you would choose to include the start string as this gives your reply some context to the recipient. 
      4. If you do not set an start string then Campaigner will send up to 300 characters from the beginning of the file (or until it reaches the end string) which may not be what you want. However, it is a good idea to have a default message at the begining of your file so that it is used if someone sends a request that you have not catered for. 
    5. Set the end string which may be a new line or some other set of characters. 
      1. For the example two dashes (eg "--") are used to indicate the end of the reply content. 
      2. If you want to end the message at the end of the line (in the file) then set the end string to "\n". 
      3. Normally you would not want to include the end string as this is just to tell Campaigner where the message stops. 
      4. If you do not set an end string then Campaigner will send about 300 characters from the start string which may not be what you want. 
    6. If you Preview the Response the response now you will not get anything interesting. This is because the Dynamic Response Tags are being used which are not evaluated until a message is received. 
    7. To test your action you have a choice 
      1. Save the action with the Dynamic Response Tags and then Test your setup using the option under the Help menu. This is the recommended way to test Campaigner keywords. 
      2. Alternatively you could replace the start string with a value from your file and then use the Review Response option. This will give you an idea of how the message will look. 
    8. Don't forget to Save your Campaigner keyword and Test it. 

     

    Example

    This is the start of what is displayed in the "View Response File" window:

     


    Sorry, Can't find the E Number you entered. Make sure the number starts with 'E' eg 'Food E200'--

    E100=Curcumin: orange-yellow color, derived from turmeric, a member of the ginger family--

    E101=Riboflavin (vitamin B2): yellow color, it's a vitamin!!!--

    E102=Tartrazine: yellow color, commonly used, HCSG recommends to avoid it. in soft drinks, confectionary, cordials, pickles--

    E104=Quinoline yellow: not allowed in Australia--

    E107=Yellow 2G: yellow color, HCSG recommends to avoid it. People who suffer Asthma may also show an allergic reaction to it. in soft drinks--

    E110=Sunset yellow FCF: yellow color, HCSG recommends to avoid it. Some people show allergic reactions to it (rashes, swelling, vomiting). in cordials, confectionary, packet soups--

    E120=Cochineal, carminic acid: red color, HCSG recommends to avoid it. Rarely used--

    ...

    ...


      

    * Note the first line that includes a message that will be sent if Campaigner can not locate the "e" number in the file. 

     

    I am wanting to start each response with a short introduction and include the "E" number as part of the response. Since the Campaigner Keyword in this case is "chemical" the Start string is the next word in the SMS message, a.k.a the first argument. This setup is pictured below:

     

     

    The Preview Response shows the default message since a valid Start String is not provided:

     


    Food Additive: $!{arg1} 

    Sorry, Can't find the E Number you entered. Make sure the number starts with 'E' eg 'Food E200'



    However, if I test this action now with a valid "E" code I would get this response:

     


    Food Additive: E102 E102=Tartrazine: yellow color, commonly used, HCSG recommends to avoid it. in soft drinks, confectionary, cordials, pickles 



    Now, all your information is retained in one file and when you update that file you simply upload it in Campaigner and save. Any changes are immediately there for the next person that makes a request. (You should probably test it just in case, though.) 

     

    Back to Top 


    Send Email To Supplied Address 

    This action allows you to process a message and attempt to send an email using information you provide.


    Basically this means that you would ask the user to send their email address to your dedicated number and then use either the Email Address or the Default Fallback keyword classes to process the message and send an email to the address they provided.

     

    Before setting up this action ensure that you at least a text file that contains the email content you want delivered and will probably also want to provide an attachment such as a PDF that is probably going to be a promotional flyer, information pack or vouchers.

      

       You can also provide an HTML formatted file.

      

    When you setup this action you should upload the files you have prepared and then complete the setup with the Subject line (required) and the SMS reply options. You can also set a BCC address if you like.

      

    Dynamic Response Tags are available not only for those settings you enter onscreen (Subject, SMS Reply and BCC) but also for the files you upload (see the examples for an example) that contain the email content.

     

       

    1. All emails will be sent from your registered Bulletin Online email address and you will receive replies and bounce messages there.
    2. The first string will be used as the email address and a bounce email will be sent to your email address if this is not a valid email address. 

      

      

    View the config and preview using the data provided below.


    Example email file content - Text Version


    Save this example into a text file and then upload it when setting up your action.

     


    Thanks for your interest. Please see the attached file for more information.

    This email was requested by $!{from}.

    Powered using Campaigner (http://www.bulletincampaigner.com)



    You can see that the dynamic tag for the mobile number (e.g. $!{from}) is used here and will be replaced with the actual number when the email is sent.

     

    Example email file content - HTML Version


    Save this example as a .HTML file and then upload it when setting up your action.

     


    Thanks for your interest. Please see the attached file for more information.

    This email was requested by <b>$!{from}</b> using <a href="http://www.bulletincampaigner.com">Campaigner</a>


      

    Back to Top 


    Publishing your Keywords


    Campaigner and Bulletin will allow you to selectively publish your keywords along with a short description so that people will be able to access your content. 


    When creating or editing your keyword you will have the option of setting additional properties for publishing it and giving it a short description.

     

    Published keywords will be displayed on the Campaigner and Bulletin Website. You can stop your keyword from being displayed by editing it and changing the publish setting.

     

     

    All published keywords are subject to the terms and conditions and may be removed or altered without notice.

     

    Back to Top 


    Managing your Media


    Campaigner can host some common media items for you to use in your Enhanced Messaging when an Campaigner response of WAP Push your Gallery Media is used.

     

    In the Gallery Manager screen you have the option of uploading any Supported Media and providing a short description for the file. If you need to rename or change the description of a media item you (currently) need to go through the process of uploading it again and entering a new description.

     

    Campaigner may reduce the size of your larger images in order to optimise them and reduce the download times and data usage for recipients of your media. During this process any animations may be lost. If this happens you could attempt to reduce the size of your files (width and height less that 300px) and upload again.

    Back to Top 

     

    Supported Media

    Uploading media to Campaigner does not imply that all handsets will be able to receive and/ or display it.


    File Types

    File Extension

    Notes

    Image gif  Good for still and animated images, supported on most handsets

    jpg, jpeg  Best Quality for still images and supported on most handsets
    Sound mid, midi  Low quality sound file, good handset support

    mp3  Good quality sound but large file size and may not be appreciated by recipient
     Video 3gp   Low quality video with sound for mobile distribution


    • If you are unable to upload a file with these extensions it may be of an unsupported subtype. Feel free to email a copy of the file to Bulletin and we will attempt to implement support for it.

     

       Important


    Distribution of copyrighted material is contrary to the terms and conditions of use and will result in suspension of your account. Further sanctions may also be applied.

    By uploading media and/or linking to media using Campaigner, you acknowledge that you are the holder of any copyright or trade marked material and that the service provider does not take any responsibility for material stored or accessed via Campaigner.

     

    Back to Top 

     

    Administration


    Testing your Setup 

    Once you have you keywords and actions setup you should test them extensively before beginning your campaign. Use the test feature to see how your configuration reacts to different queries/ keywords.

     

    Back to Top 


    Reports

    Customised Automated Reports

    Additional reports are available upon request (costs may apply) can can be emailed to you on a regular basis. Contact Bulletin with your Bulletin Login ID and the following details:

    1.  Email address for report delivery. 
    2. Report Cycle (Daily, Weekly, Monthly). 
    3. Content of report, for example: 
      1. Sender Number
      2. Number sent to
      3. Request Content
      4. Date and Time
      5. Reply Status

     

    Reports containing grouped information can also be arranged if required. Simply detail what you would like and we will get in touch to assist with your requirements.

      

    Back to Top 


    Need more control over your messages?


    There may be a time when your messaging needs are no longer satisfied by Campaigner. If that time comes, then you can continue to use the infrastructure Bulletin provides along with the power of threaded messages using patented mTag technology.

     

    Bulletin Connect (the message engine behind Campaigner) offers a simple to use API for programmers to send and receive messages, process receipts and thread conversations. See the comparison matrix for a matchup on key features provided by Campaigner and Bulletin Connect and then contact Bulletin for more information or to request a test account for Bulletin Connect.

      

    Back to Top


    FAQ


    For some common questions see the FAQ's. If you have any other questions contact Bulletin.


    Back to Top