Phone Manager

Phone Manager is an Umbraco package to manage and display marketing campaign phone numbers on your site to your visitors. Based on various criteria, a relevant telephone number can be automatically displayed to each user visiting your website based on how they got there.

The package is designed for organisations who use multiple telephone numbers to track the marketing source of a vistor.

The criteria include:

• Custom querystrings (such as used by various campaign systems)
• Referrer domain (e.g. a search engine)
• The page the user first enters your site on

...or a combination of any of the above.

The telephone number (and some campaign detail properties) the visitor gets is persisted by default for their current session, but this can be extended (via cookie) for a set number of days (specifed in the settings), so every time they return to the site they see the orignial telephone number, irrespective of how they get to your site in future. It is also possible to override an exisiting persisting campaign cookie if required.

Phone Manager performs its checks to select a relevant telephone number only on the first request in a new browser session - this is then stored in a session object for the remainder of the user's current session.

Implementing

The first step is to add one 'Phone Manager' document type to your content structure. It is recommended to add it once below your site homepage(s) (if you have multiple sites, you can add it to all your sites to allow you to set up separate campaign details per site). You might need to update your homepage(s) content type permissions to allow 'Phone Manager' as a child. You will probably also want to create a 'custom list view' on the 'Phone Manager' document type so you can see relevant phone details easily. Some useful field you could use are: pageTitle; telephoneNumber; campaingCode; isDefault.

Then add a new Campaign detail record for each possible user. You must include a Telephone number in each record. Please note that you will need to add a 'default' record (with 'IsDefault' checked) to cater for any general site visitors who are not coming from a campaign.

Finally you need to set a start node for the 'Phone Manager - Campaign detail - Entry page - Content Picker' data type (in Developer -> Data Types). Choose your Homepage node.

Setup Templates

You will then need to update any templates or views where you want the telephone number displayed. You can do this to any content which inherits from IPublishedContent. The package extends IPublishedContent to include the following detail:

• Telephone number for the campaign
• Campaign Code
• Alternative Marketing Code

It is added like this:

 <div class="phonenumber">@Model.Content.PhoneManager().TelephoneNumber</div>

If needed you can also display or use the following properties:
 @Model.Content.PhoneManager().Id (this is the nodeId of the selected campaign detail)
 @Model.Content.PhoneManager().CampaignCode
 @Model.Content.PhoneManager().AltMarketingCode

For more detailed information/documentation: https://github.com/willroscoe/UmbracoPhoneManager

Change Log

1.0.2 Allow Phone Manager in content root
1.0.1 Updated dependencies; Added umbraco package icon