> For the complete documentation index, see [llms.txt](https://docs.relevant-digital.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.relevant-digital.com/hb-manager/integrations-and-connections/setting-up-a-new-ssp-connection-with-hbm-hba.md).

# Setting up a new SSP connection with HBM/HBA

## How to add a new bidedr adapter in Relevant Yield for HB Manager and HB Analytics modules

If you are looking to establish an [**API connection for the Ad Revenue Insights module**](/ad-revenue-insights/data-connections/setting-up-a-new-ssp-connection-with-api.md), please contact your account manager for detailed guidance on the required credentials.

{% stepper %}
{% step %}

## Go to **Configuration > Integrations** and click "**+ New Ssp**"

![Näyttökuva 2025-06-19 kello 8.58.26-1](/files/30b540254ef0bd7b3024475a55b1328f2e33f063)
{% endstep %}

{% step %}

## Select an **SSP Type** you would like to add to your prebid stack.

![HBM add new SSP (1)](/files/a1f67d7afe5d46b435ed569bfc001c2c76476bc0)
{% endstep %}

{% step %}

## Give it a Name

Give it name that you want to see in your reports for this SSP
{% endstep %}

{% step %}

## Add global prebid parameter if there is one

That will usually be your "SSP account ID" or "SSP member ID" or some other ID, e.g. Network code

![](/files/648ea38ae8a7f0c7c62185da95f892d4aed1c582)

Global parameter name you see in Relevant Yield may be different from the actual bidder adapter. If not sure please contact support for further assitance
{% endstep %}

{% step %}

## Insert dummy credentials before saving

System won't allow you to save your newly added SSP unless you add some dummy placeholder into **User\*** field

![](/files/09711e0a2ba82c6a435c728f8f99dc3e2791de34)

You can add

![](/files/97a80fbbcaf930f74ca6d1956e695929692763f8)

{% hint style="info" %}
**Note:**

" **Active**" should be enabled only for importing SSP data via the API connection. For this integration you can have a look at how to [set up a new connection with API](/ad-revenue-insights/data-connections/setting-up-a-new-ssp-connection-with-api.md)\*

Also all the other fields you see in the integration that are not described here are a part of connection the SSP with the API. So no need to add anything else
{% endhint %}
{% endstep %}
{% endstepper %}

#### HB MANAGER GENERIC BIDDER

If you cannot find the SSP you wish to integrate in the list, but you know it is an official Prebid bidder, select **“HB Manager Generic Bidder”**.

Required Prebid parameters for each bidder can be found [here](https://docs.prebid.org/dev-docs/bidders.html).

* **Default bidder name**\* = Prebid bidder code
  * ![](/files/7d5becfb9f640e2379dd711dd73a677468b98802)
* **ID Bidder param**\* = Prebid required parameter (usually representing the placement ID)
  * ![](/files/5e6c04c310736f5d841c9fc301ee34e5f1452fe0)

If you need assistance, please contact your Technical Account Manager.

#### **REQUIRED FIELDS**

Most fields in the SSP configuration are straightforward (e.g., Publisher ID or Account ID). However, if you encounter any difficulties or require clarification, please don’t hesitate to contact your account manager for assistance.

If multiple parameters are required, they should be added later to the [Prebid parameters](/hb-manager/auction-behavior-and-optimization/manage-prebid-settings-with-prebid-parameters.md) at the appropriate level (global, publisher, site, or placement), following JSON syntax rules.

#### Basic JSON structure

A typical JSON structure for defining additional Prebid parameter looks like this:

```json
{
  "site": "example-site",
  "adUnitElementId": "div-ad-slot-1",
  "placement": "placment-name"
}
```

✅ Use **double quotes** for keys and string values.

✅ Keep **consistent formatting** (indentation, commas, and spacing).

✅ Validate your JSON using tools such as [JSONLint](https://jsonlint.com/).

✅ Include only the necessary parameters to avoid errors.

See the **bulk import for automated SSP placement mapping** [HERE](/hb-manager/setup/bulk-import-automated-mapping-of-your-hb-structure-with-.csv.md).

### Possible Errors

**Prebid build error:**

If you receive an error after saving, you have most likely selected a bidder adapter that is not supported in your current Prebid.js version. Please verify that each bidder or module is available in the selected version. Also, be aware that although you can download older versions of Prebid.js, only the most recent major version is officially supported.

**Missing credentials:**

Those credentials are for the API connection with the SSP. If you are only trying to integrate the adapter for header bidding then you can insert a dummy placeholder to the fields and save.

Read how to disable SSP [here](/hb-manager/setup/disable-bidders-in-hb-manager.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.relevant-digital.com/hb-manager/integrations-and-connections/setting-up-a-new-ssp-connection-with-hbm-hba.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.