> For the complete documentation index, see [llms.txt](https://docs.exads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exads.com/rtb/advertisers/exads-rtb/exads-rtb-advertisers-response.md).

# EXADS RTB Bid Response Specifications

***

{% hint style="info" %}
**Note**: The EXADS RTB Bid Response is done using JSON and XML.
{% endhint %}

***

The response for a bid request should have the following structure:

## Bid Response Object <a href="#bid-response-object" id="bid-response-object"></a>

| Attribute   | Description                                                                                                                             |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| id          | ID of the impression object to which this bid applies, must match id sent in the request (string)                                       |
| imgUrl      | Image url (only for type banner)                                                                                                        |
| iconUrl     | Icon url (only for type push\_notification and must be of requested dimensions)                                                         |
| clickUrl    | Forward url when campaign is clicked (for type banner, push\_notification, direct\_link or email\_click)                                |
| url         | Forward url when campaign is clicked (only for type popunder)                                                                           |
| title       | Title of the ad (only for type push\_notification)                                                                                      |
| description | Description of the ad (only for type push\_notification)                                                                                |
| value       | Bid price in CPM or CPC (float)                                                                                                         |
| imptrackers | Impression trackers, optional (only for type push\_notification)                                                                        |
| btype       | Pricing Model. Values: 1 = CPM, 2 = CPC. Default = 1 (int). **Note**: When response is for an Email Clicks zone request, 1 = Smart CPC. |
| bUrl        | Billing notification URL, it is recommended to use HTTP over HTTPS for bUrl                                                             |

\* Only Push Notification ads accept the CPC pricing model. \* The bURL is called when impression or click has been delivered, depending on CPM or CPC from btype field (default CPM).

## Bid Response in JSON <a href="#bid-response-in-json" id="bid-response-in-json"></a>

### Banner <a href="#banner" id="banner"></a>

```json
{
    "bid": {
        "id" : "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
        "imgUrl" : "http://mysite.com/images/myad.jpg",
        "clickUrl" : "http://mysite.com/landingpages/mypage",
        "btype": 1,
        "value" : 0.34,
        "bUrl": "https://mysite.com/my_billing_notification_url"
    }
}
```

### Direct Link <a href="#direct-link" id="direct-link"></a>

```json
{
    "bid": {
        "id" : "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
        "clickUrl" : "http://mysite.com/landingpages/mypage",
        "value" : 0.05,
        "btype": 2,
        "nUrl": "http://network-domain.com/win-notification",
        "bUrl": "https://mysite.com/my_billing_notification_url"
    }
}
```

### Email Clicks <a href="#email-clicks" id="email-clicks"></a>

```json
{
    "bid": {
        "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
        "clickUrl": "http://mysite.com/landingpages/mypage?el={email_encoded}",
        "value": 0.07,
        "btype": 2,
        "nUrl": "http://network-domain.com/win-notification",
        "bUrl": "https://mysite.com/my_billing_notification_url"
    }
}
```

### Popunder <a href="#popunder" id="popunder"></a>

```json
{
    "bid": {
        "id" : "dd4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
        "url" : "http://mysite.com/landingpages/mypage",
        "btype": 1,
        "value" : 0.13,
        "bUrl": "https://mysite.com/my_billing_notification_url"
    }
}
```

### Push Notifications <a href="#push-notifications" id="push-notifications"></a>

```json
{
    "bid": {
        "id" : "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
        "iconUrl" : "http://mysite.com/images/myadicon.jpg",
        "clickUrl" : "http://mysite.com/landingpages/mypage",
        "title": "My Ad Title",
        "description": "My Ad Description Text",
        "btype": 2,
        "value" : 0.13,
        "bUrl": "https://mysite.com/my_billing_notification_url",
        "imptrackers": [
            "https://mytracker.com"
        ]
    }
}
```

\* Only one imptracker URL is allowed in the case of Push Notification ads

## Bid Response in XML <a href="#bid-response-in-xml" id="bid-response-in-xml"></a>

### Banner <a href="#banner-1" id="banner-1"></a>

```xml
<?xml version="1.0"?>
<result>
    <bid>
        <id>d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa</id>
        <clickUrl><![CDATA[http://mysite.com/landingpages/mypage]]></clickUrl>
        <imgUrl><![CDATA[http://mysite.com/images/myad.jpg]]></imgUrl>
        <btype>1</btype>
        <value>0.34</value>
        <bUrl><![CDATA[https://mysite.com/my_billing_notification_url]]></bUrl>
    </bid>
</result>
```

### Direct Link <a href="#direct-link-1" id="direct-link-1"></a>

```xml
<?xml version="1.0"?>
<result>
    <bid>
        <id><![CDATA[d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa]]></id>
        <clickUrl><![CDATA[http://mysite.com/landingpages/mypage]]></clickUrl>
        <value><![CDATA[0]]></value>
        <btype><![CDATA[2]]></btype>
        <nUrl><![CDATA[http://network-domain.com/win-notification]]></nUrl>
        <bUrl><![CDATA[https://mysite.com/my_billing_notification_url]]></bUrl>
    </bid>
</result>
```

### Email Clicks <a href="#email-clicks-1" id="email-clicks-1"></a>

```xml
<?xml version="1.0"?>
<result>
    <bid>
        <id><![CDATA[d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa]]></id>
        <clickUrl><![CDATA[http://mysite.com/landingpages/mypage?el={email_encoded}]]></clickUrl>
        <value><![CDATA[0.07]]></value>
        <btype><![CDATA[2]]></btype>
        <nUrl><![CDATA[http://network-domain.com/win-notification]]></nUrl>
        <bUrl><![CDATA[https://mysite.com/my_billing_notification_url]]></bUrl>
    </bid>
</result>
```

### Popunder <a href="#popunder-1" id="popunder-1"></a>

```xml
<?xml version="1.0"?>
<result>
    <bid>
        <id>d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa</id>
        <url><![CDATA[http://mysite.com/landingpages/mypage]]></url>
        <btype>1</btype>
        <value>0.13</value>
        <bUrl><![CDATA[https://mysite.com/my_billing_notification_url]]></bUrl>
    </bid>
</result>
```

### Push Notification <a href="#push-notification" id="push-notification"></a>

```xml
<?xml version="1.0"?>
<result>
    <bid>
        <id>d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa</id>
        <iconUrl><![CDATA[http://mysite.com/images/myad.jpg]]></iconUrl>
        <clickUrl><![CDATA[http://mysite.com/landingpages/mypage]]></clickUrl>
        <title>My Ad Title</title>
        <description>My Ad Description Text</description>
        <btype>2</btype>
        <value>0.13</value>
        <imptrackers><![CDATA[https://mytracker.com]]></imptrackers>
        <bUrl><![CDATA[https://mysite.com/my_billing_notification_url]]></bUrl>
    </bid>
</result>
```

## No Bid Response <a href="#no-bid-response" id="no-bid-response"></a>

To answer a bid request without making an actual bid, an HTTP response code 204 "No Content" should be sent.

<br>


---

# 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.exads.com/rtb/advertisers/exads-rtb/exads-rtb-advertisers-response.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.