> ## 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.

# ironSource

Airbridge supports integration with ironSource. With the integration, you can track and measure the performance of your ironSource campaigns in Airbridge.

## Collecting Data with Tracking Links

Navigate to **\[Integrations]>\[Ad Channel Integration]** in your Airbridge dashboard and select **ironSource**. In the **\[Tracking Link]** tab, you can create and manage tracking links to measure the performance of your ironSource campaigns.

For detailed instructions on creating and managing tracking links in Airbridge, refer to the articles below.

* [Creating Tracking Links](/en/guides/creating-a-new-tracking-link)
* [Tracking Link Management](/en/guides/tracking-link-management)

<Danger>
  **Attention**

  Set up postback before using tracking links. Postback must be set up before data collection to ensure all collected data is sent to the ad channel. If not, data collected through tracking links will not be sent to the ad channel.
</Danger>

## Cost Integration Setup

Airbridge supports cost integration with ironSource. Receive ad spend data from ironSource and analyze campaign performance in Airbridge.

### Get credentials from ironSource

You need the following 3 credentials from the ironSource dashboard.

* Advertiser ID
* Secret Key
* Refresh Token

Follow the steps below to find them. If you have multiple apps to track, request the credentials for each app from ironSource.

1. Log in to the [ironSource dashboard](https://platform.ironsrc.com/partners/dashboard) and click the account icon.
2. In the **\[My Account]** screen, go to the **\[API]** tab. You will find your Advertiser ID, Secret Key, and Refresh Token there.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/WCTn-oGPmrNYnPbt/asset/image/ironsource-api-credentials.png?fit=max&auto=format&n=WCTn-oGPmrNYnPbt&q=85&s=f4266033a9f81acc0cbea1465a2831a5" alt="en-382-ironsource" width="1400" height="800" data-path="asset/image/ironsource-api-credentials.png" />
</Frame>

### Provide the credentials to Airbridge

Follow the steps below to register your ironSource credentials in the Airbridge dashboard.

1. In the Airbridge dashboard, go to **\[Integration]>\[Ad Channel Integration]** and select **ironSource**.
2. Open the **\[Cost Integration]** tab, toggle on **\[ironSource Cost Integration]**, and click **Add an account**.
3. Enter the Advertiser ID, Secret Key, and Refresh Token found in ironSource into the corresponding fields, then click **Done**.
4. The integrated ironSource account will appear in the Airbridge dashboard. For up to 4 hours, the account status will show as “Pending”. Once cost data starts syncing to Airbridge, the status will change to “Success”.

### Integration Management

Refer to the following instructions to edit or delete your integration details.

<AccordionGroup>
  <Accordion title="Pause cost integration">
    Turn off the toggle to pause the integration. Airbridge stops collecting cost data once the integration is paused.

    Any data collected before the pause remains available in Airbridge reports.

    Airbridge retains the credentials of the integrated account, so you can resume the integration at any time by turning the toggle on. However, deleting the integrated account removes these credentials.
  </Accordion>

  <Accordion title="Delete integrated account">
    Select the account from the integrated account list and click **Delete** to remove the account. To re-integrate the account after deletion, set up the integration from the beginning.
  </Accordion>
</AccordionGroup>

### Integration Status

After registering the credentials, you can check if integration is successfully enabled. Even when the account is successfully added, the status may remain “Pending” until Airbridge actually receives the first data.

For more details on the integration status and data import schedule, refer to the below information.

<AccordionGroup>
  <Accordion title="Cost integration status">
    | Status      | Description                                                                                                                                                                               |
    | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Waiting     | Integration set up successfully. Pending data import. This may take up to 4 hours.                                                                                                        |
    | Success     | Import complete. New data received from the ad channel. The **\[Last Updated]** timestamp reflects the latest import.                                                                     |
    | No new data | Import complete, but no new data was available from the ad channel. Check again at the next import.                                                                                       |
    | Failed      | Import failed. Possible causes:<br />· The ad channel API is not responding.<br />· The ad account details are incorrect.<br />· The ad channel permissions are not configured correctly. |
  </Accordion>

  <Accordion title="Cost data import schedule">
    * Frequency: Every 4 hours, 6 times a day, starting at 3:00 PM UTC
    * Import times: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM UTC
    * Data range: Past 7 days, from D-1 to D-7

    **\[Last Updated]** shows the last time Airbridge actually received the data.
  </Accordion>
</AccordionGroup>

### Cost Data in Airbridge Reports

The cost data received from ironSource can be viewed in Airbridge reports using the metrics and GroupBys below.

<AccordionGroup>
  <Accordion title="Metrics for cost data">
    | Metrics               | Description                                          |
    | --------------------- | ---------------------------------------------------- |
    | Clicks (Channel)      | The number of clicks provided by the ad channel      |
    | Impressions (Channel) | The number of impressions provided by the ad channel |
    | Cost (Channel)        | The ad spend provided by the ad channel              |

    <Note>
      **Difference between Clicks and Clicks (Channel)**

      Both **Clicks** and **Clicks (Channel)** show click count, but the data source differs:

      * **Clicks**: Collected through Airbridge tracking links
      * **Clicks (Channel)**: Provided by the ad channel

      Any metric with **(Channel)** in its name represents data provided by the integrated ad channel. The same applies to **Impressions** and **Impressions (Channel)**.
    </Note>
  </Accordion>

  <Accordion title="GroupBys for cost data">
    <Info>
      **Note**

      Use the groupBys below to break down cost data in Airbridge reports. Available groupBys vary by ad channel.
    </Info>

    **Touchpoint**

    | **Name**      | **Description**                                        |
    | ------------- | ------------------------------------------------------ |
    | Channel       | The media source of the winning touchpoint             |
    | Campaign      | The name of the campaign of the winning touchpoint     |
    | Ad Creative   | The name of the ad creative of the winning touchpoint  |
    | Sub Publisher | The second-tier media source of the winning touchpoint |

    **Device**

    | **Name** | **Description**                    |
    | -------- | ---------------------------------- |
    | Country  | The country code of the device     |
    | OS Name  | The operating system of the device |

    **Event Datetime**

    | **Name**               | **Description**                                                        |
    | ---------------------- | ---------------------------------------------------------------------- |
    | Event Date             | The day the event occurred (YYYY-MM-DD)                                |
    | Event Year             | The year the event occurred (YYYY)                                     |
    | Event Month            | The month the event occurred (MM)                                      |
    | Event Week             | The week the event occurred, with the first Thursday’s week as 01 (WW) |
    | Event Day of the month | The day of the month the event occurred (DD)                           |
    | Event Day of the week  | The day of the week the event occurred in three-letter abbreviations   |
  </Accordion>
</AccordionGroup>

## Attribution Rules

In the **\[Attribution Rules]** tab, you can configure the lookback window and attribution window for ironSource. Click **Go to edit page** to move to the **\[Management]>\[Attribution Rules]** page, where you can edit attribution rules. For detailed instructions on configuring the lookback window and attribution window, refer to the article below.

* [Lookback and Attribution Window Setup](/en/guides/setting-attribution-window)

## Postback Settings

In the **\[Postback]** tab, you can configure postbacks and determine which in-app events and attribution results to send as postbacks. The data collected with the Airbridge SDK and tracking links enables you to optimize campaigns and make strategic decisions about budget allocation. For more details on postback settings, refer to the article below.

* [Postback Settings](/en/guides/postback-settings)

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/WCTn-oGPmrNYnPbt/asset/image/ironsource-postback-event-schema.png?fit=max&auto=format&n=WCTn-oGPmrNYnPbt&q=85&s=b9c712ada8ec01ca4881541475ea53ef" alt="ironSource-01" width="1400" height="800" data-path="asset/image/ironsource-postback-event-schema.png" />
</Frame>

## Agency Settings

Manage the access permissions of the agencies and have control over which agency has access to your ironSource campaign data.

* [Agency Settings](/en/guides/agency-setting)

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

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