Adding new search engines to WT’s definitions

The new search engine Cuil was announced today. If you want to add it to your WebTrends setup, it’s very easy provided you can edit the WebTrends installation files. The file you have to change is called keywords.ini. Following is a how-to.

Applies to: software

(Note – in November 2008 WebTrends started making updated copies of browsers.ini and keywords.ini available to software users from their web site!  We’ll post more about this soon once we have checked it out.) 

http://www.webtrends.com/support/browser-and-keywords-updater.aspx

Back to the original July post:

The new search engine Cuil was announced today. If you want to add it to your WebTrends setup, it’s very easy provided you can edit the WebTrends installation files.

The file you have to change is called keywords.ini.

There are usually two or three copies of keywords.ini on the typical WebTrends installation. Typical locations are:

/WebTrends/modules/analysis/engine/8.0d (8.1, 8.5, etc)
/WebTrends/storage/config/component/lookupdata/
/WebTrends/storage/config/engine/8.0d (8.1, 8.5, etc)

Open the first instance of keywords.ini with a proper text editor. By “proper” we mean something like TextPad rather than Notepad, because Notepad doesn’t play well with the system when the file is in use. With TextPad, you can [usually] take the risk of changing the file while WebTrends is running.

Step 1 – Change the Engine list. Go to the end of the long Engine list. Find the last numbered entry. It’ll look something like this:

Engine337=Looksmart (if your last numbered entry is 337)

Add a line using the next number, like this:

Engine338=Cuil

Step 2 – Add the specifications.  Go to the end of the specification list (groups of three or four lines).  The last one might look like this (if your last one is Looksmart)

[LookSmart]
ID1=looksmart.com
KeywordIndicator1=key=

Add a blank line and then this:

[Cuil]
ID1=cuil.com
KeywordIndicator1=q=

Step 3.  Save and close the file.

Step 4.  Make the same changes to other copies of keywords.ini in your installation.

 That’s all it takes.  If you’re wondering where we got the specification for the KeywordIndicator line, we just went to cuil.com, did a search, and looked at the name of the query parameter containing the search keyword.  It’s “q” just like Google.

No, The WebTrends Outsider is NOT in Cuil’s index.  Obviously Cuil is not very hip.

NOTE for the future:  Keep a copy of the new and old keywords.ini somewhere safe.  Any WebTrends upgrades will overwrite your modified keywords.ini with the one that comes with the install, so you will have to do some additional manual stuff after those upgrades or complete reinstalls.

One last thing. Here is a Cool Custom Report that will show you any gaps in your keywords.ini file.

  • Dimension: Referring Site
  • Filter:  Exclude Search Engines

The referring sites in the resulting report are those that are not being counted as search engines.  Enjoy.