Offer Availability and Ping Post (RTB/Real Time Bidding) Integration with Ringba

How to integrate Ringba and Marketcall for Ping-Post/RTB/Ring tree set up:

1. Please confirm with your personal manager whether the offer you plan to integrate supports RTB setup.
2. Now, create a campaign to acquire your SIP and DID.
3. Go to the campaign page and click on the "Tools" option (as shown in the screenshot below).

4. You will find the bid request details, which you can use for your RTB setup.

5. Create a Ring Tree Target.

6. Select settings such as number type, tags, and confirmation request. You can choose the number type as either Number or SIP (Marketcall supports both types) and enter the rented number of your Marketcall campaign.

7. Revenue Settings:

• Don't forget to set up Webhooks from Ringba

8. In the request settings, enter the following information:

URL - https://www.marketcall.com/api/v1/affiliate/offers/OFFER_ID/bid-requests , where {OFFER_ID} is the offer ID in Marketcall.

{
"campaign_id": "301108",
"caller_id": "[Call:InboundPhoneNumber]"
}

If offer requires zip code, then add to body "zip_code": "[tag:Gather:Zipcode]" **or **"zip_code": "[tag:Geo:ZipCode]"

campaign_id - is the campaign ID in Marketcall, replace 301108 with your campaign id

Http headers:
Key: x-api-key
Value: here.

9. Dynamic Bid Parsing and Call Acceptance Parsing
   Dynamic Bid Parsing. Add parsing step JPath.

data.earn.amount

Call Acceptance Parsing. Add parsing step JPath

data.is_available

Call Acceptance Parsing. Add another parsing step Javascript.

return input.toLowerCase() === "true".toLowerCase()

10. Create Ring Tree and add new Ring Tree Target to that
11. Add new Ring Tree to your routing flow
    

Examples of Successful Ping & ResponseBody

{"data":{"id":"9f2d3dca-c326-494e-a3ab-9bfb5f22feb9","is_available":true,"earn":{"amount":"56.00","currency":"usd"},"terms":{"duration":[{"condition":"gte","value":89,"unit":"seconds","description":"Minimum call duration should be 89 seconds."}]},"expires_at":"2025-06-17T13:23:40+00:00","target_number":"+18332464547"},"request_id":"ffb944a2-0307-40be-a05a-8c788c56a8d3"}

{"data":{"id":"9f1bb1ca-c20c-4ec0-b362-4b5621ce2b99","is_available":true,"earn":{"amount":"33.00","currency":"usd"},"terms":{"duration":[{"condition":"gte","value":100,"unit":"seconds","description":"Minimum call duration should be 100 seconds."}]},"expires_at":"2025-06-08T20:03:07+00:00","target_number":"+18332464441"},"request_id":"b36c19ef-13f6-4796-b164-4c65b2ed0b18"}

Updated on: 20/06/2025