tw-analytics

0.1.0 • Public • Published

tw-analytics

Coverage Status

Add Google analytics tracking to your Twine game (or other web app).

Installation (CLI)

Install via NPM: npm install --global tw-analytics.

Use the command twga to run it.

Usage (CLI)

twga --id=UA-XXXX-Y -i index.html -o output.html

To use the CLI, you must provide your Google Analytics tracking ID using the --id option, and a source file via the --input (alias: -i) option. You may provide an output file path/name using the --output (alias: -o) option. If you don't provide an output file, the program will overwrite the input file with the new version with the tracking scripts added.

To see some command and option help, use --help. To check the version, --version.

Install (module)

To use this module in your scripts as a part of a build process rather than as a CLI.

Install via: npm install --save-dev tw-anaytics.

You can then use require('tw-analytics') in your scripts to expose the function.

Usage (module)

var twga = require('tw-analytics');
 
twga(options);
 
// -- or --
 
twga(id, input, output);

Arguments:

  • options (object): a generic object containing the id, input, and output properties, as described below.
  • id (string): your Google analytics tracking ID.
  • input optional (string): the path to your compiled html file. Defaults to 'index.html' if none is provided.
  • output optional (string): the path to save the altered file to. Overwrites the input file if no option is provided.

Examples:

Object version:

twga({
    id : 'UA-XXXXX-Y',
    input : './src/index.html',
    output : './dist/index.html'
});

Object version, overwrite input file:

twga({
    id : 'UA-XXXXX-Y',
    input : './src/index.html'
});

Object version, minimum arguments:

twga({ id : 'UA-XXXXX-Y' }); // targets and replaces a file named `index.html` in the current folder

Separate arguments version:

twga('UA-XXXXX-Y', './src/index.html', './dist/index.html');

Separate arguments version, overwrite the input file:

twga('UA-XXXXX-Y', './src/index.html');

Separate arguments version, minimum arguments:

twga('UA-XXXXX-Y'); // targets and replaces a file named `index.html` in the current folder

Readme

Keywords

Package Sidebar

Install

npm i tw-analytics

Weekly Downloads

1

Version

0.1.0

License

Unlicense

Unpacked Size

9.75 kB

Total Files

7

Last publish

Collaborators

  • chapelr