update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/common/navigation/engine/guides.yaml

@@ -601,6 +601,8 @@ navigation:
         path: /production/promotion/experience-notifications
       - title: Social media links
         path: /production/promotion/social-media-links
+      - title: Share links
+        path: /production/promotion/share-links
       - title: Player invite prompts
         path: /production/promotion/invite-prompts
       - title: Friend invite reward system

content/en-us/assets/analytics/acquisition/Share-Link-Acquisition-Dashboard.png

@@ -64,15 +64,15 @@ Here's a list of all the available acquisition sources:
   </tr>
   <tr>
     <td>Sponsored ads</td>
-    <td>Acquisition from [Sponsored Experiences](../promotion/ads-manager.md#sponsored-experiences) and **Sponsored Takeovers** on **Home**</td>
+    <td>Acquisition from [sponsored experiences](../promotion/ads-manager.md#sponsored-experiences) and **Sponsored Takeovers** on **Home**</td>
   </tr>
   <tr>
     <td>Search ads</td>
-    <td>Acquisition from [Search Ads](../promotion/search-ads.md)</td>
+    <td>Acquisition from [search ads](../promotion/search-ads.md)</td>
   </tr>
   <tr>
     <td>Portal ads</td>
-    <td>Acquisition from [Portal Ads](../promotion/ads-manager.md#portal-ads)</td>
+    <td>Acquisition from [portal ads](../promotion/ads-manager.md#portal-ads)</td>
   </tr>
   <tr>
     <td>Teleport</td>
@@ -86,7 +86,7 @@ Here's a list of all the available acquisition sources:
 
 ## Acquisition attribution
 
-The dashboard categorizes results for each acquisition source as follows:
+You can view the acquisition dashboard by [acquisition source](#acquisition-sources) or by [share links](../promotion/share-links.md). The dashboard categorizes results for both views as follows:
 
 <table>
   <tr>
@@ -119,7 +119,7 @@ The dashboard categorizes results for each acquisition source as follows:
   </tr>
 </table>
 
-<img src="../../assets/analytics/acquisition/New-Users-Funnel.png" width= "100%" alt="Chart indicating new users funnel."/>
+<img src="../../assets/analytics/acquisition/New-Users-Funnel.png" width= "100%" alt="Chart indicating new users funnel by acquisition source."/>
 
 ## Improve acquisition
 
@@ -161,3 +161,10 @@ Here are some tips to get users to visit your experience from external sources:
 1. **Create social accounts and post regularly**: Add social accounts such as Twitter, YouTube, and Instagram to your Roblox Experience Detail Page. Share regular updates, teasers, and screenshots to build buzz for your experience. Reply to other large social accounts to grow your following.
 2. **Create a user community**: Users in your community can share feedback, suggestions, bug reports, fan art, and more. Engage with your community regularly by hosting events and replying to comments and suggestions.
 3. **Partner with other creators and influencers**: You can partner with other creators who make similar experiences to grow together. You can also reach out to influencers who have large followings on platforms like YouTube or Twitch to see if they're willing to use or review your experience.
+4. **Create [share links](../promotion/share-links.md)**: Track your off-platform user acquisition and use the **New users funnel** table to understand:
+    - **Users with qualified plays**: How many new users are joining from each link?
+    - **7-day playtime per user**: Which links are bringing in users who engage the most?
+    - **D7 retention**: Which platforms drive users that keep coming back?
+    - **30-day revenue per user**: Which channels are attracting users who spend in-experience?
+
+<img src="../../assets/analytics/acquisition/Share-Link-Acquisition-Dashboard.png" width= "100%" alt="Chart indicating new users funnel by share links."/>

content/en-us/assets/promotion/Share-Link-Creation.png

@@ -71,6 +71,7 @@ Your similar experience benchmarks are updated daily. Roblox does not use these
 
 - Monitor the analytics of multiple experiences at once
 - Track avatar item sales and revenue
+- Track user acquisition through off-platform share links
 
 ### Monitor experiences
 
@@ -112,6 +113,10 @@ Avatar items you've sold automatically appear within the **Avatar Items** tab. H
     <figcaption>Avatar Items on Analytics Home.</figcaption>
 </figure>
 
+### Track user acquisition
+
+The **Share Links** tab provides information about the **Link Visits** metric, which tracks how many users have arrived on your experience details page by clicking on the share link you created.
+
 ## Analytics insights
 
 In each experience's overview page, there are insights that highlight major weekly changes in key metrics and areas of improvement.

content/en-us/production/analytics/acquisition.md

@@ -40,9 +40,13 @@ The following table details promotional methods for experiences on the platform.
 		<td>**Player invite prompts**</td>
 		<td>[Player invite prompts](../../production/promotion/invite-prompts.md), implemented directly inside your experience, encourage players to invite their friends and increase co‑experience gameplay.</td>
 	</tr>
+	<tr>
+		<td>**Friend invite reward system**</td>
+		<td>The [friend reward invite system](../../production/promotion/referral-system.md) rewards existing users for bringing in new users to your experiences.</td>
+	</tr>
 	<tr>
 		<td>**Experience notifications**</td>
-		<td>[Experience Notifications](../../production/promotion/experience-notifications.md) are a way for 13+ users to keep up with their favorite experiences through timely, personalized notifications. As the developer, you can determine what kinds of in‑experience activities are most important to notify your users about, as well as define the notification content.</td>
+		<td>[Notifications](../../production/promotion/experience-notifications.md) are a way for 13+ users to keep up with their favorite experiences through timely, personalized notifications. As the developer, you can determine what kinds of in‑experience activities are most important to notify your users about, as well as define the notification content.</td>
 	</tr>
   <tr>
 		<td>**Special sort categories on Roblox channels**</td>
@@ -72,10 +76,16 @@ The following table details promotional methods for avatar items on the platform
 
 ## Social media
 
-You can direct users to follow you on social media by embedding social media links on your experience's main details page. Social media links connect your audience over the age of 13 to your social media outside of Roblox, which you can use to market updates, monitor community feedback, and promote your experiences. For more information, see [Social media links](../../production/promotion/social-media-links.md).
+[Social media links](./social-media-links.md) are links to your social media channels. Use social media links to promote your social media presence by embedding these links on your experience details page.
 
 <img src="../../assets/promotion/misc/Social-Links-Example.png" width="540" />
 
+## Share links
+
+[Share links](./share-links.md) are links to your Roblox experiences. Use share links on your social media to promote your Roblox experiences and to track metrics for acquisition through off-platform channels.
+
+Unlike social media links, which direct users to your social media channels, share links promote and direct users to your Roblox experiences.
+
 ## Communities
 
 [Communities](../../projects/groups.md) can serve as a form of marketing for the experiences that you publish through them. Users playing an experience often engage with the creator of the experience, which in this case is the group page. Here, users can find social links, follow related communities for new content, and post on comment boards.

content/en-us/production/analytics/index.md

@@ -0,0 +1,26 @@
+---
+title: Share links
+description: How to create and use share links to promote your experiences and track acquisition metrics.
+---
+
+Share links are unique and trackable links that generate metrics that allow you to track and grow your off-platform user acquisition. You can also use custom `Class.Player:GetJoinData()|LaunchData` to provide in-experience perks to users that join through your share link.
+
+The analytics available for share links include metrics like how many new users have arrived at the experience details page through a share link, and which off-platform channel has brought in the most engaged users. There is no limit to how many share links you can create per experience; creating different links for different channels can help you keep better track of acquisition metrics.
+
+For more information on the analytics for share links, see the [Acquisition](../analytics/acquisition.md) page.
+
+## Create a share link
+
+<Alert severity="warning">
+You can only create share links for experiences you own. For group-owned experiences, you must be a member of the group and the share link must be created from the group account.
+</Alert>
+
+To create a share link:
+
+1. In the Creator Hub, go to **Creations** and select the **Share Links** tab.
+2. Click **Create link**.
+3. Enter a unique campaign name and select the experience you want to create a share link for.
+<img src="../../assets/promotion/Share-Link-Creation.png" width="540" />
+4. Click **Generate link**.
+
+The new share link generates instantly and is ready to be shared.

content/en-us/production/promotion/index.md

@@ -1,26 +1,20 @@
 name: KeyCode
 type: enum
 summary: |
-  A physical button that a user is pressing.
+  Byte keycodes that represent the key or button involved in user input.
 description: |
-  The KeyCode Enum contains a list of Byte keycodes that represent the button
-  used in a user input.
+  The `KeyCode` enum contains a list of byte keycodes that represent the key or
+  button involved in user input. This enum also includes buttons and axes
+  present on gamepads, and 96 `World[]` values for non-standard buttons.
 
-  Note, KeyCode keyboard values refer to the physical position of buttons on a
-  standard QWERTY keyboard. This means that, provided the user's system is
-  configured correctly, the location of keys (such as `WASD`) will remain the
-  same on other keyboard types, such as Dvorak keyboards (where it would map to
-  `,AOE`).
+  Note that keyboard values refer to the physical position of buttons on a
+  standard QWERTY keyboard. Provided the user's system is configured correctly,
+  the location of keys (such as
+  <kbd>W</kbd><kbd>A</kbd><kbd>S</kbd><kbd>D</kbd>) will remain the same on
+  other keyboard types such as Dvorak keyboards where it would map to
+  <kbd>,</kbd><kbd>A</kbd><kbd>O</kbd><kbd>E</kbd>.
 
-  This enum also includes buttons and axes present on gamepads, and 96 `World``
-  values for non-standard buttons.
-
-  The keypad is a cluster of keys that is present on many desktop keyboards, but
-  is rare for laptops to have.
-
-  See also:
-
-  - `Class.InputObject` - used for keyboard and gamepad input.
+  See also `Class.InputObject`, used for keyboard and gamepad input.
 code_samples:
 tags: []
 deprecation_message: ''
@@ -51,7 +45,7 @@ items:
     deprecation_message: ''
   - name: Return
     summary: |
-      Better known as enter.
+      Frequently known as **Enter**.
     value: 13
     tags: []
     deprecation_message: ''
@@ -1443,73 +1437,73 @@ items:
     deprecation_message: ''
   - name: ButtonX
     summary: |
-      Gamepad X button.
+      Gamepad `X` button.
     value: 1000
     tags: []
     deprecation_message: ''
   - name: ButtonY
     summary: |
-      Gamepad Y button.
+      Gamepad `Y` button.
     value: 1001
     tags: []
     deprecation_message: ''
   - name: ButtonA
     summary: |
-      Gamepad A button.
+      Gamepad `A` button.
     value: 1002
     tags: []
     deprecation_message: ''
   - name: ButtonB
     summary: |
-      Gamepad B button.
+      Gamepad `B` button.
     value: 1003
     tags: []
     deprecation_message: ''
   - name: ButtonR1
     summary: |
-      Gamepad R1 button.
+      Gamepad `R1` button.
     value: 1004
     tags: []
     deprecation_message: ''
   - name: ButtonL1
     summary: |
-      Gamepad L1 button.
+      Gamepad `L1` button.
     value: 1005
     tags: []
     deprecation_message: ''
   - name: ButtonR2
     summary: |
-      Gamepad R2 button.
+      Gamepad `R2` button.
     value: 1006
     tags: []
     deprecation_message: ''
   - name: ButtonL2
     summary: |
-      Gamepad L2 button.
+      Gamepad `L2` button.
     value: 1007
     tags: []
     deprecation_message: ''
   - name: ButtonR3
     summary: |
-      Gamepad R3 button.
+      Gamepad `R3` button.
     value: 1008
     tags: []
     deprecation_message: ''
   - name: ButtonL3
     summary: |
-      Gamepad L3 button.
+      Gamepad `L3` button.
     value: 1009
     tags: []
     deprecation_message: ''
   - name: ButtonStart
     summary: |
-      Gamepad Start button.
+      Gamepad `Start` button.
     value: 1010
     tags: []
     deprecation_message: ''
   - name: ButtonSelect
     summary: |
-      Gamepad Select button.
+      Gamepad `Select` button.
     value: 1011
     tags: []
     deprecation_message: ''
@@ -1553,34 +1547,41 @@ items:
     summary: ''
     value: 1018
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseRightButton
     summary: ''
     value: 1019
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseMiddleButton
     summary: ''
     value: 1020
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseBackButton
     summary: ''
     value: 1021
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseNoButton
     summary: ''
     value: 1022
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseX
     summary: ''
     value: 1023
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.
   - name: MouseY
     summary: ''
     value: 1024
     tags: []
-    deprecation_message: ''
+    deprecation_message: |
+      This enum is deprecated and flagged for removal.