Custom S3
Adapty UA’s integration with custom S3-compatible storage allows you to store user acquisition campaign data securely in your own S3-compatible storage solution. You will be able to save your campaign performance data, attribution data, and user acquisition events to your custom S3 bucket as .csv files.
To set up this integration, you will need to follow a few simple steps in your S3-compatible storage console and Adapty UA dashboard.
Adapty UA sends your data every 24h at 4
UTC.Each file will contain data for the events created for the entire previous calendar day in UTC. For example, the data exported automatically at 4
UTC on March 8th will contain all the events created on March 7th from 00:00 to 23:59 in UTC.Set up Custom S3 integration
To start receiving data, configure the integration in Adapty UA:
- Go to Integrations -> Custom S3
- Turn on the Export install events to custom S3 toggle from.
- Fill out the required fields to build a connection between your custom S3 storage and Adapty UA profiles
| Field | Description |
|---|---|
| Access Key ID | A unique identifier that is used to authenticate a user or application’s access to your S3-compatible storage service. Find this ID in your storage provider’s console. |
| Secret Access Key | A private key that is used in conjunction with the Access Key ID to authenticate a user or application’s access to your S3-compatible storage service. Find this Key in your storage provider’s console. |
| S3 Bucket Name | A globally unique name that identifies a specific S3 bucket within your storage environment. S3 buckets are a simple storage service that allows users to store and retrieve data objects, such as files and images, in the cloud. |
| Region (Optional) | Get your Region from the Management Console. |
| Folder Inside the Bucket (Optional) | The name of the folder that you want to have inside the selected S3 bucket. Please note that S3 simulates folders using object key prefixes, which are essentially folder names. |
| Custom Endpoint URL | The endpoint URL for your S3-compatible storage service. This should be provided by your storage provider (e.g., MinIO, DigitalOcean Spaces, Wasabi, etc.). |
You can also specify nested directories in the S3 bucket name field, e.g. adapty-ua-events/com.sample-app
Manual data export
In addition to the automatic event data export to your custom S3 storage, Adapty UA also provides a manual file export functionality. With this feature, you can select a date for the user acquisition data and export it to your S3 bucket manually. This allows you to have greater control over the data you export and when you export it.
Table structure
In custom S3 integration, Adapty UA provides a table to store historical data for installation events. The table contains information about the user profile, revenue and proceeds, and the origin store, among other data points.
Note that this structure may grow over time — with new data being introduced by us or by the 3rd parties we work with. Make sure that your code that processes it is robust enough and relies on the specific fields, but not on the structure as a whole.
Here is the table structure for the events:
| Column | Description |
|---|---|
adapty_profile_id | Unique Adapty profile identifier |
install_id | Unique installation identifier |
created_at | Record creation timestamp (ISO 8601) |
installed_at | App installation timestamp (ISO 8601) |
store | App store (ios, android) |
country | User’s country code (ISO 3166-1 alpha-2) |
ip_address | Client IP address |
idfa | iOS Identifier for Advertisers |
idfv | iOS Identifier for Vendors |
gaid | Google Advertising ID (Android) |
android_id | Android device ID |
app_set_id | Android App Set ID |
channel | Attribution channel |
campaign_id | Campaign identifier |
campaign_name | Campaign name |
adset_id | Ad set identifier |
adset_name | Ad set name |
ad_id | Ad identifier |
ad_name | Ad name |
keyword_id | Keyword identifier |
keyword_name | Keyword name |
asa_org_id | Apple Search Ads organization ID |
asa_keyword_match_type | ASA keyword match type (Exact, Broad) |
asa_attribution | ASA attribution data (JSON string) |
asa_conversion_type | ASA conversion type |
asa_country_or_region | ASA country or region |
asa_creative_set_name | ASA creative set name |
fbclid | Facebook Click ID |
ttclid | TikTok Click ID |
utm_source | UTM source parameter |
utm_medium | UTM medium parameter |
utm_campaign | UTM campaign parameter |
utm_term | UTM term parameter |
utm_content | UTM content parameter |