{"_id":"@africasokoni/react-ga4","_rev":"2-5580288b2f62bd97bfbb1d5750a01031","name":"@africasokoni/react-ga4","dist-tags":{"latest":"1.4.2"},"versions":{"1.4.1":{"name":"@africasokoni/react-ga4","version":"1.4.1","description":"React Google Analytics 4","main":"dist/index.js","types":"types/index.d.ts","scripts":{"build":"NODE_ENV=production babel src -d dist","postbuild":"tsc src/index.js --declaration --allowJs --emitDeclarationOnly --outDir types","prepublish":"npm run build && npm test","test":"NODE_ENV=test jest"},"author":{"name":"Han Lin Yap","url":"https://yap.nu"},"license":"MIT","keywords":["GA","GTM","Google Analytics","Google Analytics 4","Google Tag Manager"],"repository":{"type":"git","url":"git+https://github.com/sokoni-online/react-ga4.git"},"devDependencies":{"@babel/cli":"^7.16.0","@babel/core":"^7.16.0","@babel/preset-env":"^7.16.0","babel-jest":"^27.3.1","jest":"^27.3.1","typescript":"^4.4.4"},"jest":{"testPathIgnorePatterns":["dist"]},"gitHead":"4e5a744546d720ba0be8b32faa4ebe44e4783db2","bugs":{"url":"https://github.com/sokoni-online/react-ga4/issues"},"homepage":"https://github.com/sokoni-online/react-ga4#readme","_id":"@africasokoni/react-ga4@1.4.1","_nodeVersion":"14.17.3","_npmVersion":"8.5.2","dist":{"integrity":"sha512-JoQFPGKEPVoJG+NKjHXbFhd2ykcQ6m+rvENAJ2H5FpHUWbicv3uhWowWkNLYbU5aqKzp7oUpvmEOmbFdFXJFng==","shasum":"f061a867b955b6249d4ad6d680e804ef4a6a12af","tarball":"https://registry.npmjs.org/@africasokoni/react-ga4/-/react-ga4-1.4.1.tgz","fileCount":19,"unpackedSize":106854,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiQuOHACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmqfdg/+KWOoZPx6U7E+Lq7nA98nG/yhisdMKb9Vre5UnFJ2W+Zwe0eO\r\nbv2b6QjxW/QS5gnr+yTQU5XF7a439eVzqPsoXMtciX4d63Kvl2iq7ybpqtgk\r\nWkCHWc+JmDpiuBw17blEyWVV40Gl4sPJnERwNbKUnE5tpMem/vLyBjPI368z\r\n1Zid/tDuN84KWtFp2OyIhI9cEKZb3Y1AdQcs+zd3JjJi4n2otvgSSOjwjHY+\r\niatgo5W8ZItMkd0PIUweSIDXG7kfqMc03otSzVPq8og29AttvOSZvuwT6AJ0\r\n0nJejjlhOdIS6Q6Tm852oQK25esTAsQd//NFNLzdTi8ClTnBCo0J0nFVgz7P\r\nysS3uw0VI9KcjXUXrxcSaJIxl2aruba2PWVbn8X9jCVWnfS4L7SUjyWXR5DM\r\n4fSc5YqEttAYVhAQgN6FGpr2l5CRiTXTPilwMMLClOjgDkYydlhzyzX811Fw\r\nLptsVsXU5gqTOvcWkbumMh5z+xG9bvTOcgWlR7PgnlEfvWxwJj77egkdk48J\r\nnoLQq9DKu+e0ggeBvUt44bJK7fB0cBdj9SoHuNk2e4fuMBjodN17PNgmn+vz\r\nbj9i9RimjCvFF3qn/+JoCLI4pzTpV0oxoe8TscJmr7u17MygnZZ3v5vSd3ii\r\nAORqqV5Yi646/5xXej+BE1SrQiNd9/b8sh4=\r\n=LuHv\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDZ8aM0m+Nea2tnGi1XxSDapntC6Udkju0lY/E3xSY5HAIgQGJIvk23a2O13GSyXE4Jzc63sg3Rdk3CK12xWKHf8t0="}]},"_npmUser":{"name":"felixnyamweya","email":"felixombura@gmail.com"},"directories":{},"maintainers":[{"name":"felixnyamweya","email":"felixombura@gmail.com"},{"name":"gr1d99","email":"gideon.kimutai.kim@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/react-ga4_1.4.1_1648550791349_0.22133452504902085"},"_hasShrinkwrap":false},"1.4.2":{"name":"@africasokoni/react-ga4","version":"1.4.2","description":"React Google Analytics 4","main":"dist/index.js","types":"types/index.d.ts","scripts":{"build":"NODE_ENV=production babel src -d dist","postbuild":"tsc src/index.js --declaration --allowJs --emitDeclarationOnly --outDir types","prepublish":"npm run build && npm test","test":"NODE_ENV=test jest"},"author":{"name":"Han Lin Yap","url":"https://yap.nu"},"license":"MIT","keywords":["GA","GTM","Google Analytics","Google Analytics 4","Google Tag Manager"],"repository":{"type":"git","url":"git+https://github.com/sokoni-online/react-ga4.git"},"devDependencies":{"@babel/cli":"^7.16.0","@babel/core":"^7.16.0","@babel/preset-env":"^7.16.0","babel-jest":"^27.3.1","jest":"^27.3.1","typescript":"^4.4.4"},"jest":{"testPathIgnorePatterns":["dist"]},"gitHead":"440d4785e1d858552df43ab5d99d5336cb006f3a","bugs":{"url":"https://github.com/sokoni-online/react-ga4/issues"},"homepage":"https://github.com/sokoni-online/react-ga4#readme","_id":"@africasokoni/react-ga4@1.4.2","_nodeVersion":"14.17.3","_npmVersion":"8.5.2","dist":{"integrity":"sha512-5nrrDtmtsDFCSEyRX+MZmxr5XpElNEiQeKEjQ/O9ikODHCb18Lo2Lzfnkqogw3ZE9ZcwgyUcjQH+3H75I5u8Pg==","shasum":"4c13febfb8758c0381d74b8109afe06d2651a36b","tarball":"https://registry.npmjs.org/@africasokoni/react-ga4/-/react-ga4-1.4.2.tgz","fileCount":19,"unpackedSize":106895,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiRB3VACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp9rRAAgB9OR8U27FJBYZ47fHwWDPVRKYOamd7JFOvZu3l90NG25kjj\r\nwgqHVNZHPQ5wCMIVqtnz5MGm9vECKMrSJnMi59umoKUr46rhxGdieeyakEgN\r\nZBdoym6mWhPTJF1rGXJTeKY6OvUcewjTCLBHAsb1zGfTdtmJNFW5V5QCmlt4\r\nxIrx0E1fhYlU9NfaBK4JqrJ7e7IUhfgXQx9WkLu4BSUDRBz98XxF5I+1Wm4D\r\nCWtDRgmt8eNbl6dSWV8l+Uv0U1ztXeEl6zUzRwuoKf4Sr+z5RuRgVUExJBEG\r\ne3pLO0GQ2hjzGD/IC7e+owq8nlbAZ/ANCc9Tq1/Hmn2ZgBnLT11sRZ5pRodX\r\nBZUrF7zWx8apfj3A8IjxxgpzXYMQvhOr+3dL7TjQ+Oxf2BeT9r/6vMZKfmN8\r\nY12PpHagFuy4jIPsH5nwXNOePDlE6XFp7ewVKACTQuJtRsZJx7KRMQnY7h94\r\nMOCJMA6sSqGznwlJpxOljzZ4NqGGIjy8UtpHOTACUivXyLgeYPpJ9AYCY4IR\r\n5ODMv6pqKkubWeLJ/eIHd3f+NbQNMcVyaSP0caL9rasYO8E9SaPhvAKYErYN\r\nf0hG9qxrOXaosq1vvmCcWoCpn2Kf36wS4qrdrtbG7cQCOB1vAZk75jzF/6g1\r\nxpQpDlBWJ9ZK+ziAeRvI44Ok1Kjaa3/UyBs=\r\n=RqUF\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDV+/IupNtZoZBpneNIqh0E/1sxwAxoWwhGX5Gd/IJFsQIhAPz8hcJUNmPNg3GtGsMtnc3RT5OuZd1vDylT74th1xva"}]},"_npmUser":{"name":"felixnyamweya","email":"felixombura@gmail.com"},"directories":{},"maintainers":[{"name":"felixnyamweya","email":"felixombura@gmail.com"},{"name":"gr1d99","email":"gideon.kimutai.kim@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/react-ga4_1.4.2_1648631253600_0.7137145840853178"},"_hasShrinkwrap":false}},"time":{"created":"2022-03-29T10:46:31.246Z","1.4.1":"2022-03-29T10:46:31.495Z","modified":"2022-04-04T11:51:24.075Z","1.4.2":"2022-03-30T09:07:33.765Z"},"maintainers":[{"name":"felixnyamweya","email":"felixombura@gmail.com"},{"name":"gr1d99","email":"gideon.kimutai.kim@gmail.com"}],"description":"React Google Analytics 4","homepage":"https://github.com/sokoni-online/react-ga4#readme","keywords":["GA","GTM","Google Analytics","Google Analytics 4","Google Tag Manager"],"repository":{"type":"git","url":"git+https://github.com/sokoni-online/react-ga4.git"},"author":{"name":"Han Lin Yap","url":"https://yap.nu"},"bugs":{"url":"https://github.com/sokoni-online/react-ga4/issues"},"license":"MIT","readme":"# React Google Analytics 4\n\n## Migrate from old react-ga\n\n```js\n// Simply replace `react-ga` with `react-ga4`\n// import ReactGA from \"react-ga\";\nimport ReactGA from \"@africasokoni/react-ga4\";\n```\n\n## Install\n\n```bash\nnpm i @africasokoni/react-ga4\n```\n\n## Usage\n\n```js\nimport ReactGA from \"@fricasokoni/react-ga4\";\n\nReactGA.initialize(\"your GA measurement id\");\nReactGA.send(\"pageview\");\n```\n\n## Example\n\nMore example can be found in [test suite](src/ga4.test.js)\n\n```js\n// Multiple products (previously known as trackers)\nReactGA.initialize([\n  {\n    trackingId: \"your GA measurement id\",\n    gaOptions: {...}, // optional\n    gtagOptions: {...}, // optional\n  },\n  {\n    trackingId: \"your second GA measurement id\",\n  },\n]);\n\n// Send pageview with a custom path\nReactGA.send({ hitType: \"pageview\", page: \"/my-path\" });\n\n// Send a custom event\nReactGA.event({\n  category: \"your category\",\n  action: \"your action\",\n  label: \"your label\", // optional\n  value: 99, // optional, must be a number\n  nonInteraction: true, // optional, true/false\n  transport: \"xhr\", // optional, beacon/xhr/image\n});\n```\n\n## Reference\n\n#### ReactGA.initialize(GA_MEASUREMENT_ID, options)\n\n| Parameter                     | Notes                                                                                                                   |\n| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| GA_MEASUREMENT_ID             | `string` Required                                                                                                       |\n| options.nonce                 | `string` Optional Used for Content Security Policy (CSP) [more](https://developers.google.com/tag-manager/web/csp)      |\n| options.testMode              | `boolean` Default false                                                                                                 |\n| options.gaOptions             | `object` Optional [Reference](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference) |\n| options.gtagOptions           | `object` Optional                                                                                                       |\n| options.legacyDimensionMetric | `boolean` Default true                                                                                                  |\n\n#### ReactGA.set(fieldsObject)\n\n| Parameter    | Notes             |\n| ------------ | ----------------- |\n| fieldsObject | `object` Required |\n\n#### ReactGA.event(name, params)\n\nThis method signature are NOT for `UA-XXX`\n\n| Parameter | Notes                                                                                                                         |\n| --------- | ----------------------------------------------------------------------------------------------------------------------------- |\n| name      | `string` Required A [recommended event](https://developers.google.com/tag-platform/gtagjs/reference/events) or a custom event |\n| params    | `object` Optional                                                                                                             |\n\n#### ReactGA.event(options)\n\n| Parameter                    | Notes                               |\n| ---------------------------- | ----------------------------------- |\n| options                      | `object` Required                   |\n| options.action               | `string` Required                   |\n| options.category             | `string` Required                   |\n| options.label                | `string` Optional                   |\n| options.value                | `number` Optional                   |\n| options.nonInteraction       | `boolean` Optional                  |\n| options.transport            | `'beacon'\\|'xhr'\\|'image'` Optional |\n| options.dimension`{1...200}` | `any` Optional                      |\n| options.metric`{1...200}`    | `any` Optional                      |\n\n#### ReactGA.send(fieldsObject)\n\n| Parameter    | Notes             |\n| ------------ | ----------------- |\n| fieldsObject | `object` Required |\n\n#### ReactGA.gtag(...args)\n\n#### ReactGA.ga(...args)\n\n#### ~~ReactGA.pageview(path, \\_, title)~~\n\nDeprecated Use `.send(\"pageview\")` instead\n\n#### ~~ReactGA.outboundLink({ label }, hitCallback)~~\n\nDeprecated Use `enhanced measurement` feature in Google Analytics.\n\n### Extending\n\n```js\nimport { ReactGAImplementation } from \"react-ga4\";\n\nclass MyCustomOverriddenClass extends ReactGAImplementation {}\n\nexport default new MyCustomOverriddenClass();\n```\n\n## Debugging\n\nUse [Google Analytics Debugger Chrome Extension](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) to see logs\n\n## License\n\nMIT\n","readmeFilename":"README.md"}