-
Notifications
You must be signed in to change notification settings - Fork 352
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
AWS S3 Actions - Adding new documentation on supported integrations, and mappings #7330
Conversation
@@ -25,6 +25,12 @@ The AWS S3 (Actions) destination enhances this capability by introducing configu | |||
|
|||
* **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. | |||
|
|||
## Supported Integrations | |||
The AWS S3 (Actions) Destination supports the following Segment features as supported native Destination integration points: | |||
* rETL |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* rETL | |
* [Reverse ETL](/docs/connections/reverse-etl/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
## Supported Integrations | ||
The AWS S3 (Actions) Destination supports the following Segment features as supported native Destination integration points: | ||
* rETL | ||
* Classic and Linked Audiences |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Classic and Linked Audiences | |
* [Classic and Linked Audiences](/docs/engage/audiences/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
The AWS S3 (Actions) Destination supports the following Segment features as supported native Destination integration points: | ||
* rETL | ||
* Classic and Linked Audiences | ||
* Connections |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Connections | |
* [Connections](/docs/connections/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
@@ -36,7 +42,7 @@ Ensure you have the following in place before configuring the AWS S3 (Actions) d | |||
- 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. | |||
|
|||
|
|||
### Step 1: Create an IAM role in the AWS console | |||
## Step 1: Create an IAM role in the AWS console |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would prefer to keep all of the setup steps one heading level under the Getting started header to keep a consistent pattern across other integrations!
## Step 1: Create an IAM role in the AWS console | |
### Step 1: Create an IAM role in the AWS console |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
@@ -81,8 +87,9 @@ To set up the IAM role to properly authorize Segment with the AWS S3 (Actions) d | |||
] | |||
} | |||
``` | |||
|
|||
## Step 2: Add the AWS S3 (Actions) Destination in Segment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Step 2: Add the AWS S3 (Actions) Destination in Segment | |
### Step 2: Add the AWS S3 (Actions) Destination in Segment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@forstisabella one of the reasons @jpang007 submitted this was to get all the steps in the side-nav:
I think we should either show all in side-nav or none. That said, I will defer to @forstisabella on what we should use as the standard
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That makes sense! I think we shouldn't have the steps in the side nav to stay consistent with other destinations' docs!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (i.e Track events file and Identifer events file). | ||
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. | ||
4. Configure the Other Settings as needed. | ||
5. Enable the Mapping and start sending data! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
5. Enable the Mapping and start sending data! | |
5. Enable the Mapping. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
1. Add a new **Sync to S3** Action into the destination. | ||
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (i.e Track events file and Identifer events file). | ||
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. | ||
4. Configure the Other Settings as needed. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
4. Configure the Other Settings as needed. | |
4. Configure any additional settings as required. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
|
||
1. Add a new **Sync to S3** Action into the destination. | ||
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (i.e Track events file and Identifer events file). | ||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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. | |
3. Configure the Column Mappings. If you don't need any of the default columns, leave the value blank. You can also choose to add new mapping fields to set up customized columns as needed. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
|
||
1. Add a new **Sync to S3** Action into the destination. | ||
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (i.e Track events file and Identifer events file). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (i.e Track events file and Identifer events file). | |
2. Define the Event Trigger. If multiple types are accepted in the Event Trigger, the generated files will automatically be split by type in S3 (for example, you might have a Track events file and an Identify events file). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
|
||
{% include components/actions-fields.html settings="true"%} | ||
|
||
## Step 3: Configure the AWS S3 (Actions) Destination mappings | ||
To finish the configuration, finalize the mappings of the new AWS S3 (Actions) Destination: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To finish the configuration, finalize the mappings of the new AWS S3 (Actions) Destination: | |
To finish the configuration, add mappings to your new AWS S3 (Actions) Destination: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site. |
Proposed changes
Added in extra documentation on mapping functionality as well as the supported Segment Feature Integrations
Merge timing
ASAP once approved
Related issues (optional)
N/A