Boberdoo Ping Post Buyer Setup

A step by step tutorial on setting up your Boberdoo Ping Post buyer! To watch a video tutorial on this topic click here

To begin, you’ll need a copy of your buyer’s API specs. For this example we’ll be using these sample Boberdoo API specs

You’ll begin by copying and pasting the JSON Post URL into your buyer’s Ping set up. In this setup the Ping and Post URLs will be the same, and you will differentiate between the Ping and the Post by setting the Mode field to its respective value when building your payloads. The request method will be Post and the payload type will be JSON

Next are fields. To easily format your payload, we recommend copying and pasting the sample post from the API specs. Make sure to remove all the fields from the Ping payload that aren’t required, as you only want to send partial lead information in the Ping. You’ll then fill in the blank space between the quotation marks with either the static values dictated by your specs or the green campaign field shortcodes that match the fields

The value for the Key field will be given to you by your buyer and is required on both the Ping and the Post. API_action is also required on the Ping and the Post

The next field, Mode, is very important. Ensure that the Mode field is set equal to ping in the Ping payload

Return_Best_Price is only required if the vendor is on dynamic pricing, in which case it needs to be set equal to 1. TYPE will be a static value that is dictated by your specs, in this example we will set type equal to 34

Continue building your ping payload with the required fields. When your payload is complete it will resemble the one seen below

The header Content-Type is automatically filled out for you when you select the payload type. For a successful ping response, the Condition will be key equal with, the Key will be /response/status, and the Value will be Matched

If the buyer system returns the real time price, you can choose to have Lead Prosper track it when storing analytics. Toggle the real time price option to ON in your buyer set up and enter /response/price as the price key. The “Send Post If” section is helpful when you only want to sell a lead to a buyer if the price is greater than a specific amount

Next is the Post set up. The Post URL, request method, and payload type will be the same as the Ping set up, but you must now set the field Mode equal to post in the payload builder

To grab the Lead ID from the PING response add Lead_ID as a field and enter {{lp_ping_response:/response/lead_id}}

Complete the rest of your Post payload with the fields that are required on the Post. When your payload is complete it should resemble the one seen below

Once again, the header Content-Type is automatically filled out for you when you select the payload type. The response mapping for an accepted Post will be the same as the Ping, with key equal with as the Condition, /response/status as the key, and Matched as the value. The response for a duplicated lead is now automatically filled out for you. Since the real time price was set on the Ping, there’s no need to set it on the Post

That’s all there is to setting up a Boberdoo Ping Post buyer. If you have any questions please make use of the support button or email us at support@leadprosper.io

**If you are testing, set zip_code=99999 and state=AK to properly test.