> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Adapty

Airbridge supports integration with Adapty. With the integration, you can import subscription-related events to Airbridge and send postbacks to Adapty.

## Integration Setup

To implement the integration, the subscription-related events must be sent from Adapty to Airbridge first. Once Airbridge receives the events from Adapty, the Adapty **API token** will show in your Adapty dashboard which is required to send the attribution data from Airbridge to Adapty.

<Danger>
  **Attention**

  To ensure seamless data integration, the User IDs must be identically logged in both the Airbridge SDK and Adapty. To achieve this, codes to fetch the [Airbridge Device UUID](/en/developers/airbridge-device-id-faq) must be added to the Adapty SDK. For more details, refer to the  [the developer guide](/en/developers/fetching-guide).
</Danger>

### Sending subscription data from Adapty to Airbridge

1. Navigate to **\[Integrations]>\[Third-party Integrations]** and select **Adapty**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-integration-card-list.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=b688893207a70da33038f2254cb39617" alt="01-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-integration-card-list.png" />
</Frame>

2. Find the Airbridge app name and API token. You can copy the values by clicking on them.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-subscription-data-credentials.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=24044df071381d3c7ea958c3ab72cde3" alt="02-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-subscription-data-credentials.png" />
</Frame>

3. Sign in to your [Adapty account](https://app.adapty.io/login).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-sign-in-fields.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=c457f67be886d4756ea0b82aa1664b1e" alt="03-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-sign-in-fields.png" />
</Frame>

4. Go to the **\[Integrations]** menu and select **Airbridge**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-integration-airbridge-card.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=5672b749ff3e581f662c1e1bb19d1f3f" alt="04-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-integration-airbridge-card.png" />
</Frame>

5. Switch on the toggle.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-event-postback-toggle.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=d0d590beabefe23d9f2b835fa1c49aa4" alt="05-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-event-postback-toggle.png" />
</Frame>

6. Paste the Airbridge app name and Airbridge API token into the respective fields.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-required-airbridge-credentials.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=4832826a7536075cfa404ae079b244c9" alt="06-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-required-airbridge-credentials.png" />
</Frame>

You can check the checkboxes for “Report proceeds”, ”Report user’s currency”, “Exclude historical events,” and “Send trial price” to further specify conditions for sending subscription-related events to Airbridge.

<Accordion title="Specify conditions for sending Adapty events to Airbridge">
  The revenue generated from subscription-related events can be viewed in the Airbridge reports by selecting **Subscription Revenue (App)** as a metric.

  | Checkbox                  | Description                                                                                                                                                                                                                                 |
  | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Report proceeds           | If checked, proceed amounts after App Store or Google Play Store fees are reported.                                                                                                                                                         |
  | Report user’s currency    | If checked, the revenue will be reported in the currency of the user’s choice. If not checked, the revenue is reported in USD.                                                                                                              |
  | Exclude historical events | If checked, events that occurred before the Adapty SDK install are excluded from reporting. For example, if the subscription was renewed on the 5th, and the Adapty SDK was installed on the 1st, event data starting from the 5th is sent. |
  | Send trial price          | If checked, the revenue generated from trials will be sent. For free trials, set the trial price percentage to 0%.                                                                                                                          |
</Accordion>

<Danger>
  **Attention**

  Events that occurred before the Adapty SDK was applied to the app or updated are sent to Airbridge with modified event dates by default. The event date is modified to within 24 hours of the event sending time. As a result, the actual event date and the event date displayed on the Airbridge dashboard may differ. To avoid this discrepancy, check the **Exclude historical events** checkbox.
</Danger>

In the “Events names” section, you can select which events to send to Airbridge. There are 3 event groups: Subscriptions, Trials, and Issues. Use the toggles to configure whether to send particular events whenever necessary.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-subscription-event-settings.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=2374bd75bfc8a5c777542c14df5c84f3" alt="07-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-subscription-event-settings.png" />
</Frame>

7. Click **Save** to save the settings.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-integration-save-button.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=9ca530a965592116b0e4a4a353343ef1" alt="08-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-integration-save-button.png" />
</Frame>

### Sending attribution data to Adapty

To proceed with the steps below, the Airbridge App Name and Airbridge API token from your Airbridge dashboard and paste them into your Adapty dashboard. If you have not completed these steps yet, refer to the this **section** of this article.

1. Sign in to your [Adapty dashboard](https://app.adapty.io/login).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/adapty-sign-in-fields.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=c457f67be886d4756ea0b82aa1664b1e" alt="09-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-sign-in-fields.png" />
</Frame>

2. Go to the **\[Integrations]** menu and select **Airbridge**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-integration-airbridge-card.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=5672b749ff3e581f662c1e1bb19d1f3f" alt="10-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-integration-airbridge-card.png" />
</Frame>

3. Copy the **Adapty API token**. If the toggle is switched off, click on it and switch it on.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-api-token-field.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=13e08f04c898d3407bdb3ec5b98dc387" alt="11-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-api-token-field.png" />
</Frame>

4. In your Airbridge dashboard, navigate to **\[Integrations]>\[Third-party Integrations]** and select **Adapty**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-integration-card-list.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=b688893207a70da33038f2254cb39617" alt="12-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-integration-card-list.png" />
</Frame>

5. Paste the Adapty API token into the field and click **Done** to start sending the attribution data to Adapty. Airbridge sends only install events to Adapty. The Adapty API token consists of only letters, numbers, periods (”.”), and underscores (”\_”).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/NnPE_gJFbAXa7mQR/asset/image/adapty-attribution-api-token-field.png?fit=max&auto=format&n=NnPE_gJFbAXa7mQR&q=85&s=6a4bba326aa3c25a19f520234554c1e7" alt="13-en-adapty integration" width="1408" height="808" data-path="asset/image/adapty-attribution-api-token-field.png" />
</Frame>

### Supported features

<AccordionGroup>
  <Accordion title="Integration status tags">
    Refer to the table below to understand the integration status tags. Credentials refer to authentication tokens, report keys, IDs, etc.

    | Status Tag | Description                                                                            |
    | ---------- | -------------------------------------------------------------------------------------- |
    | (No tag)   | No credentials are registered with Airbridge.                                          |
    | Configured | Credentials are registered with Airbridge.                                             |
    | Error      | No data is being received due to the third-party server error or authentication issue. |

    The status tags are visible under the third-party names on the **\[Integrations]>\[Third-party Integration]** page.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/JQTrije-Gw_sKnV9/asset/image/amazon-s3-configured-status.png?fit=max&auto=format&n=JQTrije-Gw_sKnV9&q=85&s=8ab91653aed262a8d0ec989d2302d589" alt="01-en-ThirdPartyaccordion" width="1400" height="800" data-path="asset/image/amazon-s3-configured-status.png" />
    </Frame>

    On the individual integration setup pages, the integration status tag is visible next to the third-party name.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/app-store-connect-configured-status.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=35517a5add8b0c6ceeb265b6e1120c1f" alt="02-en-LevelPlay" width="1400" height="800" data-path="asset/image/app-store-connect-configured-status.png" />
    </Frame>
  </Accordion>

  <Accordion title="Editing credentials">
    Click the **\[pen] icon** to edit the credential information. Click **Done** to save changes.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/app-store-connect-credentials-edit.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=cee29774d8b4e9cbbe19d407b5ab7cda" alt="03-en-LevelPlay" width="1400" height="800" data-path="asset/image/app-store-connect-credentials-edit.png" />
    </Frame>
  </Accordion>

  <Accordion title="Deleting credentials">
    Click **Delete** to delete the credentials. When deleting the credentials, the integration is disabled. Data already pulled into Airbridge or to the third-party solution are not affected and remain in Airbridge or in the third-party solution. To reenable the integration, enter the credentials again.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/app-store-connect-credentials-delete.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=467ae8cb30bc0254048c2c4cef98d271" alt="04-en-LevelPlay" width="1400" height="800" data-path="asset/image/app-store-connect-credentials-delete.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Viewing the Adapty data in Airbridge

With the integration, the Adapty events are available as metric and GroupBy options for creating Airbridge reports. To learn more about the Airbridge events, refer to this [article](/en/guides/airbridge-event-types).

<Accordion title="Event mapping between Adapty and Airbridge">
  | Adapty Event                    | Airbridge Standard Event |
  | ------------------------------- | ------------------------ |
  | trial\_started                  | Start Trial              |
  | trial\_converted                | Subscribe                |
  | subscription\_initial\_purchase | Subscribe                |
  | subscription\_renewed           | Subscribe                |
  | auto\_renew\_off\_subscription  | Unsubscribe              |

  The Adapty events mapped to [Airbridge standard events](/en/guides/airbridge-event#standard-event) cannot be displayed in a different name on the Airbridge dashboard.
</Accordion>

<Note>
  **Adapty events imported as Custom Events**

  When imported to Airbridge, all Adapty events other than the events listed above are displayed in their event names used in Adapty, and are categorized as Airbridge Custom Events. The properties of such events can be found as Custom Attributes.
</Note>

## Attention

<AccordionGroup>
  <Accordion title="Use S2S events for SKAN conversion values">
    To reflect events collected via server-to-server (S2S) in SKAN conversion values, make sure all of the following are met:

    * Your Airbridge iOS SDK is version 4.8.0 or higher. We recommend version 4.8.1 or higher.
    * The `calculateSKAdNetworkByServerEnabled` option is set to `true` in the Airbridge SDK. For details, see the [iOS SDK documentation](/en/developers/ios-sdk-v4#calculating-skadnetwork-conversion-value-on-the-server).
  </Accordion>

  <Accordion title="Data sharing policy of Meta ads">
    Events attributed to Meta ads shall not be sent or shared with third parties in accordance with the Meta Privacy Policy. The data shall only be used internally by the entity that ran the ad for the purpose of analyzing the performance of the Meta ads campaign.

    Accordingly, Airbridge sends the `channel` event property of events attributed to Meta ads as “Restricted” to any third parties.

    However, [Meta ads web campaign data](/en/guides/meta-business-website-conversion) collected through tracking links or campaign data collected through custom channel tracking links are not masked when sent to third parties.
  </Accordion>

  <Accordion title="User ID matching">
    To ensure seamless data integration, the User IDs must be identically logged in both the Airbridge SDK and Adapty. To achieve this, codes to fetch the [Airbridge Device UUID](/en/developers/airbridge-device-id-faq) must be added to the Adapty SDK.

    If Airbridge cannot find a matching User ID in Adapty, it generates a random User ID. This may result in the number of users for subscription-related events displayed in Airbridge being higher than the actual figures.

    For more details, refer to [the developer guide](/en/developers/fetching-guide).
  </Accordion>

  <Accordion title="Event double counting">
    If subscription-related events are being imported to Airbridge from third-party solutions, make sure the Airbridge SDK does not collect subscription-related events to avoid event double counting.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/adapty" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/adapty" />
