AWS S3 clickstream integration – Rebrandly

Our AWS S3 integration is a Stream-to-Storage solution that collects all of the click traffic produced by your branded links and adds it to your own Amazon Web Services S3 bucket. Batches of click events will be written into files and delivered to the bucket in near real-time.

Create a new S3 Bucket in your own AWS account and grant Rebrandly access to it by configuring the following Bucket Policy in the Permission tab of your AWS console.

For the specific bucket, replace "your-bucket-name-here" with your own bucket's name. Permission can be revoked at any time.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RebrandlyWorkersIntegration",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::617090640476:root"
            },
            "Action": [
                "s3:PutObject",
                "s3:GetObject"
            ],
            "Resource": "arn:aws:s3:::your-bucket-name-here/*"
        }
    ]
}

Choose the storage class that best fits your own use-case. We recommend setting "Standard" storage class as - typically - files delivered by the stream to your S3 bucket are smaller than 128KB.

See the click event example below:

{
  "timestamp": "2019-07-02T14:07:06.981094Z",
  "client": {
    "language": "pt",
    "location": {
      "country": "br"
    },
    "agent": {
      "browser": {
        "name": "facebook-app",
        "version": "227.0.0.43.158"
      },
      "os": {
        "name": "android",
        "version": "android-9.0-pie"
      },
      "device": {
        "name": "smartphone"
      },
      "type": "human"
    },
    "session": {
      "started": "2019-07-02T14:07:06.981094Z",
      "first": true
    }
  },
  "referral": {
    "hostname": "m.facebook.com",
    "protocol": "http",
    "path": "/",
    "origin": {
      "type": "social",
      "name": "facebook"
    }
  },
  "route": {
    "id": "a1ec86bf91bfe763ad02f602259ea0a9",
    "slashtag": "<YOUR LINK'S SLASHTAG HERE>",
    "creator": {
      "id": "wf09bfww4eb9jkw2844555e1ce9af4f2",
      "workspace": {
        "id": "d88bfe5fgd14b2ghb44538b9aekpw89",
        "name": "<YOUR WORKSPACE NAME HERE>"
      }
    },
    "domain": {
      "id": "9a5ae320f3e247ef8c9b6061131bb517",
      "raw": "<YOUR DOMAIN NAME HERE>"
    },
    "destination": {
      "raw": "https://www.yourdestination.com/?utm_source=cs_facebook_post&utm_medium=customersuccess",
      "protocol": "https",
      "hostname": "www.yourdestination.com",
      "path": "/",
      "params": {
        "query": {
          "utm_source": [
            "cs_facebook_post"
          ],
          "utm_medium": [
            "customersuccess"
          ]
        }
      }
    }
  }
}

Related articles