Merge pull request #618 from segmentio/repo-sync

repo sync

Author: bot-docsteam

src/engage/journeys/journeys-analytics.md

@@ -37,12 +37,14 @@ The following table shows the three statistics available for a Journey:
 
 Using the date picker, you can view a Journey's analytics over a specific period of time.
 
-The following table shows descriptions of the timeframes you can select:
-
-| Timeframe       | Description (based on UTC)           | 
-| --------------- | ------------------------------------ |
-| Since yesterday | Yesterday at midnight until now      |
-| Last 7 days     | The past seven days, including today |
-| Last 30 days    | The past 30 days, including today    |
-| Last 90 days    | The past 90 days, including today    |
-| Last 180 days   | The past 180 days, including today   |
+The following table shows descriptions of the time frames you can select:
+
+| Time frame         | Description (based on UTC)                                 |
+| ----------------- | ---------------------------------------------------------- |
+| Today             | Today, beginning at midnight                               |
+| Yesterday         | The day before today                                       |
+| Last 7 days       | The past seven days, not including today                   |
+| Last 30 days      | The past 30 days, not including today                      |
+| Last 90 days      | The past 90 days, not including today                      |
+| Last 180 days     | The past 180 days, not including today                     |
+| Custom date range | The period between two dates, including the selected dates |

src/engage/user-subscriptions/engage-sources.md

@@ -0,0 +1,22 @@
+---
+title: Engage Events Source
+plan: engage-foundations
+hidden: true
+---
+
+> info ""
+> The Engage Events Source is in beta.
+
+Use the Engage Events Source to sync Engage subscription states to your downstream warehouses.
+
+## Update downstream subscription states
+
+With Twilio Engage, you can [set and update user subscription states](/docs/engage/user-subscriptions/set-user-subscriptions/) with a [CSV file upload](/docs/engage/profiles/csv-upload/) or, programmatically, [using Segment APIs](/docs/engage/user-subscriptions/set-user-subscriptions/#manage-user-subscriptions-with-segment-apis).
+
+As part of Engage, Segment creates an Engage Events Source that lets you sync these subscription states [to warehouses Destinations](/docs/connections/storage/warehouses/). When a subscription state changes, Segment sends an update to the warehouse. As a result, the subscription states stored in your data warehouse(s) can serve as a single source of truth for managing user consent in other tools that you may have connected to your warehouse.
+
+## Working with Engage Events Sources
+
+Segment generates Engage Sources automatically. If you're using Engage, you can find the Source in your Segment space by navigating to **Connections > Sources**. Segment sets a `Generated` status to Engage Sources in the Statuses column of the **My Sources** table.
+
+From the **My Sources** table, you can select the Engage Source to add a warehouse Destination and configure the Source's settings. If you have more than one Engage space, Segment creates a separate Source for each space.