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

# RTB House

<Info>
  **Note**

  Depending on the app role assigned, Airbridge users can access the integration features as follows:

  * Access to all features: Owner and In-house Marketer users
  * Limited access depending on the access level granted: Agency and Media Partner users
</Info>

Airbridge supports RTB House integration, including cost data integration and agency settings features. With the integration, Owner and  In-house Marketer users and Agency users who are granted access can track and measure the performance of RTB House campaigns in Airbridge.

## **Collecting Data with Tracking Links**

Navigate to **\[Integrations]>\[Ad Channel Integration]** in your Airbridge dashboard and select **RTB House**. In the **\[Tracking Link]** tab, you can create and manage tracking links to measure the performance of your RTB House 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>

## **Attribution rules**

In the **\[Attribution Rules]** tab, you can configure the lookback window and attribution window for RTB House. Click **Go to edit page** to move to the **\[Management]>\[Attribution Rules]** page, where you can edit attribution rules.

Refer to this [article](/en/guides/setting-attribution-window) for detailed instructions on configuring the lookback window and attribution window.

## **Cost Integration Setup**

Follow the steps below to enable cost integration with RTB House.

### Get RTB House account information

To enable cost integration with RTB House, find the following account information and submit it to Airbridge.

* Username for RTB House login
* Password for RTB House login

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-login-form.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=113c3a2604133ed565d02b3517cc1dc0" alt="01-en-rtbhouse" width="1400" height="765" data-path="asset/image/rtb-house-login-form.png" />
</Frame>

### Submit account information to Airbridge

1. Navigate to **\[Integrations]>\[Ad Channel Integration]** in your Airbridge dashboard. Select **RTB House**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-channel-card-highlighted.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=72396618dcb29ea0d58038902ff09746" alt="02-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-channel-card-highlighted.png" />
</Frame>

2. Select the **\[Cost Integration]** tab. Switch on the **RTB House Cost Integration** toggle and click **Add an account.**

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-cost-integration-settings.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=6b7e04ea35be3538f8f2e8a87733f1ad" alt="03-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-cost-integration-settings.png" />
</Frame>

