LogoLogo
WebsiteBlog
  • Introduction
  • CDP Overview
  • Identity Resolution
  • CDP Guidelines for Data Sanity and Campaign Governance
  • Login and User Management
    • Login to the platform
    • Change Password / Retrieve your Account
    • Role Based Access Control
      • User Management
      • Roles
    • Single Sign-On (SSO)
  • Events
    • Events Overview
    • App Events
    • Track
    • Identify
    • Page
    • Screen
    • Event Dictionary
  • Sources
    • Sources Overview
    • Android SDK
    • iOS SDK
    • JavaScript SDK
    • React Native SDK
    • Flutter SDK
    • REST API
    • Adobe Analytics Exports
    • SFTP
    • Kafka
    • Offline File Ingestion
  • Destinations
    • Destinations Overview
    • Quora Pixel
    • Hotjar
    • Clevertap
    • Google Analytics 4 (GA4)
    • Meta Pixel
    • Meta Conversion API
    • LinkedIn Insight Tag
    • Adobe Target
    • AppsFlyer
    • AWS S3
    • Criteo
    • Kafka
  • Integrations
    • Rudderstack
    • Azure Blob
    • Adobe Launch Private Extension
    • Adobe Launch Extension
    • Salesforce CRM
    • Microsoft Dynamics 365
  • Customer One View
    • Introduction
    • Basic details, Attributes and Devices
    • Segment and Engagement
    • Activity
  • Segments
    • Getting Started
    • Create a Segment
  • Channels
    • Getting Started
    • A/B Testing
    • SMS
      • Set up an SSP
        • Netcore
        • Twilio
        • Adobe Campaign Classic
        • Gupshup
        • Unifonic
        • Infobip
        • Tubelight
      • Add an SSP
      • Create SMS campaign
      • FAQs
    • Email
      • Set up an ESP
        • SendGrid
        • SendInBlue
        • SparkPost
        • Taximail
        • Netcore
        • Adobe Campaign Classic
        • Mailchimp
        • Oracle Email Delivery
        • Infobip
        • Vision6
      • 🆕Add an ESP
      • Create Email campaign
      • Common use cases with Email Editor
      • Why Email Notification may not get delivered?
      • FAQs
    • App Push Notification
      • Create App Push Notification - Android
      • Create App Push Notification - iOS
      • Why App Push Notification may not get delivered?
      • FAQs
    • WhatsApp
      • Configure a WSP
        • Yellow Messenger
        • Infobip
        • Gupshup
        • BIK.ai
        • Vonage
        • Sinch
        • Tubelight
      • Create WhatsApp campaign
      • FAQs
    • RCS
      • Add an RCS API
      • Example: Netcore RCS API
      • Create an RCS campaign
      • FAQs
    • Web Push Notification
      • Create a Web Push Notification
      • Create a Default Web Push Notification
      • FAQs
    • On-site Notification
      • Create On-site Notifications.
      • Common use cases with On-site Notification.
      • Notification Templates
    • Banner Personalization
      • Create a Personalized Banner
      • Create a Default Banner
    • External API
      • Create Engagement
      • Test your API configuration
      • Example Use Cases of External APIs
        • Use case 1: HubSpot - Create Contacts API
        • Use case 2: Exotel's Make a call API
        • Use case 3: Mailmodo's Send Campaign Email API
  • Ramanujan AI
    • Lead scoring
    • Channel Orchestration
    • Content Generator
      • Generate Web Push Content
  • Journey Builder
    • Overview- Journey Builder
    • View all Journeys
    • Create a Journey
    • Journey Reports
    • FAQs
  • Audience Export
    • Facebook Export Channel
    • Google Ads Export Channel
  • Analytics
    • Dashboard
      • Guiding through the Dashboard
      • Unique Profile
      • Profile and Merge Trends
      • Campaign and Revenue Dashboard
    • Campaign Summary
    • Events Occurrence
    • Event Telemetry
    • App Installs and Uninstalls
    • Funnels
    • Paths
    • Traffic Analysis
    • Cohorts
    • Data sanity between Funnels, Paths and Events
    • FAQs
  • Developer APIs
    • User Profile API
    • WhatsApp Opt-in/Opt-out API
    • Subscription Management
  • Settings
    • Product Label
    • Frequency Caps
    • Contacts
