LogoLogo
HomepageCase studiesBook a demo
Technical Guide
Technical Guide
  • Introduction
  • Getting Started Guide
    • Authentication
    • Member Registration Configuration
    • Add Webhook
    • Add Member
    • Create Campaign
    • Add Transaction
    • Add Custom Event Schema
    • Create Achievement
    • Add Custom Event
  • Terms Reference
  • Backward Compatibility Policy
  • API Reference
  • Postman Collection
  • User Guide
  • Integration
    • Introduction
    • Overview of Integration Methods
    • Tools and Technologies
    • Integration Examples
      • Lambda
      • Zapier
      • AWS EventBridge
      • Kafka
  • API Fundamentals
    • Overview
    • Environments Capabilities
    • How to Query
    • Limits
    • Best Practices
  • Authentication
    • Admin Token
    • Access Token (API Key)
    • Enabling SSO Login
      • Okta
      • Microsoft Entra ID
  • Webhooks
    • Overview
    • Best Practices
  • S3 Bucket Data exports
    • Overview
    • Set Up S3 Bucket Integration
    • Data Structure and Types
      • Achievements
      • Achievement Usage
      • Campaigns
      • Campaign Calculated Effect Result
      • Campaign Execution
      • Custom Events
      • Members
      • Rewards
      • Rewards Redemption
      • Tiers
      • Transactions
      • Tenants
      • Unit Transfers
Powered by GitBook
On this page
  • Access to the S3 Bucket
  • Replicating Data Between S3 Buckets
  • Key Considerations
  • Summary

Was this helpful?

  1. S3 Bucket Data exports

Set Up S3 Bucket Integration

How to set up S3 Bucket integration for Open Loyalty data exports

Last updated 1 month ago

Was this helpful?

Open Loyalty allows you to export data to an S3 bucket for seamless integration with your data lake. This guide will walk you through two approaches to setting up S3 Bucket integration:

  1. Access to the S3 Bucket

  2. Replicating Data Between S3 Buckets

Each method offers flexibility depending on your organization's existing infrastructure and preferences.

Open Loyalty generates daily data exports, providing delta changes for the previous day in a CSV format. For detailed information about each export type, refer to the following article:

The export frequency is set to daily to ensure consistent and timely access to the data for all our customers.

There is one report set for the environment, regardless of the number of tenants created. There is a unique identifier (tenant_id) for all the reports. Then you can create pipelines to further split the data per tenant.

Access to the S3 Bucket

In this method, the client is granted access to the Open Loyalty S3 bucket. Here’s how to set it up:

1

Create an AWS User

Create a new user specifically for this integration, enabling relevant access.

2

Share IAM Role Details

  • After creating the user, attach an with permissions to access the Open Loyalty S3 bucket.

  • Share the following details with the Open Loyalty team:

    • Role ARN: The Amazon Resource Name of your role.

    • Account ID: Your AWS account ID.

3

Access the Open Loyalty S3 Bucket

  • The Open Loyalty team will grant access to their S3 bucket for this IAM role.

  • Once access is granted, you can start setting up a pipeline to integrate the data directly from the Open Loyalty bucket to your data lake.

Advantages:

  • Reduced overhead as you don’t need to maintain your own intermediate bucket.


Replicating Data Between S3 Buckets

In this method, Open Loyalty replicates data to a client’s S3 bucket. This method is beneficial for organizations that prefer to maintain full control over their data pipeline.

1

Create an S3 Bucket

Create a new S3 bucket in your account, ensuring proper permissions are configured.

2

Share Bucket Details

Provide the following details to the Open Loyalty team:

  • Bucket Name: The name of the S3 bucket where the data will be replicated.

  • Bucket ARN: The Amazon Resource Name of the S3 bucket.

  • Account ID: Your AWS account ID.

  • Bucket Link: The URL link to your bucket.

Remember to enable bucket versioning.

3

Apply Bucket Policy

Open Loyalty will share with you the Bucket Policy to be applied to the bucket on your end.

4

Enable Data Replication

The Open Loyalty team will configure replication from their bucket to your designated S3 bucket.

Delta files are exported daily, after midnight UTC time.

5

Set Up a Pipeline

Once the data is replicated, you can create a pipeline to transfer data from your S3 bucket to your data lake using tools like AWS Glue, DataSync, or other tools.

Advantages:

  • Full control over your S3 bucket and data pipeline.

  • Flexibility to apply custom processing on your replicated data before integration.


Key Considerations

  • Data Security: Ensure that IAM roles and bucket policies are configured with the principle of least privilege to safeguard your data.

  • Costs: Replication and data transfers may incur AWS costs. Monitor your usage to optimize expenses.

  • Performance: Choose the method that aligns with your performance and integration needs.

Summary

By following the steps outlined above, you can easily set up integration with Open Loyalty data using the method that best fits your organization’s requirements. Whether you prefer direct access to the Open Loyalty S3 bucket or replication to your own bucket, these approaches enable efficient data integration to power your analytics and insights.

https://help.openloyalty.io/technical-guide/s3-bucket-data-exports/data-structure-and-types
IAM role