Brand explicit consent - required information

  • Updated on

Brand explicit consent flow allows to ensure that consumers can give individual consent to specific buyers, before the buyers receive the lead.

To start using Brand consent functionality, buyers need to provide information about their brands, depending on the type of integration and posting type:

Direct post buyers

To initiate creation of the new brand in PX, send the following information to your client success manager in PX:

  • TCPA text - if no text provided, we''ll implement a general one mentioning the buyer's (or brands) name.
  • Brand logo:
    • PNG format
    • transparent background
    • aspect ratio of 2:1, ideally 300 pixels wide, 150 pixels high
  • Brand name that we'll use in PX platform - can also be the buyer's name.

Ping post buyers (API configuration)

To initiate the integration of your brands in PX via API connection, send the following information to your client success manager in PX: 

  • TCPA text - if no text provided, we''ll implement a general one mentioning the buyer's (or brands) name.
  • Brand logo:
    • PNG format
    • transparent background
    • aspect ratio of 2:1, ideally 300 pixels wide, 150 pixels high
  • Brand name(s) that we'll use in PX platform.
  • API configuration instructions depending on which parameter was previously configured in PX:
    • Full list of brand names
    • Full list of brand UIDs (Universal IDs) from your system
    • Full list of brand IDs from PX platform
  • Parameter you send must correlate with the parameter configured for this brand (brand name, PXID, or UID) in PX.
  • If none of the above is provided, we're unable to complete the brand integration and post any leads.
  • The list of the data we should retrieve (brand name, PXID or UID) and pass back to you, and in which format.
  • Payouts - if managed in your system - instructions how to retrieve payout info from your post response.
  • Example post response from your API - here are examples of what we accept:

JSON response example

{
   "TransactionId": "809674f5-9ba9-4945-ae99-e62315c908f5",
   "MatchPingId": "809674f5-9ba9-4945-ae99-e62315c908f5",
   "Success": true,
   "Payout": null,
   "Message": null,
   "Errors": null,
   "Sold": null,
   "RedirectUrl": null,
   "BuyerRawResponse": null,
   "BuyerGuid": null,
   "Environment": "Testing",
   "Legs": null,
   "Brands": [
       {
           "PxId": "94aa53a4-6652-4499-9882-44de0dbbd354",
           "Name": "Brand 1",
           "Description": "Description of Brand 1",
           "Uid": null,
           "Link": "https://px.com",
           "LogoUrl": "https://www.px.com/wp-content/uploads/2022/02/px-site-icon.png",
           "PhoneNumber": "123456789",
           "TCPA": "TCPA text for Brand 1",
           "Bid": 12.34
       },
       {
           "PxId": "0311617f-9e4b-4627-9734-559a2a252c35",
           "Name": "Brand 2",
           "Description": "Description of Brand 2",
           "Uid": "Brand 2 External Id",
           "Link": "https://px.com",
           "LogoUrl": "https://www.px.com/wp-content/uploads/2022/02/px-site-icon.png",
           "PhoneNumber": "123456789",
           "TCPA": "TCPA text for Brand 2",
           "Bid": 23.45
       }
   ]
}

XML response example

<?xml version="1.0" encoding="UTF-8"?>
<Result xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <TransactionId>0b156a37-fe10-48c2-b38f-7e7b59497e7a</TransactionId>
   <MatchPingId>0b156a37-fe10-48c2-b38f-7e7b59497e7a</MatchPingId>
   <Success>true</Success>
   <Payout xsi:nil="true" />
   <Sold xsi:nil="true" />
   <BuyerGuid xsi:nil="true" />
   <Environment>Testing</Environment>
   <Brands>
      <BrandMatch>
         <PxId>e4759b65-d688-4af4-9651-1949e6bd5cde</PxId>
         <Name>Brand 1</Name>
         <Description>Description of Brand 1</Description>
         <Link>https://px.com</Link>
         <Bid>12.34</Bid>
      </BrandMatch>
      <BrandMatch>
         <PxId>0c9b2083-63ed-44fb-a677-626460c70184</PxId>
         <Name>Brand 2</Name>
         <Description>Description of Brand 2</Description>
         <Uid>Brand 2 External Id</Uid>
         <Link>https://px.com</Link>
         <Bid>23.45</Bid>
      </BrandMatch>
   </Brands>
</Result>

Related articles

0 comments

Please sign in to leave a comment.

Related articles