You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-s3/index.md
+21-5Lines changed: 21 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,6 +25,12 @@ The AWS S3 (Actions) destination enhances this capability by introducing configu
25
25
26
26
***Enhanced Delivery Controls**. The destination provides advanced options for batch size controls and file naming conventions. These controls can help optimize efficiency and simplify data retrieval workflows.
27
27
28
+
## Supported Integrations
29
+
The AWS S3 (Actions) Destination supports the following Segment features as supported native Destination integration points:
30
+
* rETL
31
+
* Classic and Linked Audiences
32
+
* Connections
33
+
28
34
## Getting started
29
35
Setting up the AWS S3 (Actions) destination is a straightforward process designed to help you configure and deploy standardized event data to your Amazon S3 bucket. Follow these steps to get started:
30
36
@@ -36,7 +42,7 @@ Ensure you have the following in place before configuring the AWS S3 (Actions) d
36
42
- IAM Access IDs: Prepare your AWS IAM ARN ID and IAM External ID. These will be needed to authenticate and authorize Segment with your S3 bucket.
37
43
38
44
39
-
###Step 1: Create an IAM role in the AWS console
45
+
## Step 1: Create an IAM role in the AWS console
40
46
To set up the IAM role to properly authorize Segment with the AWS S3 (Actions) destination:
41
47
42
48
1. Log in to your AWS account.
@@ -69,7 +75,7 @@ To set up the IAM role to properly authorize Segment with the AWS S3 (Actions) d
@@ -81,8 +87,9 @@ To set up the IAM role to properly authorize Segment with the AWS S3 (Actions) d
81
87
]
82
88
}
83
89
```
90
+
84
91
## Step 2: Add the AWS S3 (Actions) Destination in Segment
85
-
To finish the configuration, enable the AWS S3 (Actions) Destination in your workspace.
92
+
To finish the setup, enable the AWS S3 (Actions) Destination in your workspace:
86
93
87
94
1. Add the **AWS S3 (Actions)** destination from the Destinations tab of the catalog.
88
95
2. Select the data source you want to connect to the destination.
@@ -93,8 +100,17 @@ To finish the configuration, enable the AWS S3 (Actions) Destination in your wor
93
100
* Enter the ARN of the IAM role you created above. The ARN should follow the format `arn:aws:iam::ACCOUNT_ID:role/ROLE_NAME.`
94
101
* Enter the IAM External ID, which is a value set in the Trust Relationship under your AWS IAM Role.
95
102
5. Enable the destination.
96
-
6. Verify the Segment data is stored in the S3 bucket by navigating to the `<your_S3_bucket>/` in the AWS console.
97
103
98
104
{% include components/actions-fields.html settings="true"%}
99
105
100
-
106
+
## Step 3: Configure the AWS S3 (Actions) Destination mappings
107
+
To finish the configuration, finalize the mappings of the new AWS S3 (Actions) Destination:
108
+
109
+
1. Add a new **Sync to S3** Action into the destination.
110
+
2. Define the Event Trigger
111
+
3. Configure the Column Mappings that are needed, if any of the default columns are **not** needed, leave the value blank. You can also choose to add new mapping fields to set up any customized columns as needed.
112
+
4. Configure the Other Settings as needed:
113
+
* Enable Batching, Delimiter and File Extension are all required.
114
+
***Note** If the audience_action or batch_size column names are not needed, these fields can be left blank so they do not output on the S3 file.
115
+
5. Enable the Mapping and start sending data!
116
+
6. Verify the Segment data is stored in the S3 bucket by navigating to the `<your_S3_bucket>/` in the AWS console.
0 commit comments