https://github.com/goatandsheep/aws-web-analytics

Privacy-focused alternative to Google Analytics on AWS Pinpoint
https://github.com/goatandsheep/aws-web-analytics

amplify-js analytics aws google-analytics help-wanted

Last synced: about 2 months ago
JSON representation

Privacy-focused alternative to Google Analytics on AWS Pinpoint

• Host: GitHub
• URL: https://github.com/goatandsheep/aws-web-analytics
• Owner: goatandsheep
• License: gpl-3.0
• Created: 2020-01-16T04:59:37.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-07-23T23:39:15.000Z (about 2 months ago)
• Last Synced: 2024-07-24T02:25:44.069Z (about 2 months ago)
• Topics: amplify-js, analytics, aws, google-analytics, help-wanted
• Language: JavaScript
• Homepage: https://console.aws.amazon.com/pinpoint/home
• Size: 903 KB
• Stars: 47
• Watchers: 4
• Forks: 1
• Open Issues: 51
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AWS Web Analytics

Tracking tag library for AWS Pinpoint as an alternative to Google Analytics using AWS Amplify. 

## Philosophy

Moving to AWS from Google Analytics is a way to maintain your users' privacy. Our blog post, [Why you need to move off Google Analytics](https://dev.to/goatandsheep/stop-donating-your-customers-data-to-google-analytics-191), explains more about it.

Amplify requires a lot of boilerplate to be able to setup a useful Analytics setup quickly and effectively.

## Initialize your account

1. Create an AWS account

2. Create your Pinpoint account and Cognito Federated user pool

3. Add the following tag to your code (with your own values for `data-id-pool` and `data-pinpoint-id`):

```html

```

## Click Events

> Based on [Amplify Page Event Tracking](https://docs.amplify.aws/lib/analytics/autotrack/q/platform/js#page-event-tracking)

Use `data-aws-analytics-` to indicate:

* `on`: event listening

* `name`: what will analytics event be named?

* `attrs`: any needed associated info

```html

Continue

```

If you need other events than `click`, open a ticket 

## Custom events

> Based on [Amplify Analytics record](https://docs.amplify.aws/lib/analytics/record/q/platform/js).

```javascript

window.Amplify.Analytics.record({

    name: 'albumVisit', 

    // Attribute values must be strings

    attributes: { genre: '', artist: '' }

});

```

## AWS Cloud setup

### IAM Role

Setup the Federated Cognito pool allowing unauth roles with the following permissions:

```json

{

    "Version": "2012-10-17",

    "Statement": [

        {

            "Sid": "VisualEditor0",

            "Effect": "Allow",

            "Action": [

                "mobiletargeting:PutEvents",

                "mobiletargeting:UpdateEndpoint"

            ],

            "Resource": "arn:aws:mobiletargeting:us-east-1::apps//*"

        },

        {

            "Sid": "VisualEditor1",

            "Effect": "Allow",

            "Action": [

                "mobiletargeting:GetUserEndpoints",

                "mobileanalytics:PutEvents"

            ],

            "Resource": "*"

        }

    ]

}

```

CloudFormation coming soon...