Skip to content

How to get the RTB bid request for your campaign

A bid request is the short message your call platform sends to Marketcall before each call. Marketcall answers whether it can take the call and how much it pays. Every campaign has its own ready-made bid request, and you only need to copy it.

Check the offerit must support RTB
Go to your campaignand scroll down the page
Click the Tools tabthe Bid request is there
Copy and pasteinto your call platform

First, make sure the offer supports RTB. Not every offer does. Ask your account manager before you build the integration. If the offer has a separate RTB version, apply to that one.

Step by step

Go to your campaign and open the Tools tab

  1. Go to your campaign: click My Campaigns in the left menu and open the campaign you want to connect.
  2. Scroll down the campaign page and find the Tools tab.
  3. Click it. There you will find the Bid request.
Campaign page: the Tools tab and the Bid request item in the list on the left

The offer ID, the campaign ID and the offer's own fields are blurred in the pictures. On your screen you will see them in full.

Shortcut: add #rtb-api-tab to the address of your campaign page to land on the bid request directly:
marketcall.com/v2/affiliate/campaigns/123456#rtb-api-tab
Here 123456 stands for your campaign ID.

Copy the request

Click the copy icon in the top right corner of the grey box. The whole request is copied: the address, the headers and the body.

Bid request block with the copy icon in the top right corner

Paste it into your call platform

  1. Paste the address, the headers and the body into the ping or RTB settings of your platform (Ringba, TrackDrive or another one).
  2. Put your API key in place of %YOUR_API_KEY%. See where to find your API key.
  3. Replace every other %PLACEHOLDER% with the matching token of your platform, so real data is sent with each call.

What is inside a bid request

Every bid request has the same shape. The example below uses made-up IDs.

POST /api/v1/affiliate/offers/OFFER_ID/bid-requests
Host: www.marketcall.com
x-api-key: %YOUR_API_KEY%
Content-Type: application/json; charset=utf-8

{
    "campaign_id": "123456",
    "caller_id": "%CALLER_ID%",
    "zip_code": "%ZIP_CODE%",
    … more fields, depending on the offer
}
Offer ID

Already filled in. The address is different for every offer, so a request from one offer does not work for another.

API key

The only part you add yourself. Replace %YOUR_API_KEY% with your API key.

Campaign ID

Already filled in. It ties every call to your campaign.

Placeholders

Everything between two % signs is filled by your call platform for each call, for example the caller's phone number and ZIP code.

Offer fields

The rest of the list differs from offer to offer. Send every field that your campaign's bid request shows.

What Marketcall answers

For every bid request Marketcall sends back a short answer. These three values are the ones your platform needs:

data.is_availableWhether the call can be taken right now: true or false.Accept or skip
data.earn.amountWhat this call pays you if it qualifies.Your bid
data.terms.durationThe minimum call length, in seconds, for the call to be paid.Call length

The step-by-step guides for Ringba and TrackDrive show where to enter these values and include full examples of the answer.

Before you go live

Do
  • Copy the request from the campaign you are connecting.
  • Replace every %PLACEHOLDER%.
  • Send all the fields the request lists.
Don't
  • Reuse a request from another campaign or offer.
  • Leave %YOUR_API_KEY% as it is.
  • Share the request with your API key in it.

Not sure the offer supports RTB, or the setup does not work? Write to your account manager and name the campaign ID. Don't send your API key.

Related articles

Still need a hand?

Our support team is available 24/7 — and your account manager knows your traffic.