Skip to content

Commit 47a01b6

Browse files
committed
chore: formatting fixes for batch 1.4 of segment migration
1 parent 56a9a8a commit 47a01b6

File tree

11 files changed

+66
-61
lines changed

11 files changed

+66
-61
lines changed

src/engage/audiences/generative-audiences.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ To create an audience with Generative Audiences:
2121
3. Select your audience type. Generative Audiences is available for all audience types except Linked Audiences.
2222
4. From the Build screen, click **Build with AI**.
2323
5. Enter your audience prompt in the description box.
24-
- Use a minimum of 20 characters and up to 300 characters maximum.
24+
- Use a minimum of 20 characters and up to 300 characters maximum.
2525
6. Click **Build**. Based on your prompt, Segment generates audience conditions for your review.
26-
- Segment displays a progress bar until the audience conditions are generated.
26+
- Segment displays a progress bar until the audience conditions are generated.
2727

2828
> success ""
2929
> To help you write your prompt, view these [example prompts](#example-prompts) and [best practices](#best-practices).
@@ -55,13 +55,13 @@ Use the following examples to help you get started with audience prompts.
5555
This section shows a few examples of how Generative Audiences configures audience conditions for negative prompts. Negative conditions might include, for example, building an audience of users without a certain profile trait, or who haven't performed certain events.
5656

5757
1. **Prompt**: "Customers who have not purchased in the last 30 days."
58-
- **Expected output**: Segment generates audience conditions where *the event is performed at most 0 times*.
58+
- **Expected output**: Segment generates audience conditions where *the event is performed at most 0 times*.
5959

6060
2. **Prompt**: "Customers who don't have a phone number."
61-
- **Expected output**: Segment generates audience conditions where *the trait doesn't exist*.
61+
- **Expected output**: Segment generates audience conditions where *the trait doesn't exist*.
6262

6363
3. **Prompt**: "Customers who haven't received an email in the last 6 months."
64-
- **Expected output**: Segment generates audience conditions where *the event has been performed exactly 0 times*.
64+
- **Expected output**: Segment generates audience conditions where *the event has been performed exactly 0 times*.
6565

6666
## Best practices
6767

src/engage/audiences/index.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -233,8 +233,8 @@ To create a new audience or trait:
233233
1. Go to your **Computed Traits** or **Audiences** tab in Engage and select **Create**.
234234

235235
2. Configure and preview your Audience or Trait.
236-
- A lightning bolt next to `Realtime Enabled` indicates that the computation updates in real-time.
237-
- Configure the **Include Historical Event Data** option to limit how far back event data is processed by setting a lookback window (for example, the “last 90 days”). When the **Include Historical Event Data** option is unchecked, Segment only uses event data received after audience creation. However, trait data is always included as part of the filtering criteria whenever it is defined in the audience as lookback windows don't apply to trait data since it represents a snapshot of profile attributes at a given time.
236+
- A lightning bolt next to `Realtime Enabled` indicates that the computation updates in real-time.
237+
- Configure the **Include Historical Event Data** option to limit how far back event data is processed by setting a lookback window (for example, the “last 90 days”). When the **Include Historical Event Data** option is unchecked, Segment only uses event data received after audience creation. However, trait data is always included as part of the filtering criteria whenever it is defined in the audience as lookback windows don't apply to trait data since it represents a snapshot of profile attributes at a given time.
238238

239239
3. Select destinations to connect, then review and create your audience or trait.
240240

@@ -324,9 +324,9 @@ To create an Activation event health spikes or drops alert:
324324
3. On the Create alert sidesheet, select the **Activation event health spikes or drops** alert and pick a destination for which you'd like to monitor event health.
325325
4. Enter a percentage threshold to trigger activation event health notifications.
326326
5. Select one or more of the following alert channels:
327-
- **Email**: Select this to receive notifications at the provided email address.
328-
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
329-
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
327+
- **Email**: Select this to receive notifications at the provided email address.
328+
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
329+
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
330330
6. Click **Save**.
331331

332332
To make changes to an Activation event health spikes or drops alert, select the icon in the Actions column for the alert and click **Edit**.
@@ -343,9 +343,9 @@ To create an Audience size change alert:
343343
3. On the Create alert sidesheet, select the **Audience size change alert** and pick a destination for which you'd like to monitor event health.
344344
4. Enter a percentage threshold to trigger audience size change notifications.
345345
5. Select one or more of the following alert channels:
346-
- **Email**: Select this to receive notifications at the provided email address.
347-
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
348-
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
346+
- **Email**: Select this to receive notifications at the provided email address.
347+
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
348+
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
349349
6. Click **Save**.
350350

351351
To make changes to an Audience size change alert, select the icon in the Actions column for the alert and click **Edit**.
@@ -384,11 +384,11 @@ You can download a copy of your Audience by visiting the Audiences overview page
384384
1. Navigate to **Engage > Audiences**.
385385
2. Select the Audience you'd like to download as a CSV, then click **Download CSV**.
386386
3. Select the data fields that you'd like to include in your CSV as columns.
387-
- Your CSV contains all users in this audience with the selected fields. You can filter by `External ID`, `SQL trait`, `Computed Trait`, and `Custom Trait`.
387+
- Your CSV contains all users in this audience with the selected fields. You can filter by `External ID`, `SQL trait`, `Computed Trait`, and `Custom Trait`.
388388
4. Click **Next**.
389389
5. Before you can download the CSV, you'll need to generate it. There are two different options for formatting:
390-
- **Formatted:** Displays external IDs and traits as distinct columns.
391-
- **Unformatted:** Contains the following columns: a user/account key, a JSON object containing the external IDs (optional, if selected), and a JSON object containing the traits (optional, if selected).
390+
- **Formatted:** Displays external IDs and traits as distinct columns.
391+
- **Unformatted:** Contains the following columns: a user/account key, a JSON object containing the external IDs (optional, if selected), and a JSON object containing the traits (optional, if selected).
392392
6. Click **Generate CSV**.
393393

394394
Once Segment generates the CSV, you can download the file directly. You'll receive an email notification of the CSV completion, with a URL to the Audience overview page. Generating a CSV can take a substantial amount of time for large audiences. After you generate the CSV file, leave the modal window open while Segment creates the file. If the audience recalculates between when you click Generate and when you download the file, you might want to regenerate the file. The CSV is a snapshot from when you clicked Generate, and could be outdated.
@@ -397,7 +397,7 @@ Note the following limits for the CSV downloader:
397397
- You can't download more than one CSV for the same audience at the same time.
398398
- You can only generate one CSV every five minutes.
399399
- Each CSV represents a snapshot at a given point in time that references the data from the audience's most recent computational run. This applies to both real time and batch audiences, as the CSV is not updated in real time. To locate the snapshot's given point of time, click on the Download CSV button, and the popup modal will contain an information icon ℹ️, which when hovered over will reveal the snapshot's details.
400-
- ![CSV Snapshot details](https://github.com/user-attachments/assets/b7af772a-2ba7-4411-ba95-a913992f10ae)
400+
- ![CSV Snapshot details](https://github.com/user-attachments/assets/b7af772a-2ba7-4411-ba95-a913992f10ae)
401401

402402
> warning ""
403403
> You can't add account traits and identifiers using the CSV downloader with account-level audiences. This is because every row listed in the CSV file is a user, and since account traits and identifiers only exist on accounts, they wouldn't exist as a user's custom trait and appear on the CSV.

src/engage/campaigns/mobile-push/index.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,6 @@ Follow these steps to integrate Analytics Kotlin:
4545
```java
4646
<uses-permission android:name="android.permission.INTERNET"/>
4747
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
48-
4948
```
5049

5150
For detailed instructions on integrating Analytics Kotlin, follow the steps in the [Analytics Kotlin getting started section](/docs/connections/sources/catalog/libraries/mobile/kotlin-android#getting-started).
@@ -262,8 +261,8 @@ Next, you’ll create a push notification certificate, which lets your app recei
262261
3. If you are using the Quickstart app and see a provisioning error message, you may need to rename the bundle ID to a unique identifier. To do so, [give your bundle a new name](https://developer.apple.com/account/resources/certificates/list){:target="_blank"}, then enter your new identifier in the **Identity** section of the General pane.
263262
4. Go to the **Capabilities** tab and make sure that Push Notifications are enabled.
264263
5. Verify that you successfully created your certificates:
265-
- Sign in to the Apple developer portal and click on **Certificates, IDs & Profile**. In the **Certificates** section, select **Development** or **Production**, depending on the type of certificate you want to verify.
266-
- Alternatively, go to **Applications > Utilities > Keychain Access** and select **Certificates**. Search for `iPhone`, and verify that your certificate has a disclosure triangle, which indicates that your private key exists in the keychain.
264+
- Sign in to the Apple developer portal and click on **Certificates, IDs & Profile**. In the **Certificates** section, select **Development** or **Production**, depending on the type of certificate you want to verify.
265+
- Alternatively, go to **Applications > Utilities > Keychain Access** and select **Certificates**. Search for `iPhone`, and verify that your certificate has a disclosure triangle, which indicates that your private key exists in the keychain.
267266
268267
#### Option 2: Manually create a certificate
269268
@@ -350,9 +349,9 @@ Follow these steps to set up mobile push in Twilio Engage.
350349
6. Copy and save both the **SID** and **Secret** field contents.
351350
7. Return to the API keys & tokens page. In the **Live credentials** section, copy the Account SID credentials.
352351
8. Return to your Segment workspace and navigate to **Engage > Engage settings > Channels**. Under **SMS Service with Twilio**, click the **Get Started** button. The **Set up and validate your Twilio account** page appears.
353-
11. Under **Enter your Twilio API Key information**, paste the Account SID, API Key SID, and API Key Secret you copied above into their corresponding fields.
354-
12. Click **Verify**, then select the messaging services you want to use in your space.
355-
13. Click **Save Twilio Account.**
352+
9. Under **Enter your Twilio API Key information**, paste the Account SID, API Key SID, and API Key Secret you copied above into their corresponding fields.
353+
10. Click **Verify**, then select the messaging services you want to use in your space.
354+
11. Click **Save Twilio Account.**
356355

357356
> info "Removing messaging services"
358357
> To remove a messaging service, navigate to Engage > Engage settings > Channels and click the pencil icon under **Twilio messaging service**. Enter the account credentials by either using the API key secret or creating a new API key. Once you've selected the desired services, they will override the existing ones, effectively removing the ones you no longer need.
@@ -361,11 +360,11 @@ Follow these steps to set up mobile push in Twilio Engage.
361360

362361
Complete mobile push onboarding by creating a new push service:
363362

364-
2. In your Segment workspace, navigate to **Engage > Engage settings**.
365-
3. Click the pencil icon next to **Messaging services**, then click **Create new push service**.
363+
1. In your Segment workspace, navigate to **Engage > Engage settings**.
364+
2. Click the pencil icon next to **Messaging services**, then click **Create new push service**.
366365
- If you don't see the pencil icon, select **Create new push service**.
367-
4. Name the push service, select or create APN and FCM credentials, then click **Create Push Service**.
368-
5. Your new messaging service appears in the **Add messaging services** dropdown. Select it, then click **Save**.
366+
3. Name the push service, select or create APN and FCM credentials, then click **Create Push Service**.
367+
4. Your new messaging service appears in the **Add messaging services** dropdown. Select it, then click **Save**.
369368

370369
## Build a mobile push template
371370

src/engage/content/organization.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ plan: engage-premier
44
---
55
> info "Engage Premier End of Life"
66
> Engage Premier features, including Channels, Broadcasts, content templates, and Subscriptions, will no longer be available after December 15, 2025.
7+
78
To add structure to your marketing content, you can organize templates into folders and duplicate them within your Segment space.
89

910
## Organize with folders
@@ -50,8 +51,8 @@ To duplicate an email, SMS, or push template:
5051
2. Select the tab for the template type (Email, SMS, or Push) you'd like to clone.
5152
3. Select the **...** icon next to your template, then click **Duplicate**.
5253
4. Configure your duplicate template:
53-
- For SMS and push, edit your template, and save the duplicate once you're finished.
54-
- For email, add a template name on the **Duplicate Template** popup screen, then click **Duplicate**. You can then edit your email template from the Templates page.
54+
- For SMS and push, edit your template, and save the duplicate once you're finished.
55+
- For email, add a template name on the **Duplicate Template** popup screen, then click **Duplicate**. You can then edit your email template from the Templates page.
5556

5657
Learn more about configuring [email](/docs/engage/content/email/template/), [SMS](/docs/engage/content/sms/template/), and [push](/docs/engage/content/mobile-push/) templates.
5758

src/engage/journeys/v2/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ Segment **doesn't** copy the following:
133133
5. Review the duplicated journey and make any needed changes.
134134
6. If your journey includes destination sends, be sure to copy the new destination keys into your destination system.
135135

136-
> warning
136+
> warning ""
137137
> Currently, you can only duplicate journeys within the same Engage space. Duplicating across spaces or workspaces is not supported.
138138
139139
## Best practices

src/engage/onboarding.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -131,8 +131,8 @@ You’ll now need to enable event webhooks, which trigger webhook notifications
131131
2. Click the pencil edit icon next to **Event Webhook**.
132132
3. On the Event Webhook page, set authorization method to none.
133133
4. Copy and paste the following URL, depending on your region, into the **HTTP Post URL** field:
134-
- US: `https://engage-ma-webhook-api.engage.segment.com/sendgrid`
135-
- EU:`https://engage-ma-webhook-api.euw1.engage.segment.com/sendgrid`
134+
- US: `https://engage-ma-webhook-api.engage.segment.com/sendgrid`
135+
- EU:`https://engage-ma-webhook-api.euw1.engage.segment.com/sendgrid`
136136

137137
![Adding the HTTP Post URL](images/webhook.png "Adding the HTTP Post URL")
138138

@@ -262,7 +262,7 @@ To send WhatsApp messages in Twilio Engage, you'll register a Twilio number with
262262
### Register a Twilio number with WhatsApp
263263

264264
1. [Purchase an SMS-capable phone number](https://support.twilio.com/hc/en-us/articles/223135247-How-to-Search-for-and-Buy-a-Twilio-Phone-Number-from-Console){:target="_blank"} within your Twilio Console.
265-
- For international numbers, view Twilio's [Phone Number Regulations](https://www.twilio.com/en-us/guidelines/regulatory){:target="_blank"} guidelines.
265+
- For international numbers, view Twilio's [Phone Number Regulations](https://www.twilio.com/en-us/guidelines/regulatory){:target="_blank"} guidelines.
266266
2. From the Twilio side menu, navigate to **Messaging > Senders > WhatsApp Senders**.
267267
3. Select **Create new sender**.
268268
4. From the **New Sender** builder, find **Twilio phone number**, then choose the phone number you purchased in Step 1. Select **Continue**.

src/engage/profiles/csv-upload.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,8 +60,10 @@ You can use these characters in your CSV file:
6060
- The following non-English characters:
6161

6262

63-
```àáâäǎæãåāçćčċďðḍèéêëěẽēėęğġgg͟hħḥh̤ìíîïǐĩīıįķk͟hłļľl̥ṁm̐òóôöǒœøõōřṛr̥ɽßşșśšṣs̤s̱sțťþṭt̤ʈùúûüǔũūűůŵýŷÿźžżẓz̤ÀÁ
64-
ÄǍÆÃÅĀÇĆČĊĎÐḌÈÉÊËĚẼĒĖĘĞĠGG͟HĦḤH̤ÌÍÎÏǏĨĪIĮĶK͟HŁĻĽL̥ṀM̐ÒÓÔÖǑŒØÕŌŘṚR̥ɌSẞŚŠŞȘṢS̤S̱ȚŤÞṬT̤ƮÙÚÛÜǓŨŪŰŮŴÝŶŸŹŽŻẒZ```
63+
```
64+
àáâäǎæãåāçćčċďðḍèéêëěẽēėęğġgg͟hħḥh̤ìíîïǐĩīıįķk͟hłļľl̥ṁm̐òóôöǒœøõōřṛr̥ɽßşșśšṣs̤s̱sțťþṭt̤ʈùúûüǔũūűůŵýŷÿźžżẓz̤ÀÁ
65+
ÄǍÆÃÅĀÇĆČĊĎÐḌÈÉÊËĚẼĒĖĘĞĠGG͟HĦḤH̤ÌÍÎÏǏĨĪIĮĶK͟HŁĻĽL̥ṀM̐ÒÓÔÖǑŒØÕŌŘṚR̥ɌSẞŚŠŞȘṢS̤S̱ȚŤÞṬT̤ƮÙÚÛÜǓŨŪŰŮŴÝŶŸŹŽŻẒZ
66+
```
6567

6668
## View Update History
6769

0 commit comments

Comments
 (0)