This post is a short video tutorial that shows how to add custom dimensions to Webtrends.

Having setup event tracking on Webtrends, you’ll likely want to build reports in the Webtrends admin UI. Even after adding event tracking JavaScript, reporting of your dimension or measure doesn’t just happen magically. Webtrends needs to know what to look for. So, before you can create reports, you’ll need to add the dimension.

When creating custom dimensions or measures from events tracked via dcsMultiTrack, example query parameter DCSext.w_custom_identifier will be converted into w_custom_identifier in Webtrends, so this is the name of the query parameter that you then add in the Webtrends Admin UI.

How to add a new dimension

Check the short video below for details on adding new dimensions:

How to add a new dimension based on a lookup table

Lookup tables are a great way of converting one metric into another within Webtrends. The easiest way to create a lookup table is to add a CSV file under the Webtrends installation directory here:
.\wtm_wtx\datfiles\datasources\MyLookupTabel.csv
If you use Webtrends On Demand, then you’ll have to submit the lookup table to Webtrends for them to install.

Check the short video below for details on adding a new dimension based on a lookup table

In Webtrends, events that happens after the page loads can be tracked using dcsMultiTrack.

This takes the following form:

dcsMultiTrack( key1, value1, key2, value2, key3, value3, ... );

But what if you don’t know how many key/value pairs you’ll be sending into dcsMultiTrack? How do you call it then?

Take advantage of the JavaScript apply function. Create an array of key/value pairs and then apply that array to the dcsMultiTrack function:

var webtrendsArgs = [
	'DCSext.w_event_type', 'Video Started',
	'DCSext.w_video_id', 'xxxx-yyyy-zzzz-1234',
	'DCSext.w_video_name', 'Kitten Video'
	];

dcsMultiTrack.apply(this, webtrendsArgs);

This is equivalent to:

dcsMultiTrack(
	'DCSext.w_event_type', 'Video Started',
	'DCSext.w_video_id', 'xxxx-yyyy-zzzz-1234',
	'DCSext.w_video_name', 'Kitten Video'
);

If needed, you can add the key/value pairs to webtrendsArgs array incrementally and when complete, apply this to dcsMultiTrack at the end.

Source: StackOverflow

People have been shouting from the rooftops that Confluence 4 has finally arrived. Despite all the hype, it’s a cracking release. I’m not going to list all the features here, as you can find them elsewhere. However I will mention one…

The new editor

Simply put, it’s fast, slick and gorgeous looking. It works better than any online editor I’ve used elsewhere. It is a design that would make Antoine de Saint-Exupéry proud.

Wiki markup is dead

Past experience shows that people’s fondness of wiki markup is somewhat akin to that of Marmite. So it seems quite a bold step to ditch this aspect of the editor for something completely new.

Long live wiki markup

The good news is that behind the scenes, wiki markup is alive and well — all the new editor’s great keyboard shortcuts are based off of the syntax that many people know so well.

The final irony being that wiki markup haters may just start using wiki markup in their “faster, richer, simpler” editing experience.

Now, see what I mean:

Find out more.

A quick demo of a Confluence plugin for a staff & student directory at the University of Nottingham.

Developed by David Simpson and Shaun Hare back in 2010.

Last Tuesday, I went down to the National Archives at Kew, attended the London Atlassian User Group and presented a talk on “Confluence and Analytics”.

In the morning there was a meet up with Atlassian plugin developers from all over northern Europe. We discussed amongst other things Adaptavist’s new plugin licensing system and Active Objects – a database independent sandboxed ORM plugin for all Atlassian products.

The afternoon was dedicated to the main user group event. There were over 150 people in attendance. Introduced by Guy Fraser from Adaptavist, the meeting quickly split into a user and a technical track. I stayed in the user track which consisted on a series of user case studies from organisations as diverse as the National Archives (our hosts), Steve Sinnott Foundation, Risk and Safety Plus and NYL Line. These were punctuated by plugin demonstrations from RefinedWiki, K15t Software and my own talk representing AppFusions.

Slide from my talk are available here…

After all that talking, we adjourned to the Kew Gardens Hotel for continued discussion and some welcome refreshments on such a sunny spring day. It was a great opportunity to meet up with such a large group of developers and end users.

