Engage ga (#590)

* Account-audiences article

* Debugger

* ID Res eComm example

* Audiences Overview

* Computed Traits

* Identity Resolution Overview

* Identity Resolution Onboarding

* Profiles Space Setup

* ID Resolution Settings

* Journeys Key Terms

* Engage GDPR

* ID Res use cases

* Nav stubs

* Build a Journey

* Audiences and space setup updates

* Journeys FAQ Best Practices

* Update computed traits location

* Send Data

* product limits

* Sql traits

* add example csv files

* Using Engage Data

* Engage and Warehouses

* Profile API

* Audiene Organization

* Quickstart

* FAQs

* Journeys use cases

* Remove Personas screenshot

* Journeys Logic

* Journeys Overview and Warehouses update

* Profiles External IDs

* Space setup nav update

* use standard layout

* Use standard search, refactor overview

* Profile API fixes

* Fixing profiles nav

* Match user_id value with screenshot

* Use Cases cleanup

* CSV Uploader updates

* Deep clean

* move CSV upload

* Engage Intro and Identity Warehouse

* Link and nav fixes

* forgot to save this one

* Remove Essentials limits

* Update nav

* More nav updates

* More nav updates

* Plan Grid work to support Engage SKUs

* Add Profile API Limits to nav

* replacing instances

* Add plan details as metadata

* Personas replacements

* Personas replacements

* Add recent externalID updates to Engage branch

* Move journey analytics

* and add it to the nav

* remove old layout

* hide empty docs from nav

* Minor email and SMS template edits

* CSV upload navigation updates

* file and nav cleanup

* Hide internal logo

* RIP Personas

* link fixes

* Hide empty articles

* quickstart in the nav

* Update Engage icon and blurb link

* Profiles Overview

* Update Engage blurb

* Update Engage blurb

* get onboard

* FAQs split

* Add Onboarding Redirect

* Add Channels product limit

* Profiles GDPR

* Profiles Quickstart split

* Add Engage Settings Content

* Add split content to sidenav

* fixed broken links

* Beta check and unpublish contact page

* Quickstart updates

* Remove Engage Support References

* Hide Engage Settings Pages

* Update instance of Engage Pro to Premier and link fixes

* Relink images

* additional link fixes

* Add Journeys Step Types Page [DOC-587] (#589)

* Add Journeys Step Types Page DOC-587

* Vale Sentence Case Fixes DOC-587

* Update Journey Re-entry FAQ

Co-authored-by: rchinn-segment <[email protected]>
Co-authored-by: pwseg <[email protected]>
Co-authored-by: pwseg <[email protected]>

Author: 3 people

.github/styles/Vocab/Docs/accept.txt

@@ -14,6 +14,7 @@
 (?:R|r)emarketing
 (?:U|u)nlinks?\b
 (?:U|u)nmaps?\b
+(?:U|u)ploader
 (?:U|u)rls?\b
 adset
 Adwords
@@ -42,6 +43,7 @@ datetime
 deeplink
 Dev
 Doubleclick
+enablement
 endcapture
 endfor
 endif
@@ -81,6 +83,7 @@ Mailmodo
 markdownify
 Marketo
 Matcha
+matchers
 measurability
 middleware
 Middleware
@@ -94,8 +97,10 @@ Optimizely
 param(:?s)
 Pardot
 performant
+Pinterest
 Preact
 Qualtrics
+Responsys
 Rokt
 Selligent
 Sendgrid

js/algolia/index.js

@@ -24,7 +24,6 @@ const algoliaInsightsPlugin = createAlgoliaInsightsPlugin({ insightsClient });
 
 // define locations to separate invocation for mobile and desktop
 const locations = ['#autocomplete','#autocomplete-mobile'];
-const engage_locations = ['#engage-autocomplete']
 
 function initAutocomplete(item){
   const search = autocomplete({
@@ -106,90 +105,4 @@ function initAutocomplete(item){
 
 }
 
-function initEngageAutocomplete(item){
-  const search = autocomplete({
-    container: item,
-    placeholder: "Search the Twilio Engage documentation",
-    debug: false,
-    openOnFocus: false,
-    keyboardShortcuts: ['s', 191],
-    plugins: [algoliaInsightsPlugin,],
-    detachedMediaQuery:'none',
-    getSources( {query} ) {
-      return [
-        {
-          sourceId: 'articles',
-          getItemUrl({ item }){
-            if (item.anchor != null) {
-              var itemUrl = '/docs'+item.url+"#" + item.anchor;
-            } else {
-              var itemUrl = '/docs'+item.url;
-            }
-            return itemUrl;
-          },
-          getItems() {
-            return getAlgoliaResults({
-              searchClient,
-              queries: [
-                {
-                  indexName: 'segment-docs',
-                  query,
-                  params: {
-                    hitsPerPage: 7,
-                    facetFilters: ['hidden:-true'],
-                    clickAnalytics: true,
-                  },
-                },
-              ],
-            });
-          },
-          templates: {
-            item({ item, createElement  }){
-              if (item.anchor != null) {
-                var anchorLink = "#" + item.anchor;
-              } else {
-                var anchorLink = "";
-              }
-
-              if (item.engage){
-                var engage = "<span class='engage-pill'>Engage</span>"
-              }
-              return createElement('div',{
-                dangerouslySetInnerHTML: {
-                  __html: `<a class="aa-link" href="/docs${item.url}${anchorLink}">
-                     <p class="aa-title" >${highlightHit({hit: item, attribute: 'title'})} ${engage}</h3>
-                     <p class="aa-content">${highlightHit({hit: item, attribute: 'content'})}</p></a>`
-                }
-              })
-            },
-            noResults() {
-              return html `<p class="aa-content">No results for <strong>${query}</strong></p>`;
-            }
-          },
-          
-        },
-      ];
-    },
-    navigator: {
-      navigate({ itemUrl }) {
-        window.location.assign(itemUrl);
-      },
-      navigateNewTab({ itemUrl }) {
-        const windowReference = window.open(itemUrl, '_blank', 'noopener');
-  
-        if (windowReference) {
-          windowReference.focus();
-        }
-      },
-      navigateNewWindow({ itemUrl }) {
-        window.open(itemUrl, '_blank', 'noopener');
-      },
-    },
-  });
-  
-}
-if (loc.startsWith("/docs/engage")) {
-  engage_locations.forEach(initEngageAutocomplete)
-} else {
 locations.forEach(initAutocomplete);
-}

netlify.toml

@@ -12,7 +12,7 @@
   ignore = "./scripts/ignore.sh"
 
 [context.branch-deploy]
-  command = "jekyll algolia && yarn build"
+  command = "yarn build"
 #  ignore = "./scripts/ignore.sh"
 
 [context.develop]

scripts/checklinks-internal.js

@@ -67,7 +67,7 @@ const checkForDeadLocalUrls = async () => {
     // For ease of checking, replace the localhost domain with the live domain, add those to a new array.
     let broke = []
     deadUrls.forEach(url => {
-      link = url.replace('http://localhost:3000', 'https://segment.com/docs')
+      link = url.replace('http://localhost:3000', 'https://engage-ga--segment-docs-private.netlify.app/docs')
       if (!link.endsWith('/')){
         link = link+'/'
       }
@@ -79,7 +79,7 @@ const checkForDeadLocalUrls = async () => {
     // For those, we want to remove them from the list of dead links, because they aren't dead.
 
     // app-nginx redirects
-    const redirects = ['https://segment.com/docs/guides/usage-and-billing/','https://segment.com/docs/connections/sources/catalog/libraries/website/plugins/', 'https://segment.com/docs/assets/docs.bundle.js/']
+    const redirects = ['https://engage-ga--segment-docs-private.netlify.app/docs/guides/usage-and-billing/','https://engage-ga--segment-docs-private.netlify.app/docs/connections/sources/catalog/libraries/website/plugins/', 'https://engage-ga--segment-docs-private.netlify.app/docs/assets/docs.bundle.js/']
 
     // Redirects generated by Jekyll
     // Pull the redirects json file
@@ -89,7 +89,7 @@ const checkForDeadLocalUrls = async () => {
       if (!key.endsWith('/')){
         key = key+'/'
       }
-      redirects.push('https://segment.com/docs'+key.replace('/docs',''))
+      redirects.push('https://engage-ga--segment-docs-private.netlify.app/docs'+key.replace('/docs',''))
     })
     // Remove the redirect urls from the list of broken URLs
     broke = broke.filter(val => !redirects.includes(val));

src/_data/glossary.yml

@@ -2,7 +2,7 @@ Analytics.js: |
   The Segment Javascript library wrapper, which makes it simple to send your data to any tool without having to learn, test or implement the new API for each tool every time.
 
 API: |
-  Application Programming Interface. In software, this term describes a way of interacting with software in an automated fashion, without the use of a user-interface designed for humans. In Segment, we call the standard calls (`track`, `page` and `screen`, `identify` and `group`) our API. We also provide the [Public API](/docs/api/), which you can use to configure sources and destinations, and perform other functions in your workspace, without logging in using a web browser.
+  Application Programming Interface. In software, this term describes a way of interacting with software in an automated fashion, without the use of a user-interface designed for humans. In Segment, we call the standard calls (`track`, `page` and `screen`, `identify` and `group`) our API. We also provide the [Public API](/docs/api/public-api), which you can use to configure sources and destinations, and perform other functions in your workspace, without logging in using a web browser.
 
 App: |
   The app is what we call the main Segment web application, the part you log in to, and where you configure sources and destinations, see events in the debugger, manage your tracking plan, and so on.
@@ -42,7 +42,7 @@ Computed trait: |
   [Computed traits](/docs/personas/computed-traits/) are per-user, or per-account [traits](#traits) that you create or “compute” in [Personas](/docs/personas/). When you build a Computed Trait, Personas adds it to relevant user profiles.
 
 Custom trait: |
-  [Custom Traits](/docs/personas/audiences/#custom-traits) are user or account properties collected from all the events you send to Personas.  For example, you can add any properties that you send as a part of your track calls or identify calls (`email`, `first_name`, `last_name`) as custom traits. You can then view them in the profile explorer, and use them in your audiences, computed traits and SQL traits.
+  [Custom Traits](/docs/engage/audiences/#custom-traits) are user or account properties collected from all the events you send to Personas.  For example, you can add any properties that you send as a part of your track calls or identify calls (`email`, `first_name`, `last_name`) as custom traits. You can then view them in the profile explorer, and use them in your audiences, computed traits and SQL traits.
 
 Debugger: |
   This is the place in the app where you can see your events flowing through Segment

src/_data/landing.yml

@@ -17,10 +17,10 @@ sections:
     icon: protocols.svg
     description: "Prevent data quality issues with a tracking schema and enforcement with Protocols."
     path: /protocols/
-  - name: Personalize interactions
-    icon: personas.svg
-    description: "Improve customer interactions by building audiences that power personalized experiences."
-    path: /personas/
+  - name: Personalize experiences
+    icon: engage.svg
+    description: "Build audiences and journeys from real-time customer data to personalize experiences on every channel."
+    path: /engage/
   - name: Respect users' privacy
     icon: privacy.svg
     description: "Keep customer data private with Segment's data discovery and policy enforcement tools."

src/_data/products.yml

@@ -1,27 +1,50 @@
 items:
-- product_display_name: Personas
-  slug: personas
-  plan-note: "Personas is available as an add-on for Business plans only."
+- product_display_name: Engage Foundations
+  slug: engage-foundations
+  plan-note: "Engage Foundations requires a Business tier account and includes Profiles."
+  addon: true
   plans:
     free: false
     team: false
     business: true
-    add-on: true
-- product_display_name: Personas Identity Graph
-  slug: personas-id
+  # addons:
+  #   profiles: true
+  #   engage-foundations: true
+  #   engage-plus: false
+- product_display_name: Engage Premier
+  slug: engage-premier
+  plan-note: "Engage Premier requires a Business tier account and includes Engage Foundations and Profiles."
+  addon: true
   plans:
     free: false
     team: false
     business: true
-    add-on: true
+  # addons:
+  #   profiles: false
+  #   engage-foundations: false
+  #   engage-plus: true
+
+- product_display_name: Profiles
+  slug: profiles
+  plan-note: "Profiles requires a Business tier account and is included with Engage."
+  addon: true
+  plans:
+    free: false
+    team: false
+    business: true
+  # addons:
+  #   profiles: true
+  #   engage-foundations: false
+  #   engage-plus: false
+
 - product_display_name: Protocols
   slug: protocols
   plan-note: "Protocols is available as an add-on for Business plans only."
+  addon: true
   plans:
     free: false
     team: false
     business: true
-    add-on: true
 - product_display_name: Advanced Access Management
   slug: iam
   plan-note: "Advanced Access Management is available for all Business plans."