Merge pull request #5719 from segmentio/style-updates

Update Unify and Engage FAQs

Author: pwseg

src/engage/faqs.md

@@ -1,5 +1,5 @@
 ---
-title: Engage Frequently Asked Questions
+title: Engage FAQs
 plan: engage-foundations
 redirect_from:
   - '/personas/faqs'

src/engage/journeys/faq-best-practices.md

@@ -65,37 +65,37 @@ Follow these best practices to test your journeys:
 - For early version journeys, scaffold Send to Destination steps without connecting to your production advertising or messaging destinations.
 - Verify individual users' progress through the Journey in the Profile explorer view.
 
-## Frequently asked questions
+## FAQs
 
-### How often do Journeys run?
+#### How often do Journeys run?
 
 Journeys run in real-time, like real-time Audiences in Engage. This means that users will progress through Journeys as Segment receives new events.
 
-### Can a user re-enter a Journey?
+#### Can a user re-enter a Journey?
 
 Yes. Users must first exit a Journey, however, before entering it again. To learn more about Journey re-entry, read the [Journey re-entry section](/docs/engage/journeys/build-journey/#journey-re-entry) of the [Build a Journey](/docs/engage/journeys/build-journey/) page.
 
-### What destinations does Journeys support?
+#### What destinations does Journeys support?
 
 Journeys supports all Engage destinations, including Destination Functions. Read more in Send data to destinations.
 
-### What are the reporting capabilities of Journeys?
+#### What are the reporting capabilities of Journeys?
 
 When building a Journey, if you check **Use historical data**, you can see the estimated number of users in the initial cohort.
 
 Once published, Journeys displays the number of users are in each step of the Journey at any given time.
 
-### How are users sent to downstream destinations?
+#### How are users sent to downstream destinations?
 
 The data type you send to a destination depends on whether the destination is an Event Destination or a List Destination.
 
-### Which roles can access Journeys?
+#### Which roles can access Journeys?
 For Engage customers, users with either the Engage User or Engage Admin roles can create, edit, and delete journeys. Users with the Engage Read-only role are restricted to view-only access.
 
-### Why am I seeing duplicate entry or exit events?
+#### Why am I seeing duplicate entry or exit events?
 
 Journeys triggers audience or trait-related events for each email `external_id` on a profile. If a profile has two email addresses, you'll see two Audience Entered and two Audience Exited events for each Journey step. Journeys sends both email addresses to downstream destinations.
 
-### How quickly do user profiles move through Journeys?
+#### How quickly do user profiles move through Journeys?
 
 It may take up to five minutes for a user profile to enter each step of a Journey, including the entry condition. For Journey steps that reference a batch audience or SQL trait, Journeys processes user profiles at the same rate as the audience or trait computation. Visit the Engage docs to [learn more about compute times](/docs/engage/audiences/#understanding-compute-times).

src/engage/trait-activation/id-sync.md

@@ -62,7 +62,7 @@ With Customized setup, you can choose which identifiers you want to map downstre
 - You can only select a maximum of three identifiers with an `All` strategy.
 
 
-## Frequently asked questions
+## FAQs
 
 #### What's the difference between Trait Enrichment and ID Sync?
 

src/engage/trait-activation/trait-enrichment.md

@@ -125,7 +125,7 @@ For best results with Trait Enrichment, Segment recommends:
 - Using Trait Enrichment with new audiences.
 - Using smaller audiences for real-time use cases, as data delivery is slower for large audiences. 
 
-## Frequently asked questions
+## FAQs
 
 #### What's the difference between Trait Enrichment and ID Sync? 
 

src/engage/user-subscriptions/subscription-groups.md

@@ -108,37 +108,34 @@ To set susbcription groups with the Identify call, you'll need to include a key-
 }
 ```
 
-## Frequently asked questions
+## FAQs
+
+#### How many subscription groups can I have? 
 
-{% faq %}
-{% faqitem How many subscription groups can I have? %}
 Your Engage space includes up to 25 subscription groups.
-{% endfaqitem %}
 
-{% faqitem Can I use subscription groups with templates I've already built? %}
+#### Can I use subscription groups with templates I've already built? 
+
 No. Templates you've previously created aren't compatible with subscription groups. To use subscription groups, you'll need to create new templates that include new unsubscribe and manage preference links.
-{% endfaqitem %}
 
-{% faqitem What happens if I delete a subscription group? %}
+#### What happens if I delete a subscription group?
+
 If you delete a subscription group, Engage will still maintain the preferences of the group's end users. 
-{% endfaqitem %}
 
-{% faqitem What subscription group events does the Engage Channels Source send? %}
-The [Engage Events Source](/docs/connections/sources/catalog/cloud-apps/engage-events/) tracks four subscription group events: `Email Unsubscribed`, `Email Group Unsubscribed`, `Channel Subscription Updated`, and `Group Subscription Updated`.
+#### What subscription group events does the Engage Channels Source send? 
 
-{% endfaqitem %}
+The [Engage Events Source](/docs/connections/sources/catalog/cloud-apps/engage-events/) tracks four subscription group events: `Email Unsubscribed`, `Email Group Unsubscribed`, `Channel Subscription Updated`, and `Group Subscription Updated`.
 
-{% faqitem How can users opt back in if they've unsubscribed from all groups? %}
+#### How can users opt back in if they've unsubscribed from all groups? 
 If a user unsubscribes from all of your subscription groups, they'll need to re-subscribe by explicitly opting back in to each group.
-{% endfaqitem %}
 
-{% faqitem Do subscription preference links work in test emails? %}
+#### Do subscription preference links work in test emails? 
+
 Yes. Test emails include fully functional unsubscribe and subscription preference links. If a test email recipient unsubscribes using a test email, Segment updates that user's subscription state. <br><br>
 
 Test emails temporarily override an email subscription state. This means that an unsubscribed email address can receive a test email but won't receive regular email campaigns from which they've unsubscribed.
-{% endfaqitem %}
 
-{% faqitem Should I follow any conventions when naming a subscription group? %}
+#### Should I follow any conventions when naming a subscription group? 
 
 Yes. Keep the following table in mind when you name a subscription group:
 
@@ -151,6 +148,3 @@ Yes. Keep the following table in mind when you name a subscription group:
 | Spaces in Group Names                         | Spaces aren't allowed at the beginning and/or end of the Group name |
 | Unsupported characters for Group Names        | `!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?`                               |
 | Unsupported accent characters for Group Names | `á, é, í, ó, ú, à, è, ì, ò, ù, ë, ï, ã`                             |
-{% endfaqitem %}
-
-{% endfaq %}

src/unify/Traits/predictions/using-predictions.md

@@ -70,49 +70,47 @@ Predictions may not be as beneficial in the following situations:
 - **When you sell limited but highly-priced items**, like enterprise software, complex medical machines, and so on; this also applies if you're in the B2B sector.
 - **When you don't yet have enough data**; your model could produce errors if, for example, your target is too new and lacks sufficient data. Waiting a month could allow Segment to gather more predictive data.
 
-## Frequently asked questions
+## FAQs
+
+#### What type of machine learning model do you use? 
 
-{% faq %}
-{% faqitem What type of machine learning model do you use? %}
 Segment uses a binary classification model that uses decision trees.
-{% endfaqitem %}
 
-{% faqitem What level of confidence can I have in my predictions? %}
+#### What level of confidence can I have in my predictions? 
+
 Once Segment creates your prediction, you can check the model statistics page, where Segments shows you how the model was created. Segment also maintains automated systems that monitor model performance and will alert you if your model is not predictive.
-{% endfaqitem %}
 
-{% faqitem How long do predictions take to create?  %}
+#### How long do predictions take to create? 
+
 Trait creation depends on the amount of data, but Segment expects predictions to be completed in around 24 hours. For larger customers, however, this could take 48 hours. Predictions shows a status of `In Progress` while computing; Segment updates this status when customers are scored.
-{% endfaqitem %}
 
-{% faqitem What are AUC, log loss, and lift quality? %}
+#### What are AUC, log loss, and lift quality? 
+
 These data science statistics measure the effectiveness of Segment's predictions when tested against historical data. For more information, refer to [ROC Curve and AUC](https://developers.google.com/machine-learning/crash-course/classification/roc-and-auc){:target="_blank"}, [The Lift Curve in Machine Learning](https://howtolearnmachinelearning.com/articles/the-lift-curve-in-machine-learning/){:target="_blank"}, and [Intuition behind log-loss score](https://towardsdatascience.com/intuition-behind-log-loss-score-4e0c9979680a){:target="_blank"}.
-{% endfaqitem %}
 
-{% faqitem What is the Prediction Quality Score? %}
+#### What is the Prediction Quality Score? 
+
 The Prediction Quality Score factors AUC, log loss, and lift quality to determine whether Segment recommends using the prediction. A model can have a score of Poor, Fair, Good, or Excellent.
-{% endfaqitem %}
 
-{% faqitem How do you store trait values? %}
+#### How do you store trait values? 
+
 The created trait value represents the user's percentile cohort. This value refreshes every seven days. If you see `0.85` on a user's profile, this means the user is in the 85th percentile, or the top 15% for the prediction.
-{% endfaqitem %}
 
-{% faqitem How frequently do you re-train the model? %}
+#### How frequently do you re-train the model? 
+
 Segment rebuilds the machine learning model every 30 days.
-{% endfaqitem %}
 
-{% faqitem How frequently do you update trait values? %}
+#### How frequently do you update trait values? 
+
 Every seven days.
-{% endfaqitem %}
 
-{% faqitem How many predictions can I have? %}
+#### How many predictions can I have? 
+
 You get five predictions as part of Engage Foundations or Unify Plus. To purchase more predictions, reach out to your CSM.
-{% endfaqitem %}
 
-{% faqitem Are there any known Predictions limitations? %}
+#### Are there any known Predictions limitations? 
+
 Yes. Keep the following in mind when you work with Predictions:
 
 - **Predictions made for more than 100 million users will fail.** Segment recommends making predictions only for non-anonymous users, or, as an alternative, use the Starting Cohort to narrow down the audience for which you want to make a prediction.
 - **Predictions may not work as intended if you track more than a thousand unique events in your workspace.** If this applies to your use case, [contact Segment Support](https://segment.com/help/contact/){:target="_blank"} for help with removing unused events, which will allow you to create predictions.
-{% endfaqitem %}
-{% endfaq %}

src/unify/faqs.md

@@ -1,5 +1,5 @@
 ---
-title: Unify Frequently Asked Questions
+title: Unify FAQs
 plan: unify
 ---
 

src/unify/identity-resolution/index.md

@@ -26,9 +26,9 @@ Identity Resolution sits at the core of Segment. The Identity Graph merges the c
 4. **Maintains persistent ID** - multiple external IDs get matched to one persistent ID
 
 
-## Frequently asked questions
+## FAQs
 
-### Can I use the Profile API on the client-side?
+#### Can I use the Profile API on the client-side?
 For security reasons, Segment requires that the [Profile API](/docs/unify/profile-api/) only be used server-side. The Profile API allows you to look up data about any user given an identifier (for example, email, `anonymousId`, or `userId`) and an authorized access secret. While this enables powerful personalization workflows, it could also let your customers' data fall into the wrong hands if the access secret were exposed on the client.
 
 Instead, by creating an authenticated personalization endpoint server-side backed by the Profile API, you can serve up personalized data to your users without the risk of their information falling into the wrong hands.

src/unify/linked-profiles/linked-events.md

@@ -152,7 +152,7 @@ After you’ve added Enrichments, test and save your enrichments.
 > warning ""
 > At this time, when you select mappings or test events, you won’t see enrichment data. Enrichment data is only available with real events.
 
-## Frequently asked questions
+## FAQs
 
 #### What data warehouse permissions does Segment require? 
 

src/unify/profiles-sync/sample-queries.md

@@ -154,7 +154,7 @@ INNER JOIN ps_materialize.id_graph
 
 This query works with any Trait or Audience membership, whether computed in Engage or instrumented upstream.
 
-## Frequently asked questions
+## FAQs
 
 #### Can I view Engage Audience membership and Computed Trait values in my Warehouse?