Powered by GitBook
On this page
  • Getting started
  • Connection
  • Configuration
  • Methods
  • Setting up AWS S3 destination in Lemnisk
  • FAQs
  1. Destinations

AWS S3

Getting started with AWS S3 and setting it up

PreviousAppsFlyerNextCriteo

Last updated 1 year ago

A cloud-based object storage service, Amazon S3 (Simple Storage Service) allows businesses and individuals to store their data securely within buckets. They can store and protect any amount of data such as data lakes, websites, mobile applications, backup and restore, archive, enterprise applications, IoT devices, and big data analytics into the bucket.

A bucket is a container for objects.

Its easy to use features like interface and management helps you optimize and organize the data according to business-specific requirements.

Features of AWS S3

  • Store data with changing or unknown access patterns with the S3 Intelligent-Tiering feature.

  • Various storage managenment features used manage costs, meet regulatory requirements, reduce latency, and save multiple distinct copies of your data for compliance requirements.

  • Amazon S3 provides features for auditing and managing access to your buckets and objects.

You can refer to the to know more about the features.

Getting started

The AWS S3 destination is a secure method of connecting to your S3 buckets. Lemnisk uses it's own IAM Roles to access your S3 buckets.

Connection

Connection
Web
Mobile

​Device Mode

🚫

🚫

Cloud Mode

✅

✅

Configuration

In order to set up Amazon S3 as a destination in Lemnisk, you will have to login to your console and then (you can also choose an existing one, if any).

Irrespective of the region, the raw logs of data from AWS S3, received by Lemnisk are put into your S3 bucket.

The data is processed from your sources and events are collected in batches by Lemnisk. Once every hour, a process is initiated where the batches are uploaded to a Lemnisk S3 bucket, and then securely copied to your own S3 bucket. However, there are no limitations to the data size.

