Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me
You are here: Home / Robert Desprez | Vancouver technical writer | Blog / FIVE WEB ANALYTICS METRICS FOR TECHNICAL WRITERS

FIVE WEB ANALYTICS METRICS FOR TECHNICAL WRITERS

April 1, 2011 by RDesprez 4 Comments

Tweet

By using Google Ana­lyt­ics tech­ni­cal writ­ers can dis­cov­er what con­tent they write is pop­u­lar, how long users read their con­tent, and where their cus­tomers live. This blog post is a sum­ma­ry of the main points I dis­cussed at my recent pre­sen­ta­tion at the Writ­er­sUA writ­ing con­fer­ence in Long Beach, California.

What is Web Analytics?

First off, web ana­lyt­ics enables tech­ni­cal writ­ers to see how users access your intranet, sup­port web sites, and even help sys­tems that are host­ed on a web serv­er. Some writ­ers that I’ve talked to seem to think that web ana­lyt­ics is com­pli­cat­ed to set up and use. Actu­al­ly, set­ting it up is pret­ty sim­ple, assum­ing you’re com­fort­able with adding a bit of Google’s code to your HTML page. Ana­lyz­ing your data is also pret­ty sim­ple for our purposes.

Why It’s Important for Technical Writers

I believe web ana­lyt­ics is impor­tant for two reasons.

First, it pro­vides insights into how your users are find­ing your site, how they explored it, and how tech­ni­cal writ­ers can enhance their expe­ri­ence. Most of us work in orga­ni­za­tions where there are lim­it­ed resources and a large of queue of work. With web ana­lyt­ics, you can quick­ly dis­cov­er the num­ber of peo­ple review­ing your con­tent for a giv­en peri­od (month­ly, quar­ter­ly, or even dai­ly), and which doc­u­ments are pop­u­lar and which doc­u­ments are large­ly ignored.

Sec­ond, with web ana­lyt­ics, I think that it’s quite pos­si­ble that our writ­ing will be monitored—even scrutinized—in cer­tain orga­ni­za­tions that are inter­est­ed in see­ing the effec­tive­ness of each doc­u­ment and sup­port top­ic we write.

Tris­tan Bish­op, a blog­ger and senior con­tent strate­gist, wrote about the use of web ana­lyt­ics and how it will change our jobs:
“It won’t be long before you’ll know which of your top­ics are mak­ing a pos­i­tive dif­fer­ence, which need some help and which can sim­ply dis­ap­pear. It will soon be painful­ly obvi­ous which team mem­bers are writ­ing the high-impact top­ics, which are writ­ing the unin­tel­li­gi­ble top­ics and which are writ­ing the irrel­e­vant top­ics.” Ouch.

What Can You Measure

For a free tech­nol­o­gy, it’s amaz­ing what you can dis­cov­er using Google Ana­lyt­ics. You can mon­i­tor the num­ber of vis­i­tors com­ing to your site or help sys­tem for a spec­i­fied peri­od, the num­ber of new vis­i­tors ver­sus return­ing vis­i­tors, the aver­age length of time users spend on your site, the key­words they use in a search field, the coun­try they live in, the brows­er they use to access your con­tent, and much more. In fact, if you’re inter­est­ed, you can keep tabs on dozens of met­rics. But for tech­ni­cal writ­ers, I think there are just a hand­ful of met­rics you might want to keep an eye on.

  1. Over­all traf­fic vol­umes. This is impor­tant because it gives you a sense how many peo­ple are read­ing the con­tent you write and sup­port. You can start per­form­ing com­par­isons of this month’s traf­fic ver­sus the pre­vi­ous month’s traf­fic. Are num­bers going up? How is it relat­ed to sup­port calls?
  2. Vis­it dura­tion. In gen­er­al, the longer a per­son spends on your site, the more like­ly he or she will return. In con­trast, if a per­son stays only a few sec­onds, you may deduce that there is noth­ing of val­ue to the user.
  3. Bounce rates. Strict­ly speak­ing, a bounce occurs when a vis­i­tor looks at just one page of your help or web site and then leaves the site quick­ly. If a vis­i­tor comes to your intranet or sup­port site and then imme­di­ate­ly clicks the Back but­ton, it’s con­sid­ered a bounce. If your bounce rate is high (expressed as a per­cent­age such as 50 per­cent), you may be draw­ing the wrong type of per­son to your intranet/site.
  4. Search key­words. Using ana­lyt­ics, you can track the most com­mon key­words that users search for while using your sup­port web site or help sys­tem, pro­vid­ing insight into the con­tent that cus­tomers want. So this may help you understand:
  • What are cus­tomers look­ing for and strug­gling with?
  • What are the most com­mon phras­es when peo­ple are searching?
  • As a writer, do you need to change the way you describe a pro­ce­dure or con­cept so it’s more in line with the way cus­tomers think of it?
  1. Top pages and con­tent. Know­ing what vis­i­tors are seek­ing out can help you tai­lor con­tent for them and help you prune the con­tent that isn’t being used. This may help you focus your efforts when it comes to under­stand­ing the best way to spend your time.

Setting Up Google Analytics

Google has done a good job of explain­ing how to set up web ana­lyt­ics on your web site or online help. For more infor­ma­tion, see http://www.google.com/analytics/discover_analytics.html

Oth­er resources worth reviewing:

Web Ana­lyt­ics: An Hour a Day by Avinash Kaushik
Kaushik’s blog: http://www.kaushik.net/avinash/
Web Ana­lyt­ics Demys­ti­fied by Eric T Peterson
Author Anne Gentle’s blog entry on web ana­lyt­ics:
http://justwriteclick.com/2010/09/01/web-analytics-for-technical-documentation-sites/
Google Ana­lyt­ics by Jer­ri L. Ledford

