update Open Source Docs from Roblox internal teams

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

.github/actions/quality-checks/action.yml

@@ -13,6 +13,8 @@ inputs:
     description: Whether to check relative links
   CHECK_RETEXT_ANALYSIS:
     description: Whether to check retext analysis
+  CHECK_UNUSED_ASSETS:
+    description: Whether to check for unused assets
   COMMIT_HASH:
     description: Commit hash
   EVENT_NAME:
@@ -53,6 +55,7 @@ runs:
         CHECK_PROTECTED_FIELDS: ${{ inputs.CHECK_PROTECTED_FIELDS }}
         CHECK_RELATIVE_LINKS: ${{ inputs.CHECK_RELATIVE_LINKS }}
         CHECK_RETEXT_ANALYSIS: ${{ inputs.CHECK_RETEXT_ANALYSIS }}
+        CHECK_UNUSED_ASSETS: ${{ inputs.CHECK_UNUSED_ASSETS }}
         COMMIT_HASH: ${{ inputs.COMMIT_HASH }}
         POST_PULL_REQUEST_COMMENTS: ${{ inputs.POST_PULL_REQUEST_COMMENTS }}
         PULL_REQUEST_NUMBER: ${{ inputs.PULL_REQUEST_NUMBER }}

.github/workflows/content-checks.yml

@@ -96,6 +96,7 @@ jobs:
           CHECK_PROTECTED_FIELDS: true
           CHECK_RELATIVE_LINKS: true
           CHECK_RETEXT_ANALYSIS: true
+          CHECK_UNUSED_ASSETS: true
           COMMIT_HASH: ${{ github.event.pull_request.head.sha }}
           EVENT_NAME: ${{ github.event_name }}
           POST_PULL_REQUEST_COMMENTS: true

content/en-us/assets/promotion/ads-manager/Ad-Credits.png

@@ -128,15 +128,11 @@ To run a price review period:
     <td>The number of active users during the test period.</td>
   </tr>
   <tr>
-    <td>**Short-term revenue**</td>
-    <td>The amount of Robux spent on tested products during the two-week price optimization test period.</td>
-  </tr>
-  <tr>
-    <td>**Long-term revenue**</td>
+    <td>**Revenue**</td>
     <td>The amount of Robux spent on tested products during the four-week price review period.</td>
   </tr>
   <tr>
-    <td>**Approximate long-term revenue impact**</td>
+    <td>**Approximate revenue impact**</td>
     <td>The projected long-term revenue increase if the optimized prices are applied to the tested products.</td>
   </tr>
   <tr>
@@ -151,5 +147,17 @@ To run a price review period:
     <td>**ARPPU**</td>
     <td>The average revenue per paying user during the price review period.</td>
   </tr>
+  <tr>
+    <td>**Recommended price increase**</td>
+    <td>The number of products for which we recommend increasing the price.</td>
+  </tr>
+  <tr>
+    <td>**Recommended price decrease**</td>
+    <td>The number of products for which we recommend lowering the price.</td>
+  </tr>
+  <tr>
+    <td>**Recommended no change**</td>
+    <td>The number of products for which we recommend keeping the current price.</td>
+  </tr>
 </tbody>
 </table>

content/en-us/production/monetization/price-optimization.md

@@ -40,7 +40,7 @@ Any Roblox user aged 13 and above can convert Robux to ad credit and use it for
 
 You can specify the amount of ad credit you want to purchase. When converting Robux to ad credits, consider the following:
 
-- 1 ad credit is equivalent to 285 Robux.
+- 1 ad credit is equivalent to 263 Robux.
 - 10 ad credits is the minimum conversion requirement.
 
 This minimum conversion requirement streamlines the conversion process, prevents inaccuracies, and makes sure that you have enough ad credits to support meaningful advertising campaigns.

content/en-us/production/promotion/ads-manager.md

@@ -0,0 +1,17 @@
+{
+  "openapi": "3.0.4",
+  "info": {
+    "title": "Roblox.AssetPermissionsApi",
+    "version": "1.0",
+    "x-roblox-extensions-version": "1.0.0"
+  },
+  "paths": {},
+  "components": {
+    "securitySchemes": {}
+  },
+  "servers": [
+    {
+      "url": "https://apis.roblox.com"
+    }
+  ]
+}

content/en-us/reference/cloud/asset-permissions-api/v1.json

@@ -563,6 +563,15 @@
             "description": "The social links associated with the asset.",
             "nullable": true
           },
+          "previewAssets": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/PreviewAssetsModel"
+              }
+            ],
+            "description": "The asset's preview asset ids grouped by asset type.",
+            "nullable": true
+          },
           "createTime": {
             "type": "string",
             "description": "The time the asset was created.",
@@ -1338,6 +1347,32 @@
         "description": "Representation of a plugin asset.",
         "nullable": true
       },
+      "PreviewAssetsModel": {
+        "type": "object",
+        "properties": {
+          "imagePreviewAssets": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "description": "Ordered list of image preview asset ids.",
+            "nullable": true
+          },
+          "videoPreviewAssets": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "description": "Ordered list of video preview asset ids.",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Grouped preview asset ids for an item, separated by media type.",
+        "nullable": true
+      },
       "ProblemDetails": {
         "type": "object",
         "properties": {