Posting Bids from CallGrid to CallGrid using RTB

This guide will walk you through setting up your CallGrid campaign to send bid requests to another CallGrid customer.

Setup Instructions#

Step 1: Navigate to Your Campaign#

1. Log into your CallGrid account
2. Navigate to the Campaigns page
3. Click on any Live Call Bidding Campaign
4. Go to the Sources tab

Step 2: Get Your Posting Instructions#

1. Click the Code Icon (or Posting Instructions button) next to the Source
2. This will open the posting instructions modal

Step 3: Configure for CallGrid#

1. Select "CallGrid" from the platform dropdown
2. The system will automatically configure the required parameters:
3. • CallerId (required)
   • State (optional)
   • Zipcode (optional)
3. Select any additional custom tags you wish to send to the buyer

Step 4: Get Your Grid ID#

1. Your Grid-ID is displayed in the posting instructions
2. • Example format: cm97s8hmv000ijt06r4djmije
2. Click the copy button next to the Grid-ID

Step 5: Share with Your CallGrid Buyer#

1. Send the copied Grid-ID to the CallGrid customer you want to send bids to
2. Share this link with them: Receiving Bids from CallGrid in CallGrid using RTB
3. They will use your Grid-ID to configure their CallGrid destination to receive your bid requests

How It Works#

Once configured:

1. When calls arrive at your CallGrid campaign, the system automatically sends bid requests to the buyer's CallGrid account
2. The buyer evaluates the call and responds with a bid
3. If accepted, the call is routed to their destination
4. Both parties can track call performance in their respective CallGrid dashboards

What Gets Sent#

The following information is automatically sent with each bid request:

• CallerId: The caller's phone number
• InboundStateCode: The state of the incoming call (if available)
• Additional Tags: Any custom tags you selected in the posting instructions

Response Codes#

Your CallGrid buyer will respond with one of these codes:

• 1000: Bid accepted - Call will be routed to buyer
• 4000 and above: Bid rejected - see the API Error Codes article for more details.
• 5001: Bid Rate Limits

Next Steps#

For Conversion Tracking:

If you want to postback conversions to the buyer's CallGrid account based on a Payable event, see the related article: Posting Conversions to CallGrid from CallGrid

For Testing:

After the buyer configures their CallGrid destination with your Grid-ID:

1. Send a test call through your campaign
2. Monitor your CallGrid logs to verify bid requests are being sent
3. Confirm with the buyer that they're receiving the requests
4. Verify calls are routing correctly when bids are accepted

Troubleshooting#

Buyer Not Receiving Bid Requests:

• Verify you sent them the correct Grid-ID
• Confirm they've configured their CallGrid destination with your Grid-ID
• Check that your campaign is live and routing calls

All Bids Being Declined:

• Contact your buyer to understand their acceptance criteria
• Verify the call types you're sending match their buying preferences
• Check that required parameters (CallerId, State) are being sent correctly