3. Enter the username and password of the [RTB House](https://panel.rtbhouse.com/) account you want to connect with Airbridge and click **Done**. The username is in the email address format.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-account-credentials-form.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=55a419c86c8c13c8af45e4e6948523ce" alt="04-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-account-credentials-form.png" />
</Frame>

4. Select all campaigns you want to connect with Airbridge. Each campaign is assigned a unique hash.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-account-campaign-selector.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=2bc980e63ba2593b9fa7051214507e05" alt="05-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-account-campaign-selector.png" />
</Frame>

5. When the popup window closes, the account connected to Airbridge will appear in the integrated account list. The status will show “Waiting” for up to 4 hours from the time the account is added and will change to “Success” when data is pulled for the first time.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-cost-status-waiting.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=efc19dd7e70332eb946f9e7cc70a009e" alt="06-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-cost-status-waiting.png" />
</Frame>

### Integration management

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

  <Accordion title="Reenabling connection when data import fails">
    The cost data import fails when there is a change in the connection information. Below are some of the main causes of failures when importing cost data.

    * The permission level granted to the RTB House account has been changed.
    * The hash assigned to the RTB House campaign has been changed.
    * The password of the RTB House account has been changed.

    In the above cases, remove the ad account and add the ad account again to reenable the connection.

    <Note>
      **Hash update**

      RTB House assigns a unique hash to each campaign. Airbridge uses the hash to pull the cost data into Airbridge. In rare cases, Airbridge is unable to pull cost data because the hash assigned to the RTB House campaign has been changed. In such cases, remove the ad account and add the ad account again to reenable the connection. If the problem persists, contact RTB House.
    </Note>
  </Accordion>
</AccordionGroup>

### Integration status

Upon submitting your ad account information to Airbridge, you can check if the integration is running. The status may show “Waiting” even when the account is successfully added if no data has been pulled yet.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-cost-status-table.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=d88efaa2ae6249427036c400d73bf7f9" alt="07-en-rtbhouse" width="1400" height="800" data-path="asset/image/rtb-house-cost-status-table.png" />
</Frame>

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

<AccordionGroup>
  <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: Current day (D-0) to 6 days ago (D-6)

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

  <Accordion title="Cost integration status">
    The integration status shows your cost integration and data update status at a glance.

    | Status  | Description                                                                                                                                                                                             |
    | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Waiting | The ad account has been successfully added, but no data has been pulled yet. This status may remain for up to 4 hours.                                                                                  |
    | Success | The data is being pulled and updated regularly. The last update time is displayed.                                                                                                                      |
    | No data | No data has been pulled as the campaign has not been run for the past 7 days.                                                                                                                           |
    | Failed  | API is not responding, or the connection information has been changed. Try reenabling the connection by referring to this  [section](/en/guides/rtbhouse#reenabling-connection-when-data-import-fails). |
  </Accordion>
</AccordionGroup>

### C**ost data in Airbridge Reports**

The cost data pulled from RTB House can be viewed in the Actuals Report 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">
    ###### Touchpoint

    | <span style={{ display: 'inline-block', minWidth: '200px' }}>GroupBy</span> | Description                                        |
    | --------------------------------------------------------------------------- | -------------------------------------------------- |
    | Channel                                                                     | The media source of the winning touchpoint         |
    | Campaign                                                                    | The name of the campaign of the winning touchpoint |

    ###### Device

    | <span style={{ display: 'inline-block', minWidth: '200px' }}>GroupBy</span> | Description                            |
    | --------------------------------------------------------------------------- | -------------------------------------- |
    | Country                                                                     | The country code for the mobile device |

    ###### Event Datetime

    | <span style={{ display: 'inline-block', minWidth: '200px' }}>GroupBy</span> | Description                             |
    | --------------------------------------------------------------------------- | --------------------------------------- |
    | Event Date                                                                  | The day the event occurred (YYYY-MM-DD) |

    <Note>
      **Ad group and ad creative of RTB House campaigns**

      The ad group and ad creative of RTB House campaigns can’t be viewed in Airbridge due to the following reasons.

      * The ad group data is not provided by RTB House.
      * The ad creative is provided by RTB House in hash only.
    </Note>
  </Accordion>
</AccordionGroup>

## **Agency Settings**

1. Navigate to **\[Integrations]>\[Ad Channel integration]** in your Airbridge dashboard. Select “RTB House.”

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-channel-card-highlighted.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=72396618dcb29ea0d58038902ff09746" alt="rtb en 01 agency" width="1400" height="800" data-path="asset/image/rtb-house-channel-card-highlighted.png" />
</Frame>

2. Select the **\[Agency Settings]** tab and click the **+ Add an agency**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-agency-add-button.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=60dc2ae6efe9a73094516095a8316289" alt="rtb en 02 agency" width="1400" height="800" data-path="asset/image/rtb-house-agency-add-button.png" />
</Frame>

3. Select the agency you want to add from the agency list. Agencies already added are not displayed in the list.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-add-agency-modal.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=1e2710da930efc6ea47a30e40a914fc8" alt="rtb en 03 agency" width="1400" height="800" data-path="asset/image/rtb-house-add-agency-modal.png" />
</Frame>

4. Configure the campaign name rule. The agency role account users can view the campaign data given access based on the campaign name rules.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-campaign-rule-menu.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=53b99f1d92644d72b7e571115a1bb95e" alt="rtb en 04 agency" width="1400" height="800" data-path="asset/image/rtb-house-campaign-rule-menu.png" />
</Frame>

The campaign name rule can be configured by selecting “starts with” or “ends with” and selecting an agency tag. You can also enter the agency tag using less than 50 characters, which can be a combination of letters in mixed case, numbers, and hyphens. More than one campaign name rule can be configured. When you are done, click **Save**.

5. From the agency list, you can see which agency is given access to which campaign data from RTB House.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-agency-list.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=7891b039629d56d444ee527d01cb2134" alt="rtb en 05 agency" width="1400" height="800" data-path="asset/image/rtb-house-agency-list.png" />
</Frame>

### Permission granted to agencies

Agency role account users who belong to the agencies added to the agency list are granted permission to the following.

* Access to the campaign data based on the campaign name rules
* Access to the cost data pulled from the account added by the Agency role account user from the same Agency
* Manage the accounts added by the Agency role account user from the same Agency for cost integration

<Info>
  **Note**

  Even though the agency has been granted access to a specific channel data, the Agency users cannot edit the integration toggle, the event mapping table, or view the edit history.

  If you are an Agency user and need to do the above, ask the Admin or Manager for help.
</Info>

### How to manage the agency list

To edit the campaign name rule for an agency or delete an agency from the list, click the **\[…]** icon. If you have deleted an agency and want to add that agency again, repeat the steps to add an agency from the start.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-agency-actions-menu.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=75e06fa838dcdf5233db621c48a0cc69" alt="rtb en 06 agency" width="1400" height="800" data-path="asset/image/rtb-house-agency-actions-menu.png" />
</Frame>

## **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, read this [article](/en/guides/postback-settings).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/JPv1GYiGChMey0Bl/asset/image/rtb-house-postback-settings.png?fit=max&auto=format&n=JPv1GYiGChMey0Bl&q=85&s=930ed39a4368f962441cc0301039d202" alt="08-en-rtbhouse" width="1471" height="800" data-path="asset/image/rtb-house-postback-settings.png" />
</Frame>

## Attention

Read the following information before enabling cost integration with RTB House.

<AccordionGroup>
  <Accordion title="Discrepancy in cost data">
    Airbridge pulls the cost data from the past 7 days, every 4 hours, 6 times a day starting at 3:00 PM (UTC). As the updates are not real-time, there may be data discrepancies between Airbridge and the ad channel, depending on the time of reporting.
  </Accordion>

  <Accordion title="GroupBys for the Cost (Channel) metric">
    The **Cost (Channel)** metric, which shows your ad spend reported by the ad channel, displays value only when used with specific GroupBys.

    Below are the GroupBys that can be used in the Actuals Report to view data with the metric:

    * Channel
    * Campaign

    Depending on the data reported, the metric may not display any value even if you use the GroupBys above.
  </Accordion>

  <Accordion title="App time zone and currency settings">
    The data pulled via cost integration is provided by the app time zone and app standard currency set within Airbridge.

    To minimize data discrepancy, align your app’s currency and time zone settings in your Airbridge dashboard and your ad channel’s dashboard.

    * [App Time Zone Setup](/en/guides/set-app-timezone)
    * [App Standard Currency Setup](/en/guides/set-app-standard-currency)
  </Accordion>

  <Accordion title="Campaign details advised not to be edited">
    Once the cost integration is enabled, the following campaign details are advised not to be edited to avoid any error in pulling data into Airbridge.

    * Campaign name
  </Accordion>

  <Accordion title="Difference in terms">
    The table below illustrates how Airbridge and [RTB House](https://panel.rtbhouse.com/api/docs) use the terms "account" and "campaign" for different purposes.

    |                        | The term used in Airbridge | The term used in RTB House |
    | ---------------------- | -------------------------- | -------------------------- |
    | To refer to "Account"  | Account                    | Campaign                   |
    | To refer to "Campaign" | Campaign                   | Sub-campaign               |
  </Accordion>
</AccordionGroup>

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

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