For Lemnisk to access your S3 bucket, you will have to add the below bucket policy for a smooth transition of data.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowLemniskUser",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::821664204980:user/s3-copy"
            },
            "Action": [
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::<s3-bucket-name>/lemnisk-logs/*"
        }
    ]
}

The data batching is done every one hour and there are no limitations on the data size.

Data format

Logs are stored as gzipped, newline-separated JSON containing the full call information in Lemnisk.

During the day, Lemnisk groups logs and then names them using the below format:

s3://{bucket}/lemnisk-logs/{source-id}/{received-day}/filename.gz

Methods

When a track event is triggered, it is sent to AWS S3 as a track event.

{
   "anonymousId":"viz_62200c405e6de",
   "traits":{
      "phone":"9433057867",
      "email":"paul.pinaki@gmail.com"
   },
   "messageId":"c855a52e-ff43-46fd-b99a-665fc3c96a3d",
   "sentAt":"2022-03-03T00:35:06.000Z",
   "receivedAt":"2022-03-03T00:35:07.000Z",
   "type":"track",
   "originalTimestamp":"2022-03-03T00:35:06.000Z",
   "userId":"CX1192900",
   "srcid":"6",
   "context":{
      "library":{
         "name":"smarttag",
         "version":"0.30v"
      },
      "ip":"42.110.172.44",
      "userAgent":"Mozilla/5.0 (Linux; Android 11; SM-M515F Build/RP1A.200720.012; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/98.0.4758.101 Mobile Safari/537.36 Instagram 224.0.0.20.116 Android (30/11; 450dpi; 1080x2174; samsung; SM-M515F; m51; qcom; en_GB; 353744237)",
      "page":{
         "path":"/user/verify-mobile",
         "referrer":"https://accounts.livspace.com/",
         "title":"Verify Mobile",
         "url":"https://accounts.livspace.com/user/verify-mobile"
      },
      "locale":"en-GB"
   },
   "event":"accounts_lead-form:otp_verified",
   "integrations":{
      
   },
   "properties":{
      "name":"Pinaki Damian Paul",
      "customerId":"1192900",
      "event_name":"accounts_lead-form:otp_verified",
      "userid":"CX1192900",
      "email":"paul.pinaki@gmail.com",
      "phoneNo":"9433057867",
      "leadId":"1343802"
   },
   "timestamp":"2022-03-03T00:35:07.000Z"
}

When a identify event is triggered, it is sent to AWS S3 as a identify event.

{
   "anonymousId":"viz_62200ceef3fd6",
   "traits":{
      "phone":"9363109757",
      "email":"ankitst08@gmail.com"
   },
   "messageId":"4ad2a008-ae62-4035-9ce4-eb37b8f2ca0d",
   "sentAt":"2022-03-03T00:35:27.000Z",
   "receivedAt":"2022-03-03T00:35:28.000Z",
   "type":"identify",
   "originalTimestamp":"2022-03-03T00:35:27.000Z",
   "userId":"CX1192901",
   "srcid":"6",
   "context":{
      "library":{
         "name":"smarttag",
         "version":"0.30v"
      },
      "ip":"223.181.236.137",
      "userAgent":"Mozilla/5.0 (Linux; Android 12; SM-G996B Build/SP1A.210812.016; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/98.0.4758.101 Mobile Safari/537.36 [FB_IAB/FB4A;FBAV/355.0.0.21.108;]",
      "page":{
         "path":"/user/verify-mobile",
         "referrer":"https://accounts.livspace.com/",
         "title":"Verify Mobile",
         "url":"https://accounts.livspace.com/user/verify-mobile"
      },
      "locale":"en-GB"
   },
   "integrations":{
      
   },
   "properties":{
      "otpVerified":"1",
      "userid":"CX1192901",
      "email":"ankitst08@gmail.com",
      "phoneNo":"9363109757"
   },
   "timestamp":"2022-03-03T00:35:28.000Z"
}

When a screen event is triggered, it is sent to AWS S3 as a screen event.

{
   "anonymousId":"58F1C23E-EFA8-45F9-B26A-467348027BB3",
   "traits":{
      "country":"IN",
      "userId":"CX1136403"
   },
   "srcid":"8",
   "context":{
      "app":{
         "build":"21.7",
         "name":"livspacehub",
         "namespace":"com.livspace.hub",
         "version":"21.7"
      },
      "library":{
         "name":"Lemnisk",
         "version":"3.7.1"
      },
      "traits":{
         "anonymousId":"viz_a_58F1C23E-EFA8-45F9-B26A-467348027BB3",
         "country":"IN",
         "userId":"CX1136403"
      },
      "timezone":"Asia/Kolkata",
      "ip":"106.213.130.15",
      "userAgent":"livspacehub/21.7 (com.livspace.hub; build:21.7; iOS 15.3.1) Alamofire/3.7.1",
      "device":{
         "advertisingId":"58F1C23E-EFA8-45F9-B26A-467348027BB3",
         "type":"ios"
      },
      "network":{
         
      }
   },
   "messageId":"73054828-B47F-4F56-8FC5-D587B8160B4E",
   "sentAt":"2022-03-03T00:38:02.207Z",
   "event":"hub-app_page:page_viewed",
   "receivedAt":"2022-03-03T00:38:02.000Z",
   "type":"screen",
   "userId":"CX1136403",
   "timestamp":"2022-03-03T00:38:02.000Z"
}

When a page event is triggered, it is sent to AWS S3 as a page event.

{
   "anonymousId":"viz_5d29f43f73130",
   "srcid":"6",
   "context":{
      "library":{
         "name":"smarttag",
         "version":"0.30v"
      },
      "ip":"49.37.203.191",
      "userAgent":"Mozilla/5.0 (Linux; Android 8.1.0; vivo 1803) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.101 Mobile Safari/537.36",
      "page":{
         "path":"/",
         "referrer":"https://stage2.livspace.com/",
         "search":"?load_uri=add-mobile&back=https%3A%2F%2Fstage2.livspace.com%2Fin%2Flead-quiz%3Fid%3D1343796%26cid%3D1192895",
         "title":"Sign In / Sign Up",
         "url":"https://accounts.livspace.com/?load_uri=add-mobile&back=https%3A%2F%2Fstage2.livspace.com%2Fin%2Flead-quiz%3Fid%3D1343796%26cid%3D1192895"
      },
      "locale":"en-US"
   },
   "messageId":"aff07e18-2bf1-491c-a9f6-f44739804d98",
   "sentAt":"2022-03-03T00:22:19.000Z",
   "receivedAt":"2022-03-03T00:22:20.000Z",
   "type":"page",
   "integrations":{
      
   },
   "originalTimestamp":"2022-03-03T00:22:19.000Z",
   "userId":"CX1192895",
   "properties":{
      "path":"https://accounts.livspace.com/?load_uri=add-mobile&back=https%3A%2F%2Fstage2.livspace.com%2Fin%2Flead-quiz%3Fid%3D1343796%26cid%3D1192895",
      "referrer":"https://stage2.livspace.com/",
      "search":"?load_uri=add-mobile&back=https%3A%2F%2Fstage2.livspace.com%2Fin%2Flead-quiz%3Fid%3D1343796%26cid%3D1192895",
      "title":"Sign In / Sign Up",
      "userid":"CX1192895",
      "email":"g.gautamgopinath@gmail.com",
      "phoneNo":"9003066721",
      "url":"https://accounts.livspace.com/?load_uri=add-mobile&back=https%3A%2F%2Fstage2.livspace.com%2Fin%2Flead-quiz%3Fid%3D1343796%26cid%3D1192895"
   },
   "timestamp":"2022-03-03T00:22:20.000Z"
}

Setting up AWS S3 destination in Lemnisk

You will have to perform the following steps in the Lemnisk app to add AWS S3 as a destination.

Navigate to CONNECT > Connections > Destinations and click +Create Destination.

Step 1: A Catalog pop-up appears. Select Amazon S3 and click Continue2

Step 2: Select a source of your choice by checking the box adjacent to the source and then click Continue.

Step 3: Type a unique name that acts as your destination identifier. Click Create Destination.

Step 4: The Overview tab appears with the details of the destination you just created.

Step 5: Toggle the Status button to activate/ deactivate the destination.

Step 6: Click +Add Sources and select a source(s) of your choice by checking the box adjacent to the source and then click Continue.

Step 7: Type a unique name that acts as your bucket identifier. Click Update Destination.

You can add a custom prefix path before typing the bucket name in the Bucket Name text box. For example, if AbcdS3 is your bucket name, and AWS is the prefix. The bucket name along with the prefix would be AWS AbcdS3.

FAQs

​Q1. What connection does the AWS S3 work on?

The AWS S3 is available in Cloud mode for both web and mobile.

Q2. How do I configure AWS S3?

Q3. How is the data processed in Lemnisk?

The data is processed from your sources and events are collected in batches by Lemnisk. Once every hour, a process is initiated where the batches are uploaded to a Lemnisk S3 bucket, and then securely copied to your own S3 bucket. However, there are no limitations to the data size.

Q4. How do I set up AWS S3 as a destination in Lemnisk?

You will have to perform the following steps in the Lemnisk app to add AWS S3 as a destination.

  • Navigate to CONNECT > Connections > Destinations and click +Create Destination.

  • A Catalog pop-up appears. Select Amazon S3 and click Continue.

  • Select a source and then click Continue.

  • Type a unique name and click Create Destination.

  • The Overview tab appears with the details of the destination you just created.

  • Toggle the Status button to activate/ deactivate the destination.

  • Click +Add Sources. Select a source(s) of your choice and then click Continue.

  • Type a unique name and click Update Destination.

Q5. How to add a prefix path to the destination name?

You can add a custom prefix path before typing the bucket name in the Bucket Name text box. For example, if AbcdS3 is your bucket name, and AWS is the prefix. The bucket name along with the prefix would be AWS AbcdS3.

You will have to log in to your console and then (you can also choose an existing one, if any).

AWS S3 doc
Amazon AWS S3
create a new S3 bucket
Amazon AWS S3
create a new S3 bucket