Filed Under: Robert Desprez | Vancouver technical writer | Blog, Technology, Web 2.0 Tagged With: key metrics for technical writers, setting up analytics, web analytics

Comments

  1. Adam Evans says

    March 17, 2012 at 4:54 pm

    Great post. At my com­pa­ny we have open source wiki-based doc­u­men­ta­tion, and we use our web ana­lyt­ics con­stant­ly to deter­mine how our read­ers are using it. Know­ing your key­word search­es is great. We’ve repo­si­tioned sev­er­al docs based on how peo­ple were try­ing to dis­cov­er it. Thanks for get­ting out the word about analytics.

    Reply
  2. Gail Haspert says

    March 17, 2012 at 4:54 pm

    This is a great mech­a­nism for know­ing more about how your audi­ence uses search­es and uses documentation.

    Reply
  3. SJH says

    March 17, 2012 at 4:55 pm

    These sta­tis­tics have ABSOLUTELY no rel­e­vance to tech­ni­cal writ­ers. They tell you noth­ing about the qual­i­ty of the writ­ing, the qual­i­ty of the orga­ni­za­tion, or how easy or dif­fi­cult it is for users to nav­i­gate and under­stand your pages. At the very best, you may be able to make some vague infer­ences about how much users “enjoy” your web­site. if most of your vis­i­tors only stay for a few min­utes (or worse a few sec­onds), then you can ASSUME that you have a prob­lem with either qual­i­ty of the writ­ing or orga­ni­za­tion of the site. But here again, the infor­ma­tion is only guess… you have absolute­ly no quan­ti­ta­tive infor­ma­tion about what you have pro­duced, only some vague sug­ges­tion that you have a problem.

    The num­ber of vis­i­tors is inter­est­ing to the mar­ket­ing man­ag­er for the com­pa­ny… after all, they do indi­cate the suc­cess (or fail­ure) of the com­pa­ny’s adver­tis­ing in draw­ing vis­i­tors to the site How good the qual­i­ty is only deter­mined by sys­temic tests of usabil­i­ty, not some vague val­ues about how long any user vis­its the site.

    Reply
  4. Robert Desprez says

    March 17, 2012 at 4:55 pm

    Hi SJH,

    Obvi­ous­ly, I dis­agree with you that these met­rics have no val­ue to tech­ni­cal writ­ers. Per­haps you feel that I’m argu­ing that web ana­lyt­ics is the main way to gath­er infor­ma­tion about how users inter­act with your help or con­tent on a sup­port web site. I’m not.

    What I am sug­gest­ing is that a tool like web ana­lyt­ics can pro­vide you with some met­rics that we nev­er have had before. Know­ing which doc­u­ments are pop­u­lar and which ones are not is *very* rel­e­vant to tech­ni­cal writ­ers. I’d also argue that under­stand­ing user key­words can poten­tial­ly be very use­ful. You can use these met­rics to start a con­ver­sa­tion with oth­er groups (for exam­ple, tech­ni­cal sup­port, prod­uct man­agers, and oth­er peo­ple who deal with users) and get a bet­ter sense of how users are inter­act­ing with your content.

    Web Ana­lyt­ics Demys­ti­fied by Eric Peter­son (a free e‑book) has a sec­tion about using web ana­lyt­ics for sup­port web sites, which is rel­e­vant for writ­ers. Author and tech­ni­cal writer Anne Gen­tle also believes this is rel­e­vant to writers. 

    Hope this helps.

    Reply

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,147 239

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413647243559161

Image for twitter card

I Regret My Tesla | The Walrus

I wanted to be good. Then the car company fell from grace

thewalrus.ca

Reply on Twitter 1923413647243559161 Retweet on Twitter 1923413647243559161 0 Like on Twitter 1923413647243559161 0 Twitter 1923413647243559161
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413050498957392

Image for twitter card

Brian Chesky Lost His Mind One Night—and Now He's Relaunching Airbnb as an Everything App

Airbnb's CEO is spending hundreds of millions to relaunch his travel company as an all-purpose service app. Fitness!...

www.wired.com

Reply on Twitter 1923413050498957392 Retweet on Twitter 1923413050498957392 0 Like on Twitter 1923413050498957392 0 Twitter 1923413050498957392
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923412665478627824

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister /via @globeandmail

Image for twitter card

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister

Experts say Solomon could face a host of challenges in his role, including how to increase AI adoption and comme...

www.theglobeandmail.com

Reply on Twitter 1923412665478627824 Retweet on Twitter 1923412665478627824 0 Like on Twitter 1923412665478627824 0 Twitter 1923412665478627824
robert_desprez avatar; Robert Desprez @robert_desprez ·
2 May 1918126029463536113

This productivity poison is exhausting you /via @globeandmail

Image for twitter card

This productivity poison is exhausting you

Constantly shifting your attention undermines what is your super power in most knowledge jobs. How you anticipate an...

www.theglobeandmail.com

Reply on Twitter 1918126029463536113 Retweet on Twitter 1918126029463536113 0 Like on Twitter 1918126029463536113 0 Twitter 1918126029463536113
Load More

Recent Blog Posts

  • ChatGPT: The AI-Powered Proofreader
  • Four Ways Confluence Could Be Better
  • First impressions of MadCap’s purchase of IXIASOFT
  • Online Conferences for Technical Writers in 2023

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.