review pt2

Author: titerman

.gitignore

@@ -23,3 +23,7 @@ yarn-error.log*
 /.idea
 /static/*
 !/static/api/
+
+# VSCode
+
+/.vscode

versioned_docs/version-3.0/adjust.md

@@ -33,7 +33,9 @@ The integration between Adapty and Adjust works in two main ways.
 2. **Adapty sends subscription events to Adjust**  
    Adapty can send all subscription events which are configured in your integration to Adjust. As a result, you'll be able to track these events within the Adjust dashboard. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.
 
-## Initial Setup
+## Web configuration
+
+### Connect Adapty to Adjust
 
 1. Open the Adapty Dashboard, and navigate to [Integrations > Adjust](https://app.adapty.io/integrations/adjust).
 
@@ -83,7 +85,7 @@ The integration between Adapty and Adjust works in two main ways.
 />
 </Zoom>
 
-## Events and tags
+### Set up events and tags
 
 Adjust works a bit differently from other platforms. You need to manually create events in Adjust dashboard, get event tokens, and copy-paste them to appropriate events in Adapty.
 
@@ -125,7 +127,7 @@ Consider the following:
 
 :::
 
-## Attribution Integration
+## SDK configuration
 
 After you complete the steps described above, add the following two methods to your app. They will establish communication between your app and Adjust:
 

versioned_docs/version-3.0/airbridge.md

@@ -20,7 +20,9 @@ The integration between Adapty and Airbridge operates in two main ways.
 2. **Sending subscription events to Airbridge**  
    Adapty can send all subscription events which are configured in your integration to Airbridge. As a result, you'll be able to track these events within the Airbridge dashboard. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.
 
-## Initial Setup
+## Web configuration
+
+### Connect Adapty to Airbridge
 
 To integrate Airbridge go to [Integrations > Airbridge](https://app.adapty.io/integrations/airbridge), turn on a toggle from off to on, and fill out fields.
 
@@ -74,11 +76,7 @@ Adapty API token field is pre-generated on the Adapty backend. You will need to
 />
 </Zoom>
 
-
-
-
-
-## Events and tags
+### Set up events and tags
 
 Below the credentials, there are three groups of events you can send to Airbridge from Adapty
 
@@ -167,7 +165,7 @@ try {
 Read more about airbridgeDeviceId in [Airbridge documentation.](https://developers.airbridge.io/v1.1-en/docs/airbridge-device-id)
 
 
-## Attribution Integration
+## SDK configuration
 
 Airbridge does not send real-time attribution data to Adapty. As such, there's no need to request attribution data from Airbridge in your application code. 
 

versioned_docs/version-3.0/apple-search-ads.md

@@ -14,12 +14,10 @@ The Apple Ads integration in **App settings** is used only for basic analytics a
 [Apple Ads Manager](adapty-ads-manager.md) uses a separate connection. Connect your Apple Ads account in the [Apple Ads Manager settings](adapty-ads-manager-get-started.md).
 :::
 
-
 Adapty can help you get attribution data from Apple Ads and analyze your metrics with campaign and keyword segmentation. Adapty collects the attribution data for Apple Ads automatically through its SDK and AdServices Framework.
 
 Once you've set up the Apple Ads integration, Adapty will start receiving attribution data from Apple Ads. You can easily access and view this data on the profiles page.
 
-
 <Zoom>
   <img src={require('./img/ba4a3e9-CleanShot_2023-08-21_at_15.14.592x.webp').default}
   style={{
@@ -39,7 +37,7 @@ Apple Ads via [AdServices](https://developer.apple.com/documentation/ad_services
 
 Add `AdaptyAppleSearchAdsAttributionCollectionEnabled` to the app’s `Info.plist` file and set it to `YES` (boolean value).
 
-### Step 2: Obtain Public Key
+### Step 2: Obtain public key
 
 In the Adapty Dashboard, navigate to [Settings -> Apple Ads.](https://app.adapty.io/settings/apple-search-ads)  
 Locate the pre-generated public key (Adapty provides a key pair for you) and copy it.
@@ -59,7 +57,7 @@ Locate the pre-generated public key (Adapty provides a key pair for you) and cop
 If you're using an alternative service or your own solution for Apple Ads attribution, you can upload your own private key.
 :::
 
-### Step 3: Configure User Management on Apple Ads
+### Step 3: Configure user management on Apple Ads
 
 In your [Apple Ads account](https://searchads.apple.com/) go to **Settings > User Management** page. In order for Adapty to fetch attribution data you need to invite another Apple ID account and grant it API Account Manager access. You can use any account you have access to or create a new one just for this purpose. The important thing is that you must be able to log into Apple Ads using this Apple ID.
 
@@ -74,11 +72,11 @@ In your [Apple Ads account](https://searchads.apple.com/) go to **Settings > Use
 />
 </Zoom>
 
-### Step 4: Generate API Credentials
+### Step 4: Generate API credentials
 
 As a next step, log in to the newly added account in Apple Ads. Navigate to Settings -> API in the Apple Ads interface. Paste the previously copied public key into the designated field. Generate new API credentials.
 
-### Step 5: Configure Adapty with Apple Ads Credentials
+### Step 5: Configure Adapty with Apple Ads credentials
 
 Copy the Client ID, Team ID, and Key ID fields from the Apple Ads settings. In the Adapty Dashboard, paste these credentials into the corresponding fields.
 
@@ -93,17 +91,15 @@ Copy the Client ID, Team ID, and Key ID fields from the Apple Ads settings. In t
 />
 </Zoom>
 
-## Attribution Integration
+## SDK configuration
 
-### Enable Attribution Integration 
+Once you complete [the AdServices framework setup](#connect-the-adservices-framework), Adapty automatically starts collecting Apple Search Ad attribution data. You don't need to add any SDK code.
 
-Adapty automatically collects Apple Search Ad attribution data. As such, you don't need to request it in application code. If you followed the steps to [Connect the AdServices Framework](#connect-the-adservices-framework), Adapty has already begun collecting attribution data.
+For iOS applications, this attribution data will **always** take priority over data from other sources. If this behaviour is unwanted, *disable* ASA attribution with the instructions below.
 
-### Disable Attribution Integration
+## Disable integration
 
-Adapty can only store attribution data from one source at a time. If you enable multiple attribution sources, the system gives preference to the service that shares the most information. For iOS devices, this service is Apple Search Ads.
-
-**Once you set the attribution value, you cannot override it.** To turn Apple Search Ads attribution off, open the [**App Settings** -> **Apple Search Ads** tab](https://app.adapty.io/settings/apple-search-ads), and toggle the **Receive Apple Search Ads attribution** switch.
+To turn Apple Search Ads attribution off, open the [**App Settings** -> **Apple Search Ads** tab](https://app.adapty.io/settings/apple-search-ads), and toggle the **Receive Apple Search Ads attribution** switch.
 
 <Zoom>
   <img src={require('./img/asa-disable.webp').default}
@@ -153,4 +149,3 @@ openssl ec -in private-key.pem -pubout -out public-key.pem
 ```
 
 You can use this public key in your Apple Ads settings of account with API Account Manager role. So you can use generated Client ID, Team ID, and Key ID values for Adapty and other services.
-

versioned_docs/version-3.0/appsflyer.md

@@ -33,7 +33,7 @@ The integration between Adapty and AppsFlyer operates in two main ways.
 2. **Sending subscription events to AppsFlyer**  
    Adapty can send all subscription events that are configured in your integration to AppsFlyer. As a result, you'll be able to track these events within the AppsFlyer dashboard. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.
 
-## Initial Setup
+## Web configuration
 
 To setup the integration with AppsFlyer:
 
@@ -181,7 +181,7 @@ We recommend using the default event names provided by Adapty. But you can chang
 
 Adapty will send subscription events to AppsFlyer using a server-to-server integration, allowing you to view all subscription events in your AppsFlyer dashboard and link them to your acquisition campaigns.
 
-## Attribution Integration
+## SDK configuration
 
 After you complete the steps described above, call the `updateAttribution` method to save the attribution data, and use the `Adapty.setIntegrationIdentifier()` to set the integration identifier. 
 

versioned_docs/version-3.0/asapty.md

@@ -11,7 +11,7 @@ Using [Asapty](https://asapty.com/) integration you can optimize your Search Ads
 
 This specific integration doesn't add any attribution data to Adapty, as we already have everything we need from [ASA](apple-search-ads) directly.
 
-## Initial Setup
+## Web configuration
 
 To integrate Asapty navigate to [Integrations > Asapty](https://app.adapty.io/integrations/asapty) in the Adapty dashboard and fill out the field value for Asapty ID.
 
@@ -45,7 +45,7 @@ Below the credentials, there are three groups of events you can send to Asapty f
 
 We recommend using the default event names provided by Asapty. But you can change the event names based on your needs.
 
-## Attribution Integration
+## SDK configuration
 
 Once you complete the steps outlined above, Adapty automatically receives attribution data from Asapty. There's no need to explicitly request attribution data in your application code. For better attribution data accuracy, configure Asapty to share the `customerUserId` with each event's data.
 

versioned_docs/version-3.0/attribution-integration.md

@@ -21,7 +21,6 @@ Integrate Adapty with an attribution data provider to:
 
 Adapty supports a [simplified integration process](#simplified-attribution-process) for 9 popular platforms. You can integrate any other platform with a [manual attribution](#manual-attribution) process.
 
-
 ## Simplified attribution process
 
 Adapty offers out-of-the-box attribution integration with [9 popular services](#platform-specific-guides). These platforms can automatically receive [subscription data](events) from Adapty, process each purchase, and respond with an appropriate attribution.
@@ -102,7 +101,6 @@ If your attribution source does not suppport the [simplified attribution workflo
 
     - `attribution` (required): dictionary with attribution data.
     - `source` (required): attribution source. Set to `.custom` if your attribution provider does not support the [simplified attribution process](#simplified-attribution-process).
-    - `networkUserID` (optional): a string with the profile ID from the attribution service.
 
 5. **Disable other event sharing services and attribution sources** to avoid [event duplication](#avoid-event-duplication) and [data conflicts](#select-a-single-attribution-source).
 
@@ -122,6 +120,6 @@ If you use Adapty to share real-time subscription data with your attribution ser
 
 Duplicate events can skew your analytics, and make it hard to interpret data. Once you configured Adapty event sharing, turn third-party event forwarding capabilities **off**.  
 
-### What's Next
+### What's next?
 
-Enable [User Acquisition Analytics](user-acquisition.md) to learn more about your application economy. Dive deeper into the complicated relationship between ad spend and subscription revenue.
+Enable [User Acquisition Analytics](user-acquisition) to learn more about your application economy. Dive deeper into the complicated relationship between ad spend and subscription revenue.

versioned_docs/version-3.0/branch.md

@@ -37,7 +37,7 @@ The integration between Adapty and Branch operates in two main ways.
 2. **Sending subscription events to Branch**  
    Adapty can send all subscription events which are configured in your integration to Branch. As a result, you'll be able to track these events within the Branch dashboard. 
 
-## Initial Setup
+## Web configuration
 
 To integrate Branch go to [Integrations > Branch](https://app.adapty.io/integrations/branch) in Adapty Dashboard , turn on a toggle from off to on, and fill out fields.
 
@@ -101,7 +101,7 @@ We recommend using the default event names provided by Adapty. But you can chang
 
 Adapty will send subscription events to Branch using a server-to-server integration, allowing you to view all subscription events in your Branch dashboard and link them to your acquisition campaigns. 
 
-## Attribution Integration
+## SDK configuration
 
 1. Call the `.setIntegrationIdentifier()` SDK method to initialize the connection. You can pass your Branch Identity ID to the `customerUserId` parameter.
 

versioned_docs/version-3.0/facebook-ads.md

@@ -16,7 +16,7 @@ With the Facebook Ads integration, you can easily check your app stats in Meta A
 
 The integration between Adapty and Facebook Ads operates in the following way: Adapty sends all subscription events that are configured in your integration to Facebook Ads. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.
 
-## Initial Setup
+## Web configuration
 
 To integrate Facebook Ads and analyze your app metrics, you can set up the integration with Meta Analytics. By sending events to Meta Ads Manager, you can create lookalike audiences based on subscription events like renewals. To configure this integration, navigate to [Integrations > Facebook Ads](https://app.adapty.io/integrations/facebookanalytics) in the Adapty Dashboard and provide the required credentials.
 
@@ -113,7 +113,7 @@ StartTrial, Subscribe, CancelSubscription are standard events.
 
 To enable specific events, simply toggle on the ones you require. In case multiple event names are selected, Adapty will consolidate the data from all the chosen events into a single Adapty event name.
 
-## Attribution Integration
+## SDK configuration
 
 If you follow the steps above, Facebook will automatically receive subscription data from Adapty. 
 

versioned_docs/version-3.0/singular.md

@@ -13,7 +13,7 @@ Adapty provides a complete set of data that lets you track [subscription events]
 
 Adapty can send all subscription events which are configured in your integration to Singular. As a result, you'll be able to track these events within the Singular dashboard. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.
 
-## Initial Setup
+## Web configuration
 
 To set up the integration with Singular, go to [Integrations > Singular](https://app.adapty.io/integrations/singular) in your Adapty Dashboard, turn on a toggle, and fill out the fields.