Selected buyers – PX Knowledge Base

Selected Buyers feature allows publishers to sell their leads to the particular campaign(s) by indicating them in the lead request.

If the publisher sends the lead with the list of Selected Buyers, this lead will be routed only to indicated campaigns if they match campaign settings (i.e. leads and budget caps). Other campaigns in the platform will be excluded from the list of potential campaigns.

If the campaign is included in the selected buyers list, filters set in Filter management are still taken into account for this campaign.
Source Management configurations work in the following way:
- prioritizing rules are ignored (even if the publisher isn't prioritized for this campaign - the lead will be routed to it).
- blocking rules are still applied, so make sure the publisher source isn't blocked for the campaign.

How Publisher Selects Buyer Campaigns

If the publisher prefers selling their leads to specific campaigns, the following should be added to their lead requests:

Additional QuoteFlow="SelectedBuyers" attribute in QuoteRequest block of their lead request.
SelectedBuyers tag with the following parameters for each campaign:
- Buyer Campaign GUID (mandatory);
- Buyer Campaign Name (optional).

Publisher can ask his account manager in PX about GUIDs of particular campaigns.

View Selected Buyers code examples for XML and JSON.

XML Code Example

<?xml version="1.0" encoding="UTF-8"?>
<QuoteRequest QuoteType="General" QuoteCountry="UK" QuoteFlow="SelectedBuyers">
   <Persons>
      <Person>
         <Title>Mr</Title>
         <FirstName>John</FirstName>
         <LastName>Doe</LastName>
         <BirthDate>1980-09-09</BirthDate>
         <MaritalStatus>Single</MaritalStatus>
         <Gender>Male</Gender>
      </Person>
   </Persons>
   <SelectedBuyers>
      <SelectedBuyer>
         <BuyerGuid>44610C15-2C23-43FD-AF30-76A975F09D4F</BuyerGuid>
         <BuyerName>BuyerCampaign1</BuyerName>
      </SelectedBuyer>
      <SelectedBuyer>
         <BuyerGuid>47345C15-2C23-43FD-AF30-76A975F09D4F</BuyerGuid>
         <BuyerName>BuyerCampaign2</BuyerName>
      </SelectedBuyer>
   </SelectedBuyers>
</QuoteRequest>

Use Buyer campaign GUID in <BuyerGuid> field.

JSON Code Example

{
	"QuoteRequest": {
		"QuoteType": "General",
		"QuoteCountry": "UK",
		"QuoteFlow": "SelectedBuyers",
		"Persons": {
			"Person": {
				"Title": "Mr",
				"FirstName": "John",
				"LastName": "Doe",
				"BirthDate": "1980-09-09",
				"MaritalStatus": "Single",
				"Gender": "Male"
			}
		},
		"SelectedBuyers": {
			"SelectedBuyer": {
				"BuyerGuid": "44610C15-2C23-43FD-AF30-76A975F09D4F",
				"BuyerName": "BuyerCampaign1"
			},
			"SelectedBuyer2": {
				"BuyerGuid": "47345C15-2C23-43FD-AF30-76A975F09D4F",
				"BuyerName": "BuyerCampaign2"
			}
		}
	}
}

Use Buyer campaign GUID in "BuyerGuid" field.

DID (Data Provider ID)

Selected Buyers flow can be also used for passing back DIDs (Data Provider IDs).

Publishers with Transfer Datapost type can receive the list of DID codes (if they were configured for corresponding campaigns).

If data provider ID wasn't mapped for the campaign and publisher pair, DID tag will be empty in the response.

View Selected Buyers code examples with DIDs for XML and JSON.

XML Code Example with DID

<Response>
    <Result Value="BaeOK">
        <TransactionId>7BD2922F-E834-47B3-B363-652E7A87B0FE</TransactionId>
        <SelectedBuyer>
            <BuyerGuid>FA3B7759-E975-49D9-A3EC-001CD2A76100</BuyerGuid>
            <BuyerName>BuyerCampaign1</BuyerName>
            <DiD>DiD111111</DiD>
        </SelectedBuyer>
        <SelectedBuyer>
            <BuyerGuid>91490CFB-06B4-45ED-BF1B-2A29A668745B</BuyerGuid>
            <BuyerName>BuyerCampaign2</BuyerName>
            <DiD>DiD222222</DiD>
        </SelectedBuyer>
        <SelectedBuyer>
            <BuyerGuid>7E54CE4A-15A0-4550-B2EA-6EEC9C1F34E4</BuyerGuid>
            <BuyerName>BuyerCampaign3</BuyerName>
            <DiD>DiD333333</DiD>
        </SelectedBuyer>      
    </Result>
</Response>