Custom Statistics

• 1. Press .

Configuring The Triad

BadgeGen must be configured to call (run) the GenUploadStats macro after your badges are generated. Follow the steps below to do so.

1) In GSAK, go to Tools > GSAK folder finder. Choose "Macros" and press Show.

Take note of the location of the folder that is opened (for example, it may be something like C:\Users\TGG\AppData\Roaming\GSAK\macros\). Close these windows.

2) Run BadgeGen (In GSAK, Macros > Run/Manage...)

3) On the main settings form, press the browse button beside the "Macro File:" option and locate the GenUploadStats.gsk file. It will be in the location that you took note of in step 1).

• • Choose "Run another macro after badges are generated" and "Suppress preview and "Complete" message".

  • Put a check-mark next to "Automatically add badges to FindStatGen notes" and select the notes section that you wish to post your badges to. (If you have never used FindStatGen notes, just choose 1/A. If you are using FindStatGen notes, choose a note field that you aren't using as BadgeGen will overwrite it.)

4) Press OK to generate your badges.

5) After your badges are generated, FindStatGen will run.

NOTE:

If it is your first time running GenUploadStats, it will ask you for your Username and Password for Geocaching.com first.

Enter this so that the macro can post your statistics and badges to your online profile.

6) Choose "Options", then choose "Section Order"

7) i) If you chose an "A" section in Step 3 to store your badges, make sure that the "Notes" section is enabled

ii) If you chose a "B" section in Step 3 to store your badges, make sure that the "Notes B" is enabled.

8) Press "OK"

9) Select "Auto-Run macro next time (with delay)". This will make FindStatGen automatically run (without necessity to click OK) next time you run BadgeGen.

10) Press "OK"

That's it! Next time you want to generate your statistics and badges, just run BadgeGen (like in step 2) and wait for GSAK to do the rest!

Completing The Big Picture

There are some statistics (like Caching Karma, Finders of My Caches, and others) that require full and complete logs of all the caches that you own. When you do a pocket query of the caches that you own, you only get the most recent logs. Luckily, there is another macro that can help out here.

AddLogs Macro

Download and install this macro as you did above.

• AddLogs.gsk

This macro should be used with caution as described below...

WARNING

WARNING: The AddLogs macro was written to address a specific shortcoming at gc.com - getting past logs for the caches that you own for the FindStatsGen report when there is no other way to obtain those logs. As written, the authors believe the AddLogs macro is fair use. They also believe that gc.com is aware of the macro and that they have not stopped it's use because they've built in safeguards to protect their interests, including limiting it's use to caches you own and requiring you to run it on one cache at a time to minimize the demand on the gc.com servers. Excessive use of the AddLogs macro could result in your geocaching.com account being closed.

Geocaching.com is closely monitoring their site, and if you make too many hits in a short period they will "throttle" your account (you will receive a message telling you to slow down and your access will be limited for a period of time). If you continue to hit the site rapidly, your account could be closed. You therefore should only use AddLogs when you cannot get the logs in any other way, and if you have multiple caches to update, you should do no more than a 3-4 caches, than wait an hour or so, then do a few more, to spread the load on the gc.com servers and minimize the risk that you will trigger throttling of your account.

Pocket Queries (click here) are the approved method for updating your database and AddLogs is not a substitute for Pocket Queries. Pocket Queries from Geocaching.com contain the last 5 logs added to the cache, plus your own. If you run a regular (e.g. weekly) Pocket Query for caches "I own", you will get most of the logs. GPX file downloads from the individual cache page contain the last 20 logs plus your own, so if one of your caches gets more than five but less than 20 logs between PQ's, you can get the others by downloading the GPX file from the individual cache page. Once you have the past logs on your caches (i.e. more than 20 logs ago), you should only need to run AddLogs very occasionally (e.g. once every month or two) to pick up any logs you may have missed.

Establish A Baseline

In GSAK, filter the caches to only display your placed hides. This can be done quickly by double clicking the green box under "Counts:" on the status bar at the bottom right of the screen.

For each cache in this list, run the AddLogs macro. Be mindful of the WARNING above. If you have a lot of caches, you should only do a handful at a time.

Once you have run this macro on all your caches, you will only need to run it periodically to update finds on your caches.

Periodic Updates

There are two methods useful for determining when to run AddLogs to update logs for a cache.

• 1. Keep track of the "Found" emails generated for your caches and only run AddLogs against those caches.

  2. From your geocaching.com profile, select the Geocaches (Yours) link.

     • This will display a list of your caches, sorted by find date, with most recently found caches first.

     • In GSAK, filter the caches to display only your placed hides and sort by the "Last Found" column.

     • Compare the dates from these two lists and run the AddLogs macro where there is a discrepancy.