{"_id":"@autoit-gui-skeleton/ags-component-google-analytics","_rev":"3-d9a0475157dd63d214b8824d16577711","name":"@autoit-gui-skeleton/ags-component-google-analytics","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@autoit-gui-skeleton/ags-component-google-analytics","version":"1.0.0","description":"Add the feature to track activity with Google Analytics Measurement Protocol inside an AutoIt application built with the AGS framework.","author":{"name":"20100","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"},"contributors":[{"name":"v20100v","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"}],"license":"MIT","keywords":["AGS","AutoIt","AutoIt-GUI-Skeleton","AGS-component","google-analytics","GAMP"],"homepage":"https://autoit-gui-skeleton.github.io/","repository":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics.git","type":"git"},"bugs":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics/issues"},"dependencies":{"@autoit-gui-skeleton/ags-component-http-request":"^1.0.0"},"AGS":{"framework":{"version":"1.0.0"},"AutoIt":{"version":"3.3.14.5"},"component":{"main":"ags-component-google-analytics.au3"}},"licenseText":"MIT License\n\nCopyright (c) 2018 \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","_id":"@autoit-gui-skeleton/ags-component-google-analytics@1.0.0","dist":{"shasum":"188b7bafa2ed2795b34f28e0dd2fd0d83d03c8ca","tarball":"https://registry.npmjs.org/@autoit-gui-skeleton/ags-component-google-analytics/-/ags-component-google-analytics-1.0.0.tgz","integrity":"sha512-kfN47o2agPaqhfUHwVtCWY8yQY9X2xQGeXNY45vmlMgumCcCd4qTHdlKjDmv2P5Wxk+nC+ek9iZps+2CZI7Ovw==","fileCount":13,"unpackedSize":18224,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJb9qmZCRA9TVsSAnZWagAAQoUP/A26fyJWK9//7fah9h8Z\n3l6CD+PKF5Hbv1rXDuK6owwYJxmGGCIxIp0rcPbMOEgSeH+8ShsQRLNUodi4\nT2l9RfXbEUlVoJBqGSNBxArm+kluH2WgZnTjokftq/DfK4trT+oqjYRQMacN\ny5qTVWjVFFQ5balY8qQCzg1s0DycZSdYj76QxFtEz8zUd8oqmJWprUQA1mL5\ndRmEcYBZ/suQBZYNWUroABiJSA7kwuXYLmLRlELkjBOX9Vn9kL4mb9om9EH8\nC/mFqRYB0uAcHAQPF46tcWIrL+g/dKMcrsE5Y8QNuO4XHBHPp+B++kyMUpUu\nZv365J8EQbDsHTVfyxA95j8X5P8h9B44NcEycTJxLRmaUSBiSGbEMRC7bmm3\nADrKF3dL1PeC0okox497lIRLFUUOk3A0OBErtGpocMKBr7yDqpKLum04AV6o\neBaFjFmuqFUqFm440kHN3fZX2/XxBxBihOcIsXpSR1HS/hc2J2FMlvuXQHdN\nPyiv+Am0IQPhC0cxH+ELwWBbpc6CjGRsY1LcwWKp4iFcf45M4fh00k7W00M1\nMx8pyBJ037GPtf+ufjEQsyO//eqxUT2xWXma5VvsvX/D8eeJIebJSKWOg+5Z\nA1GFz+VcdAR0b8Iv/uws77ZdxwHOx7B/e+9y3+QqbMD1ZewiEzom3uBl4Q2b\ntQxY\r\n=kBCs\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGTqE3pPyKVXIKOFtXbF1Cdo5tv0jW4JbNZwg5hpe7KWAiB0NNcalObA/uo0Vv0xyTPnMkr92xgk7aocRMtzwKzLrw=="}]},"maintainers":[{"name":"v20100v","email":"vb20100bv@gmail.com"}],"_npmUser":{"name":"v20100v","email":"vb20100bv@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ags-component-google-analytics_1.0.0_1542891928647_0.2296560250278401"},"_hasShrinkwrap":false},"1.0.1":{"name":"@autoit-gui-skeleton/ags-component-google-analytics","version":"1.0.1","description":"Add the feature to track activity with Google Analytics Measurement Protocol inside an AutoIt application built with the AGS framework.","author":{"name":"20100","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"},"contributors":[{"name":"v20100v","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"}],"license":"MIT","keywords":["AGS","AutoIt","AutoIt-GUI-Skeleton","AGS-component","google-analytics","GAMP"],"homepage":"https://autoit-gui-skeleton.github.io/","repository":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics.git","type":"git"},"bugs":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics/issues"},"dependencies":{"@autoit-gui-skeleton/ags-component-http-request":"^1.0.0"},"AGS":{"framework":{"version":"1.0.0"},"AutoIt":{"version":"3.3.14.5"},"component":{"main":"ags-component-google-analytics.au3"}},"licenseText":"MIT License\n\nCopyright (c) 2018 \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","_id":"@autoit-gui-skeleton/ags-component-google-analytics@1.0.1","dist":{"shasum":"06b375dcb97140d54537aebbec53282568fc9cad","tarball":"https://registry.npmjs.org/@autoit-gui-skeleton/ags-component-google-analytics/-/ags-component-google-analytics-1.0.1.tgz","integrity":"sha512-4PUqRJgo0hkHCVjoXnpUZ13l5KQRjxbagT+bGAVGZjtHbhwXosF+yzHiqAkWq8VeLg9YVLGZBFV5v1/Kjqwutw==","fileCount":7,"unpackedSize":10031,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJb9qt5CRA9TVsSAnZWagAAH7UP/RuZ1KQJDoIgmQ4siEYQ\n1Fn+bgH/aShpCkuWXNGijZ4sY+daWicH31a49YSIPHWZeTBHOtUvXZdZjJKo\nOLrFy+FjEHy0j04MGpGhs3KoW1jAo1CzheqrliyjttHM/ai0Ps+RE9FCt3Gd\nP1LdlAjedAHDJ/KAlzeVHmOoRNl5WBqtItT1297WXoYEB80/FqW/5jjg53dt\nlN3aIHT52xLg33Husf+iJ4iLKzMr94PDhmNonfrx6QlLSd/59NsioS84POG6\nVFigm84ffmI4Mz2tijJVEzlNgkL7gkjqSHPL28geNVj0HbOw++e1uiWsmoT9\nE5QorUyASypOGLsp//3orTMw4IropQ3yun5z5XxaqkhQJxWKSbbqbywgC/OS\nSLbIaOrDcTmaCBgM3KrYofxQ6Gx9ntQOmWqANtEFlgOyAKGmEX7e40R5GwmM\n0CAFR9nOlvZfQv9xds23bvcFDDplbVNNEGP3hi6mSIgjPRqpCebv4uqqF87s\n8rWHuKdUFQrXRyPkUxQIcYyGEZXI5c98jXiBLzv6eXclruMdrfzdmBKXxTkc\ndYvlHvedV5MHkewsAElwh+7g16LOneKynVLzBj1QlCIc3cwNMMiRISDEItyT\nN66WhjQ7sfDvAYTw/oB7AXiAOWsctqmaIJbnkyW+z+v1vs9oqqFQxtz5TfZK\ngYro\r\n=Hhx+\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGjsJbI4mZaOpSvriB9HJiWSlwfq3MD7mRjDzzSNE52cAiAdzXglZhEVs1IbXa/07CgT+BWJNIOFD0x34X3pkNM/2w=="}]},"maintainers":[{"name":"v20100v","email":"vb20100bv@gmail.com"}],"_npmUser":{"name":"v20100v","email":"vb20100bv@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ags-component-google-analytics_1.0.1_1542892409020_0.8178487252387274"},"_hasShrinkwrap":false},"1.0.2":{"name":"@autoit-gui-skeleton/ags-component-google-analytics","version":"1.0.2","description":"Add the feature to track activity with Google Analytics Measurement Protocol inside an AutoIt application built with the AGS framework.","author":{"name":"20100","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"},"contributors":[{"name":"v20100v","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"}],"license":"MIT","keywords":["AGS","AutoIt","AutoIt-GUI-Skeleton","AGS-component","google-analytics","GAMP"],"homepage":"https://autoit-gui-skeleton.github.io/","repository":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics.git","type":"git"},"bugs":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics/issues"},"dependencies":{"@autoit-gui-skeleton/ags-component-http-request":"^1.0.0"},"AGS":{"framework":{"version":"1.0.0"},"AutoIt":{"version":"3.3.14.5"},"component":{"main":"ags-component-google-analytics.au3"}},"licenseText":"MIT License\n\nCopyright (c) 2018 \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","_id":"@autoit-gui-skeleton/ags-component-google-analytics@1.0.2","dist":{"shasum":"aac266ec20098aadd40a77821f5e64b6ee3a96c0","tarball":"https://registry.npmjs.org/@autoit-gui-skeleton/ags-component-google-analytics/-/ags-component-google-analytics-1.0.2.tgz","integrity":"sha512-mGfFqz6M8B6oQM+Ta3vQ7geAhv1cLSpa6qOLEna/9CqhytZdNsFnHj0QnIoJ0Rko758g42bCy1dx4MI8QSK0Kg==","fileCount":8,"unpackedSize":22109,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJb9rOpCRA9TVsSAnZWagAAscIP/2p7nwioQ42lZBlx6V6t\nJuQNg5Vgf8EVIVN/71po9KpnDMImqZopK26QTW4D49HsAjbz2aOteOrDeuF5\nDmxBEAV39A35EOBgEG+tTFcNqWlqfq4kqPbgFROIAwXCWNJkwNx1aOZJ/+tF\nqSRiJhQABFRMUj7C3jrqx7T1BpOW7n4r0i4DJmAxOqpgEx//mZADsrStzclr\nDkL3zi3cf5jtY0kIgh3CEoRqAxcuT/KtlTCgCyvNL8ZUrb3B7zORRhTRiU23\nmIxirgaNv8atLoVFD5qJYc2ng4uUBAJWS1LlJU4+MLVawoueLK2GtmQmDaeF\n38ZF/4oBTINrX/W10a/MkZ7qF9ROu29coYOW6vTgp90nHlvQ9ESq2j1X3UIU\nrAuGPj4uWhs1Z4KfaTwnADFO0t3hE5Rw2DKr2YWkvLCOssLLcm+nMd1b7NMu\nZ0xx/FKBvq9VGkJ2fe/4qvRHAnGml6+WosfBEbVc8ysWRJ7KCHX7N7XF1YFu\nnBjrt2nV7JdZm2l9GvxW3lO0neewgLVdt2CG097JcyUevEkNLrTu7fkekkRt\n0PmrT/ixKXLHbtgwD60KAR1WrRCveVsa388arJxGTnd/63PDsJIwO+BzM0dE\nyLNHMVl7SUSRBVf0mmBk6aHRWqeGsPPluWTkJNnO790lzN4wvBVRgH5s27aX\nW5EG\r\n=gvmE\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIALa0YBOQHo9Inl+fYBv54RE2PATGL3Fdz0dweXSi9mDAiEAoBBkVoRc8b7uQFJ1jqLWHm05viSIjPmg3j94YUaVdsA="}]},"maintainers":[{"name":"v20100v","email":"vb20100bv@gmail.com"}],"_npmUser":{"name":"v20100v","email":"vb20100bv@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/ags-component-google-analytics_1.0.2_1542894504508_0.05983634335329091"},"_hasShrinkwrap":false}},"time":{"created":"2018-11-22T13:05:28.570Z","1.0.0":"2018-11-22T13:05:28.844Z","modified":"2022-04-04T16:37:26.247Z","1.0.1":"2018-11-22T13:13:29.165Z","1.0.2":"2018-11-22T13:48:24.708Z"},"maintainers":[{"name":"v20100v","email":"vb20100bv@gmail.com"}],"description":"Add the feature to track activity with Google Analytics Measurement Protocol inside an AutoIt application built with the AGS framework.","homepage":"https://autoit-gui-skeleton.github.io/","keywords":["AGS","AutoIt","AutoIt-GUI-Skeleton","AGS-component","google-analytics","GAMP"],"repository":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics.git","type":"git"},"contributors":[{"name":"v20100v","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"}],"author":{"name":"20100","email":"vb20100bv@gmail.com","url":"https://github.com/v20100v"},"bugs":{"url":"https://github.com/autoit-gui-skeleton/ags-component-google-analytics/issues"},"license":"MIT","readme":"AGS-component-google-analytics\n==============================\n\n> Add the feature to track activity with Google Analytics Measurement Protocol inside an AutoIt application built with the AGS framework.\n\n\n\n<br/>\n\n## How to install AGS-component-google-analytics ?\n\nIn order to simplify the management of the dependencies of an AutoIt project built with AGS framework, we have diverted form its initial use the dependency manager npm, and its evolution Yarn. This allows us to manage the dependencies of an AGS project with other AutoIt libraries, and to share these AutoIt packages from the npmjs.org repository. All AGS packages hosted in this npmjs repository belong to [@autoit-gui-skeleton organization](https://www.npmjs.com/org/autoit-gui-skeleton)\n\nWe assume that you have already install [Node.js](https://nodejs.org/) and [Yarn](https://yarnpkg.com/lang/en/), for example with [Chocolatey](https://chocolatey.org/), so to install AGS-component-http-request, just type in the root folder of your project where the `package.json` is saved :\n\n```\nλ  yarn add @autoit-gui-skeleton/ags-component-google-analytics --modules-folder vendor\n```\n\nThis package is installed into the `./vendor` directory. To use it in your AutoIt program, you need to include this library with this instruction:\n\n```autoit\n#include 'vendor/@autoit-gui-skeleton/ags-component-google-analytics/ags-component-google-analytics.au3'\n```\n\n\n\n<br/>\n\n## AGS's vendor directory\n\nTo install AutoIt dependencies in the `./vendor` directory, and not in the default directory of Node.js `./node_modules`, you must add the `--modules-folder vendor` option. We force this choice to avoid any confusion with a Node.js project.\n\nNote that with an AGS project, it is not necessary to explicitly write this option on the command line, thanks to the `.yarnrc` file stored at the root of the project. Yarn automatically use this file to add an additional configuration of options.\n\n```\n #./.yarnrc\n --modules-folder vendor\n ```\n\nSo with this file you can run `yarn add @autoit-gui-skeleton/ags-component-google-analytics` to install the dependencies directly into the appropriate `./vendor` directory.\n\n\n\n<br/>\n\n## AGS-component-google-analytics\n\n### Description\n\nWith AGS-component-google-analytics, you can track user activity inside an AutoIt application with the Measurement Protocol.\n\n\n\n\n### Available methods\n\nThis library provides few methods:\n\n Methods | Description\n---------|-------------\n`hitGAMP($payload)` | Send a request HTTP POST with payload data to server GAMP\n`hitGAMP_pageview($pageHostname, $pageName, $pageTitle)` | Hit GAMP for a pageview\n`hitGAMP_screenview($screenName)` | Hit GAMP for a screenview\n`hitGAMP_event($eventCategory, $eventAction, $eventLabel=\"\", $eventValue=\"\")` | Hit GAMP for an event\n`hitGAMP_screenview_AND_pageview($screenName, $pageHostname, $pageName, $pageTitle)` | Hit GAMP for a screenview and a pageview\n\n\n\n### Configuration of component AGS-component-google analytics\n\n#### Define behavior in configuration file `./config/parameters.ini`\n\nWith AGS, you must have the configuration file `./config/parameters.ini`. This file must not save with control version. You can use `./config/parameters.ini.dist` as a “template” of what your parameters.ini file should look like. Set parameters here that may be different on each application. Only this file is save with control version and push on remote server.\n\nTo configure the behavior of this component, you can set its options in this configuration file. The configuration use the section `AGS_GOOGLE_ANALYTICS`.\n\n```ini\n## ./config/parameters.ini ##\n[AGS_GOOGLE_ANALYTICS]\n; [OPTIONAL] active debug output in console for all HTPP resquest send with GAMP\nGAMP_DEBUG_OUPUT_CONSOLE=1\n\n; [OPTIONAL] active tracking with Google Analytics Measurement Protocol\nGAMP_ANALYTICS_CONSENT=1\n```\n\nIf this variable are not defined in configuration file, so, by default `$GAMP_DEBUG_OUPUT_CONSOLE`, and `$GAMP_TRACKING_ENABLE` are set to `False`.\n\nIn this component we use an another component [AGS-component-http-request](https://yarnpkg.com/fr/package/@autoit-gui-skeleton/ags-component-http-request). This library is used to send HTTP request in GET or POST method, and with or wihtout behind a corporate proxy, in order to send data to GA server (hit with GAMP). So you can also configure this component. For example, you can set a proxy for all HTTP connections, or set different types of timeouts. By default, this component looks in the configuration file if a proxy is defined in the PROXY variable in the AGS_HTTP_REQUEST section.\n\n```ini\n## ./config/parameters.ini ##\n\n[AGS_HTTP_REQUEST]\n; [OPTIONAL] Use a proxy for http connexion or choose NONE to disable it\n# PROXY=NONE\nPROXY=http://myProxy.com:20100\n```\n\n\n#### Set constants in ./src/GLOBALS.au3\n\nIn AGS framework all constants and global variables are set in one place `./src/GLOBALS.au3`, with the exception to global variables of graphic elements which are set in each specific view file. AGS-component-google-analytics use also 5 global variables. If only one of these variables is not defined then the program returns an error and stops immediately\n\n```autoit\n; The google tracking id to used\nGlobal const $GAMP_TRACKING_ID = \"UA-xxxxxxxxx-y\"\n\n; A string used as a salt in encryption algorithm\nGlobal const $GAMP_CRYPT_SALT = \"2080-M3-M?GADR1Vx\"\n\n; Application main constants\nGlobal Const $APP_NAME = \"test\"\nGlobal Const $APP_ID = \"acme.test\"\nGlobal Const $APP_VERSION = \"1.2.3\"\n```\n\n\n## Developpement\n\n### Publish a new version on Yarn\n\nIf it's the first time you publish a scoped package. The default access setting is private, but for this you need a paid account. Hence the error message. So in order to avoid HTTP 402 error, you can set the scoped package as public like this. Dont't forget to log in.\n\n```\nyarn login\nyarn publish --access=public\n```\n\n\n<br/>\n\n## About\n\n### Contributing\n\nComments, pull-request & stars are always welcome !\n\n### License\n\nCopyright (c) 2018 by [v20100v](https://github.com/v20100v). Released under the MIT license.\n","readmeFilename":"README.md"}