merge main

Author: titerman

TECH_WRITERS_README.md

@@ -288,6 +288,12 @@ This is a danger callout with red styling.
 :::important
 This is an important callout (styled as warning).
 :::
+
+:::link
+This callout is designed to contain a link: [Main article](main-article)
+
+It works best with single-line content because it's vertically centered against the book icon on the left.
+:::
 ```
 
 ### Links

src/assets/store-review/clear-description-policy.webp

@@ -25,7 +25,7 @@ const styles = {
   },
   link: {
     className: "callout-info singleLineCallout",
-    icon: "M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"
+    icon: "M12 6.042A8.967 8.967 0 0 0 6 3.75c-1.052 0-2.062.18-3 .512v14.25A8.987 8.987 0 0 1 6 18c2.305 0 4.408.867 6 2.292m0-14.25a8.966 8.966 0 0 1 6-2.292c1.052 0 2.062.18 3 .512v14.25A8.987 8.987 0 0 0 18 18a8.967 8.967 0 0 0-6 2.292m0-14.25v14.25"
   }
 };
 

src/assets/store-review/manipulative-patterns-policy.webp

@@ -7,20 +7,23 @@ rank: 100
 ---
 
 import ZoomImage from '@site/src/components/ZoomImage.astro';
-import InlineTooltip from '@site/src/components/InlineTooltip.astro';
 
-Adapty Analytics are a powerful suite of tools for data visualization and analysis. You can use the data to gain valuable insights into your user base, make data-driven decisions, and optimize your app's performance.
+Adapty Analytics is a powerful suite of tools for data visualization and analysis. Built for application development teams, it focuses on your app's financial performance and user behavior.
+
+In addition to standard metrics available in your store analytics (such as revenue or installations), Adapty calculates compound metrics: user lifetime value, cohort analysis, and more. Dedicated sections analyze user behavior that leads to revenue loss: retention graphs, billing issue resolution data. Browse the charts to gain insight into user behavior, and optimize your application with data-driven decisions.
+
+Read the [How Adapty Analytics Works](how-adapty-analytics-works) guide to learn more about how data is sourced and processed.
 
 :::tip
-Read the [How Adapty Analytics Works](how-adapty-analytics-works) guide to learn more about data sources and processing.
+Enable [Adapty User Acquisition](adapty-user-acquisition) to upgrade the analytics capabilities of Adapty. UA uses marketing data to analyze the relationship between ad campaigns and user behavior. Its charts display a complete picture of your application's economy, with ROI calculations and precise attribution data.
 :::
 
 ## Overview
 :::link
 Main article: [Analytics Overview page](overview)
 :::
 
-The Overview page presents an at-a-glance summary of your applications' key performance metrics. You can click the "Edit Metrics" button to customize which charts the page displays.
+The Overview page presents an at-a-glance summary of your applications' key performance metrics. To customize the displayed charts, click **Edit Metrics**.
 
 <ZoomImage id="analytics/overview.webp" width="700px" alt="Analytics Overview page" />
 
@@ -29,7 +32,7 @@ The Overview page presents an at-a-glance summary of your applications' key perf
 Main article: [Analytics Charts](charts)
 :::
 
-The Charts tab includes 23 different charts for metrics related to revenue, subscriptions, trials, and billing issues.
+The Charts tab visualizes metrics related to revenue, subscriptions, trials, and billing issues.
 
 <ZoomImage id="analytics/charts.webp" width="700px" alt="Analytics Charts page" />
 
@@ -47,7 +50,7 @@ The LTV tab displays a graph of your users' lifetime value over time.
 Main article: [Cohort Analysis](analytics-cohorts)
 :::
 
-The Cohorts tab allows you to split users into groups based on installation date, and analyze their conversion rates.
+The Cohorts tab allows you to isolate user groups based on installation date, and displays each group's conversion rates.
 
 <ZoomImage id="analytics/cohorts.webp" width="700px" alt="Analytics Cohorts page" />
 
@@ -65,7 +68,7 @@ The Funnels tab visualizes the stages of user engagement with your app. You can
 Main article: [Retention](retention)
 :::
 
-The Retention tab displays user retention over time in a graph format.
+The Retention tab shows a graph of user retention over time.
 
 <ZoomImage id="analytics/retention.webp" width="700px" alt="Analytics Retention page" />
 
@@ -83,16 +86,17 @@ The Conversion tab displays graphs for conversion rates at different stages of t
 Main article: [Predicted LTV and Revenue](predicted-ltv-and-revenue)
 :::
 
-Pro+ and Enterprise plan users can access cohort LTV (lifetime value) and revenue predictions. Adapty leverages historical data and advanced machine learning algorithms to predict these metrics' values.
+Users of paid tiers can view predictions for cohort LTV (lifetime value) and revenue. Adapty analyzes historical data with advanced machine learning algorithms to estimate future values.
 
 <ZoomImage id="analytics/cohorts-predictions.webp" width="700px" alt="Cohort Predictions" />
 
-## Common filtering capabilities
+## Filters and grouping controls
+
 :::link
 Main article: [Controls](controls-filters-grouping-compare-proceeds)
 :::
 
-You can use filters and grouping controls to view data pertaining to a specific subsection of users. For example, you can filter the retention graph by store and compare user behavior between Android and iOS.
+Use filters and grouping controls to view data for specific user segments. For example, you can filter the retention graph by store and compare user behavior between Android and iOS.
 
 <ZoomImage id="analytics/controls.webp" width="700px" alt="Analytics Controls" />
 
@@ -113,10 +117,8 @@ Adapty can send automated reports with analytics data straight to your email inb
 
 <ZoomImage id="analytics/ebe22ac-email_reports_apps.webp" width="700px" alt="Reports Settings" />
 
+## See also
 
-## Aggregate your data in User Acquisition
-:::link
-Main article: [User Acquisition](adapty-user-acquisition)
-:::
-
-Enable **Adapty User Acquisition** to leverage data from third-party marketing platforms, and expand Adapty's analytics capabilities. The User Acquisition view allows you to explore the relationship between ad campaigns and user behavior.
+* [Adapty User Acquisition](adapty-user-acquisition)
+* [Exporting analytics with API](export-analytics-api)
+* [Third-party integrations](configuration)

src/components/Callout.astro

@@ -1,6 +1,6 @@
 ---
 title: "Troubleshoot data discrepancies"
-description: "Find the cause of divergencies in data"
+description: "Find the cause of divergences in data"
 metadataTitle: "Troubleshoot data discrepancies | Adapty Docs"
 keywords: ['discrepancies', 'data', 'analytics', 'troubleshooting']
 ---
@@ -13,35 +13,47 @@ Adapty users may encounter **discrepancies** when comparing similar sets of data
     * Adapty charts to third-party charts
     * Different charts within Adapty
 
-Most of the time, discrepancies occur because **different sources process the same data differently**. Other times, they indicate an **issue with your Adapty configuration**.
+## Troubleshooting algorithm
 
-This article explains common issues that lead to data discrepancies, as well as common solutions.
+Most discrepancies between Adapty and other platforms are expected and normal. They occur because **different sources process the same data differently**. 
 
-## Missing data
+Other times, they indicate an **issue with your Adapty configuration**.
+
+If you suspect that your data varies from platform to platform, the best course of action is to [export raw data](export-analytics-api-requests) and **compare the files**.
 
-### Server notifications and RTDN
+* Even stores can experience issues related to data processing and presentation. Access the stores' **raw transaction data** for the most accurate comparison.
+* When comparing Adapty to another analytics platform, use store transaction reports as the source of truth and point of comparison.
+* It's easier to identify inconsistencies with a limited data set. Compare small volumes of data — focus on a specific product and a single day.
+* Identify whether your discrepancy stems from a difference in **pricing** or **event number**. Pricing issues can be fixed with a [product update](#product-pricing). Event issues may indicate [server-side problems](#issues-with-server-notifications-and-rtdn).
+* View the [event feed](event-feed) to monitor incoming events — you may notice unexpected behavior.
 
-If you didn't correctly configure server-to-server communication between Adapty and the stores, Adapty will not be able to process some events, such as subscription renewals.
+After you identify where the data diverges, you can look into the following common causes:
 
-Complete the configuration as soon as you can ([App Store](app-store-server-notifications) | [Play Store](real-time-developer-notifications-rtdn)) and [wait](#data-delays) for the stores to establish the connection.
+## Issues with server notifications and RTDN
+
+Adapty does not receive the necessary event data if you didn't correctly configure the store connections. This particularly affects events that occur without direct user involvement — subscription renewals, billing issues, etc. 
+
+Complete the server-to-server configuration as soon as you can ([App Store](app-store-server-notifications) | [Play Store](real-time-developer-notifications-rtdn)) and [wait](#data-delays) for the stores to establish the connection.
 
 You can [manually upload](importing-historical-data-to-adapty) the missing App Store Connect data to Adapty.
 
+## Missing data
+
 ### Users with out-of-date app versions
 
-If a part of your install base uses an older version of the application without the Adapty SDK, Adapty won't be able to receive their data. For this reason the numbers of Adapty and other sources will diverge.
+If some of your users run an older version of your app without the Adapty SDK, Adapty does not receive their data. For this reason the numbers of Adapty and other sources will diverge.
 
 ### Integration issues 
 
 Some Adapty integrations (for example, Adjust or AppsFlyer) require additional application code to work. If you configure the Adapty dashboard, but do not update your application, the necessary data won't show up in Adapty.
 
 ### Missing historical data
 
-Adapty doesn't have access to your application's historical data, unless you [manually import](importing-historical-data-to-adapty) it. If the chart's [time range](controls-filters-grouping-compare-proceeds#time-ranges) starts before you integrated Adapty into your application, and you haven't imported historical data, the values displayed will differ from other sources.
+Adapty doesn't have access to your application's historical data, unless you [manually import](importing-historical-data-to-adapty) it. If a chart's [time range](controls-filters-grouping-compare-proceeds#time-ranges) starts before you integrated Adapty, and you didn't import historical data, its values will differ from other sources.
 
 ## Data delays
 
-Adapty aims to provide a close to real-time analysis of your application's economy. The following limitations and exceptions apply:
+Adapty aims to provide near real-time analysis of your application's economy. The following limitations and exceptions apply:
 
 * When you first integrate Adapty, the data may not appear immediately.
 * When you enable an integration with a third-party platform, there may be a delay before the data is fully synchronized.
@@ -107,11 +119,7 @@ To ensure accurate reporting, Adapty [may infer](controls-filters-grouping-compa
 
 If you need to clearly distinguish between the two, you can [create a new user segment](segments) with the `Country by store account` attribute, and [filter analytics by segment](controls-filters-grouping-compare-proceeds#filtering-and-grouping).
 
-## Product editing
-
-Incorrect or inconsistent product data may cause discrepancies in analytics. Do not edit the **access level** or the **store product ID** unless you accidentally make a typo in one or the other. Create a new product instead.
-
-### Product pricing
+## Product pricing
 
 If incorrect product pricing causes a revenue discrepancy, changing the price doesn't fix it retroactively. To change existing transactions' prices, you need to forcibly override them by importing correct data.
 
@@ -125,30 +133,21 @@ If your setup includes multiple attribution providers that disagree with one ano
 
 ## Differences in terminology
 
-Different platforms may have different names for the same concept. Metrics related to [revenue](#revenue-fees-and-taxes) vary in name from platform to platform:
+Different platforms may have different names for the same concept. Metrics related to [revenue](#fees-and-taxes) vary in name from platform to platform:
 
-| Metric | Adapty | App Store Connect | Google Play Console |
-|---------|--------|-------------------|----------------------|
-| **Total user spending** | Gross revenue | Sales | Gross Revenue |
-| **Revenue after store commission** | Proceeds after store commission | N/A | N/A |
-| **Revenue after store commission and tax** | Proceeds after store commission and taxes | Proceeds | Earnings |
-| **Average revenue per paying user** | ARPPU | Proceeds per paying user | ARPPU |
+| Adapty | App Store Connect | Google Play Console |
+|--------|-------------------|----------------------|
+| **Gross revenue** | Sales | Gross Revenue |
+| **Proceeds after store commission** | N/A | N/A |
+| **Proceeds after store commission and taxes** | Proceeds | Earnings |
+| **ARPPU** | Proceeds per paying user | ARPPU |
 
-Other metrics may be similar in name, but different in definition. 
+Other metrics may differ in definition, as well:
 
 - **Subscriptions**: 
-        - Adapty only registers a [new subscription](reactivated-subscriptions) **after** the end of a free trial.
+        - Adapty does not count new trials as subscriptions. A [new subscription](reactivated-subscriptions) always starts with a financial transaction.
         - Other platforms, such as Google Play Console, may count **each trial as a new subscription**, even before the first payment was made.
 - **Retention**: 
         - Adapty measures retention based on the number of subscription renewals. 
         - App Store Connect considers a user retained if they open the application on the specified day. A user without a subscription will count, but the subscribed user who didn't open the app on that day won't.
-        - Google Play Console's "Retained Installers" metric measures retention based on the number of days the application remains installed on the user's device. Users that don't open the application count towards this metric.
-
-## General troubleshooting algorithm
-
-If you suspect that your data varies from platform to platform, and the reasons above don't explain the discrepancies, the best course of action is to **export raw data** and **compare the files**.
-
-* Even stores can experience issues related to data processing and presentation. Access the stores' **raw transaction data** for the most accurate comparison.
-* When comparing Adapty to another analytics platform, use store transaction reports as the source of truth and point of comparison.
-* It's easier to identify inconsistencies with a limited data set. Compare small volumes of data — focus on a specific product and a single day.
-* Identify whether your discrepancy stems from a difference in **pricing** or **event number**. Pricing issues can be fixed with a [product update](#product-pricing). Event issues may indicate [server-side problems](#connection-issues).
+        - Google Play Console's "Retained Installers" metric measures retention based on the number of days the application remains installed on the user's device. Users that don't open the application count towards this metric.