On Monday, I travelled down to the beautiful city of Bath to attend The Big M — “a brand new independent mobile focused event aimed at those who want to learn from and connect with the very best people in the industry.”

This was a single track conference with around 200 developers and business people in attendance.

Raam Thakrar — App distribution and monetisation – the only things more important than lines of code

Raam is keen on the business of distributing and monetising mobile apps. His business is an m-commerce startup selling physical photo postcards taken and ordered directly from the phone. He is very interested in cutting deals with carriers to ensure his app is preloaded on as many handsets as possible and integrated into the camera and gallery.

He believes that mobile developers should be treated like rockstars. Hmm. Well paid like rockstars at least — $120k+ per year after 5 years experience or put down your laptop and walk away.

Soundbites:

• If you are not going to rule the world – go home. Have those ambitions!
• Making an ROI on apps is very difficult without the help of a distributor
• Develop an app that makes the phone look awesome

Aral Balkan — Beyond Usability on Mobile

Aral is a very slick presenter. An inspiring guy who knows a thing or two about usability and designing a “magical” user experience.

He discussed real world experiences with bad or inconsistent design e.g. on trains and hotel elevators. Then moved on to discuss the reasoning behind design decisions on his iPhone apps. e.g. ease of use over oAuth on his twitter app feathers and “delighters” — extra layers of detail which give joy to the user.

He also warned that the user experience is only as good as the weakest link. e.g. reviews of feathers have nose-dived after the change to the twitter API.

Soundbites:

• Why are we willing to pay extra for a particular commodity? The differentiating factor is user experience
• User experience is a cross-cutting concern. You either have a focus on it from the top of your business or you don’t
• Design is not democratic – it is a dictatorship if you want to stay focussed on simplicity

Bruce Lawson — Web Anywhere

Bruce gave a whistle-stop tour of his recent SXSW talk. It was a great introduction for people who need to catch up on what HTML5 + CSS3 + JavaScript have to offer you and some very handy hints.

He crammed in a massive amount of information considering the time he had. Topics covered included responsive web design, progressive enhancement, HTML5 forms, application cache, W3C widgets

Soundbites:

• Refactor for a small screen, don’t dumb down for mobile
• If your javascript must be in the header, put it after the CSS so you don’t see unstyled content whilst it loads
• Most of that works in the 4 modern browsers, and it works in IE9

See the slides:

Ewan MacLeod — State of the Union – Mobile Address

Ewan is not a happy man. In fact he is very angry. Angry at mobile carriers. Angry that the world does not work the way he wants.

Update: Doodle by @wordbeard

Ewan made a lot of very good points about the current state of mobile, but he needs to deal with himself. He seems to want everything in life reduced down to a cold, hollow transaction.

He seems happier to trust the information accessed from his handset than discuss matters with real life people. It seems that he’s trying to strip the humanity out of his life. Let’s hope that people like Aral can inject some back in via decent usability and “delighters” in the apps on his handset.

To be fair, Ewan was really just looking for a response from the audience. From what I could see, the audience looked a little nervous.

In many ways, he reminds me of my driving instructor who told me “If they leave the car crying or calling me a bastard, at least I know they listened”.

I’ll remember his points, so his shouty delivery must have worked on some level.

See the slides:

Paul Golding — Future Innovations in Mobile

This was the highlight for me. A great talk from a man with buckets of experience — 21 years working with mobile, 16 patents in GSM, PhD in AR.

This touched on so many areas of importance for start-ups and not just those devoted to mobile.

Soundbites:

• Be the first to win, not to market
• ROI of doing nothing is nothing
• Code towards customers
• Innovate where it matters
• Think biz models, not technology
• Try Osterwalder’s biz model canvas

See the slides and explore the references:

My Verdict

The lack of wifi meant it was a real dog-fooding experience for the mobile industry. O2 provided very patchy coverage, so I’ll concede that Ewan had a good point in some of his ranting. On the other hand it’s good to disconnect from time to time.

It was a thought provoking day that gave me plenty to reflect on during the long drive back to Nottingham afterwards. I’ll be picking over the sources for Paul Golding’s talk for a little while yet.

