This article details how to set up an Amazon S3 bucket for your Space, and how to manage exports of event data to this bucket.
Why would I export my event data?
mtribes lets you draw insights from user data ingested from your app. In accordance with GDPR rules, we discard user data after a 30-day period.
Exporting your event data to an Amazon S3 bucket gives you the flexibility to upload your user data to other data processing tools, or simply store it beyond the 30-day period.
How do I set up or change my Amazon S3 bucket?
Sign in to your mtribes account and go to the Plugins section in the left-hand side panel. Select the View details link in the Export to S3 plugin to open the page. Click on the Bucket settings button and follow the below instructions.
To set up or change your Amazon S3 bucket:
- Enter the name and path for your Amazon S3 bucket. If you don't have a bucket already set up, you can learn how to create an Amazon S3 bucket here.
- Grant us access by copying the mtribes bucket policy into your bucket policy. mtribes requires PUT, GET, DELETE, and LIST permissions to export event data successfully.
- Verify our access to your bucket by selecting the Verify bucket access button. We'll upload a test file to your bucket and delete it directly if verification is successful.
Note: When changing the bucket connected to your Space, any exports that are still exporting will finish to the previous bucket. All future recurring and one-off exports will export to your new bucket.
How do I set up a recurring export?
A recurring export will upload incremental event data to your Amazon S3 bucket at the interval selected by you. This export will continue for as long as it is Active. If this export is not active, it will display Paused.
To set up a recurring export:
- Select the Set up button and view the menu that opens.
- Choose export frequency from daily/hourly options.
- Enter bucket path (optional).
If you want to change the regularity of your Recurring export, simply click the Manage button, select desired regularly, and update.
How do I view my recurring export history?
On the main Event data page, a summary table contains when the most recent export was completed, when the next export will occur, and the total number of successful and unsuccessful exports. This quick view makes it easy to check how your recurring export is performing over time. To view the full recurring export history, select the View log button.
What does my export status indicate?
- Pending status - indicates export has not yet begun.
- Exporting status - indicates export is currently in progress.
- Success status - indicates export has been completed successfully.
How do I create a one-off export?
A one-off event data export can export historical data from the last 30 days. Exporting event data beyond the 30-day period is not possible in accordance with GDPR rules.
To create a one-off export, select + Export and specify the historical data you wish to export from the date picker. Dates are inclusive and displayed in UTC.
If you want to cancel a one-off export, hover over One-off export and select Cancel.
What does my export status indicate?
- Pending status - indicates export has not yet begun.
- Exporting status - indicates export is currently in progress.
- Success status - indicates export has been completed successfully.
What to read next?
Read how to set up an event by building an Experience template.