It also gave my a great opportunity to finally visit the Roman Baths whilst I was in the city. Thanks to Mike Ellis and co for a great day.

I’ve said it before, but I’ll say it again — I like to #measure. Google Analytics has a great feature called Advanced Segments. Using this feature, you can easily show a subset of data.

Sharing advanced segments with other users

One of the ways I use advanced segments is to categorise traffic into user types. It works really well and the great thing is that any advanced segment you create, you can also share with other Google Analytics users.

The links below are examples of some advanced segments I created for the University of Nottingham. If they seem helpful to you, feel free to use them as part of your Google Analytics reporting activity. To use them, simply login to Google Analytics and then click on the links below.

• Visits from the University of Nottingham (Campus)
• Visits not from the University of Nottingham (the opposite of the previous one)
• Visits from the city of Nottingham
• Visits from China
• Visits from Malaysia

Tutorial

Here’s a nice tutorial video from GoogleBusiness on how to create and use your own custom advanced segments:

Last week I released Analytics Plugin for Confluence 1.2 on the Atlassian Plugin Exchange.

It’s been 6 months since the initial release which was only tested on Confluence 3.0. This time I’ve added a new dashboard section, full support for Confluence 3.1 & 3.2 and a pile of macro parameters as requested by Guy Fraser. The release notes are here. Confluence 3.3 is just around the corner, so I’ll add an update for that when it comes out.

Thank you

The Confluence community has shown a great deal of support and encouragement since the plugin was originally released. For example, Atlassian blogged about it before I got a chance to. So thanks to all for your support.

The plugin was name checked by Sherif Mansour – Atlassian’s Product Manager for Confluence in the Confluence State of the Union presentation at Atlassian Summit 2010 at the start of the month. Watch it all, but concentrate especially around 5:10!

This week Google approved the plugin for their Google Analytics Application Gallery — take a look here. The Apps Gallery has only been going for about a month so I’m really excited about being a part of it. The slight name change and new logo were done to fit in with the Application Gallery Policy.

In the future

The next release should support Confluence 3.3 and also complete tracking of all pages in a space — not just those with a URL starting /display/spaceKey/ — based on this hack :

// Add a page-level custom variable to record the space-key
if (typeof jQuery('meta[name=confluence-space-key]').attr("content") == 'string')
{
  pageTracker._setCustomVar(
    1, // This custom var is set to slot #1 of 5

    // The name acts as a kind of category for the user activity
    'confluence-space-key',    

    // This value of the custom variable
    jQuery('meta[name=confluence-space-key]').attr("content"), 

    3 // Sets the scope to page-level
  );
}

— If you want to use this hack now, try out this custom Google Analytics report which will allow you to take advantage of it now.

I’d also like to add full space specific tracking for attachments too.

A quick demo

And finally, this is what the new version looks like:

Related Posts

• Tracking Atlassian Confluence usage with Google Analytics
• 4 Useful Tips on Google Analytics Reporting for Confluence
• Announcing: Google Analytics plugin for Confluence – original release

This website and one or two others I run recently experienced what appeared to be a denial-of-service attack.

Looking at the access logs, I could see several tens of thousands of requests all originating from a range of amazonaws.com IP addresses. All with the useragent “bitlybot”.

This post is a quick postmortem of what went wrong and why.

So what happened?

I’ve been happily using the excellent bit.ly URL shortening API on the Readability Test Tool website for over a year with no problems at all. Whenever a user checks the readability of a web page using the Readability Test Tool, a convenient “tweet this” link is provided for the results page.

My bit.ly link also innocently appended a query string — &utm_source=twitter&utm_medium=retweet — so that I can track click-throughs from Twitter in Google Analytics.

Looking back at this, it wasn’t that clever a thing to do, but it only took a couple of minutes to implement, so was very little effort for a nice bit of analytics/measurement return.

All was good for a year. Google Analytics tracking worked well. There were no problems. Indeed looking back at the access logs, the bitlybot user agent had not so much as sniffed the website once in that time.

One day, something changed. Overnight bitlybot started crawling my website for all the links it had created over the year. Unfortunately for every link it crawl, it also created another link appending more parameters to the query string.

Which it then crawled. Creating another link with more appended query parameters. Ouch.

e.g.

http://www.read-able.com/check.php?uri=http%3A%2F%2Fwww.example.com%2F&utm_source=twitter&utm_medium=retweet

http://www.read-able.com/check.php?uri=http%3A%2F%2Fwww.example.com%2F&utm_source=twitter&utm_medium=retweet&utm_source=twitter&utm_medium=retweet

http://www.read-able.com/check.php?uri=http%3A%2F%2Fwww.example.com%2F&utm_source=twitter&utm_medium=retweet&utm_source=twitter&utm_medium=retweet&utm_source=twitter&utm_medium=retweet

And so on.

What did I do?

Initially I ranted on Twitter.

Then I removed the “tweet this” link to prevent further bit.ly URLs from being created. This wouldn’t stop things for while, but would at least prevent the problem from getting any worse.

Then I edited robots.txt:

# Tell "bitlybot" not to come here at all
User-agent: bitlybot
Disallow: /

This did not work – bitlybot only checks robots.txt once a day, so this would not improve matters instantly.

Then I redirected the traffic to bit.ly:

if ($_SERVER['HTTP_USER_AGENT'] == 'bitlybot')
{
	header('Location: http://bit.ly/', true, 301);
}

That slowed it a bit. Admittedly, I was still blaming them at this point.

Then I reached out to @bitly.

They were very responsive. I sent them a detailed email with a section of access logs and they fixed it. Quickly.

They disabled my account, preventing me from causing any further mischief. They stopped bitlybot from it’s crawling activity and reported the progress back to me.

Each contact with bit.ly via twitter or email resulted in a positive response — they were very quick to respond and my websites were soon back to their usual somewhat diminutive volume of traffic.

Conclusions

• Bit.ly has excellent support – they are very responsive and my little server was soon back to normal
• Think before you write code that uses other people’s APIs – you may not fully understand the consequences of your actions
• My Google Analytics tracking parameters were added with little thought – I really ought to have tried a bit harder to weigh up the implications
• My small VPS does nicely thank you for the limited traffic that it experiences. Given some decent volumes of traffic it will fail.

Update: 2011-09-20 With the release of Confluence 4.0, this post obsolete.

A simple Confluence user macro to hide access to the View Wiki Markup menu link…

{hide-wiki-markup}

One thing I love about Confluence is the way that you can browse other people’s pages and steal their superior layout ideas for your own wiki pages.

It’s dead easy to do. Go to the Tools drop down menu and click on the View Wiki Markup link. A new window will open containing the wiki markup for the page. You can now copy the bits you like and discard the rest. Your friends and colleagues will be impressed by your wiki skills and you can continue on your path to becoming a wiki ninja.

But what if you don’t want to share those wiki markup skills?
That’s not very collaborative, I know. But there are entirely valid reasons that you’d wish to disable this feature.

An example of this is use of the {sql} plugin. This is a really powerful plugin that allows you to query databases and tabulate the results in Confluence. Wrap this in a {chart} macro and you have an instant graph. Nice work! There’s a great blog post at Atlassian that use this to great effect.

Security

However, using this kind of markup on a public website is a bad idea. Exposing the structure of your databases to people you don’t know and can’t trust is somewhat short sighted. On a company intranet, the risk is still there, but hopefully it is not so dangerous. Even so, it’s really best not to show this information in the first place.

What can we do about it?

The best solution would be additional security in the product that allows editors to prevent others from viewing wiki markup. It would probably go in the Restrictions screen. This does seem somewhat like a paranoid feature request, but call me paranoid.

Another way is to use Javascript to remove the link from the DOM. This is not a replacement for good security, but will stop the casual user from accessing the wiki markup.

It is easily done in a user macro:

As a Confluence administrator, go to Confluence Admin | User Macros and click on Create a User Macro.

Fill out the form…
Macro name: hide-wiki-markup
Output: Macro generates HTML markup
Template:

<script type="text/javascript">
jQuery('#action-view-source-link').parent().hide(); /*Updated from .remove(); Aug 2010*/
</script>