Adworkz Posting Specifications
Auto Ping & Post
Version 4.3 (August 19th, 2014)
This document assumes knowledge within the XML and Post environments. This document is current with the date posted above and will instruct how to post information to the Adworkz server and the responses to expect.
Posting method
Adworkz offers two options while posting Auto leads into our system.
Ping & Post: "Single Sell Post"
Adworkz will attempt to place your lead with the highest bidder with information sent in the ping. If the ping is accepted, you will have 1 minute and 45 seconds to post your valid lead information along with the transaction ID sent to you in the XML. If the lead "POST" is accepted, XML will be sent back to your system with commission included. If the potential buyer denies the post, we will discontinue all processing of the lead and send an XML back to your system with a denial reason.
Post Multi: Sell Above Minimum Price
This method allows publishers to maximize revenue by not depending on just the highest bidder for a lead sale. Adworkz will process your lead exactly as in our "Single Sell Post" with one exception. If your highest bidder denies your post, instead of stopping your lead, we will continue our sales attempts with the next highest bidder until we are able to place your lead or exhaust all possibilities that meet your minimum sale price specifications.
Posting URL's:
For Ping & Post:
Ping: https://leadpost.adworkz.com/auto/Ping.aspx Post: https://leadpost.adworkz.com/auto/Post.aspx
For Post Multi:
https://leadpost.adworkz.com/auto/Leads.aspx
Testing Leads
You will need the following information for testing:
1. Username: Testaff 2. Password: password
3. Use zip code 99999 for approvals and 99998 for denial responses. 4. Put your company name in the LEADID field.
5. Include all fields, even if the information in the field is not required.
Please contact Adworkz (contact info below) prior to testing. We will reply to your email letting you know we are ready to receive test leads from you.
After you receive an accepted response, please copy and paste the XML ping and post you sent to us and the response you received from us into an email to the "Technical Contact." If Adworkz can verify the test, the "Sales Contact" will issue live credentials to you. If you need support while trying to get an accepted response, please contact the "Technical Contact." Any questions not pertaining to testing lead delivery should be directed to our "Sales Contact."
Ping Instructions
Content Type: text/xmlPing URL: Https://leadpost.adworkz.com/auto/Ping.aspx
All fields are required although the information in the field may not be required. (i.e. <BANKRUPTCY>
</BANKRUPTCY> must be inserted into your XML however, you do not have to provide the actual "BANKRUPTCY" info between the > and <.) See example ping below.
Ping Field Definitions:
Field
Required
Description
USERID YES Assigned User ID
PASSWORD YES Assigned Password
CAMPAIGN_ID YES Your Affiliate's Identifier (Sub ID)
MINIMUM_SALE_PRICE NO Minimum Price allowed for lead sale (If not specified all prices are valid)
LEADID NO Pass through field (see restrictions for testing)
COUNTRY YES USA
SSN YES Social Security Number, 9 digits only, no dashes or spaces
CUSTZIP YES Home address zip code, No dashes or spaces
MONTHLY_INCOME YES Income per month, digits only, no decimals
DOB NO Date of Birth as yyyy-MM-dd
Example Ping XML:
<?xml version="1.0" encoding="utf-8"?> <AUTO_LOAN_PROCESSING> <AFFILIATE_INFO> <USERID>USER_ID_HERE </USERID> <PASSWORD>password</PASSWORD> <CAMPAIGN_ID>testID</CAMPAIGN_ID> <MINIMUM_SALE_PRICE>3.00</MINIMUM_SALE_PRICE> <LEADID>COMPANY NAME</LEADID> <COUNTRY>USA</COUNTRY> </AFFILIATE_INFO> <LEAD_DATA> <SSN>100010001</SSN> <CUSTZIP>99999</CUSTZIP> <MONTHLY_INCOME>3500</MONTHLY_INCOME> <DOB>1965-06-21</DOB><!-- optional --> <BANKRUPTCY></BANKRUPTCY><!-- optional --> </LEAD_DATA> </AUTO_LOAN_PROCESSING>Example Accepted Response:
<EXTRESPONSETRANSACTION>
<TRANSACTIONID> </TRANSACTIONID>
<APPLICATIONID> AppID </APPLICATIONID> *will need this number to resend Post <TRANSACTIONDATE></TRANSACTIONDATE>
<LOANSTATUS>G</LOANSTATUS> <APPSTATUS>A</APPSTATUS>
<APPLICATIONURL></APPLICATIONURL>
<COMMISSION>PRICE</COMMISSION> *this is the offer Price </EXTRESPONSETRANSACTION>
Example Reject Response:
<EXTRESPONSETRANSACTION> <TRANSACTIONID></TRANSACTIONID> <TRANSACTIONDATE></TRANSACTIONDATE> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC></MESSAGEDESC> </EXTRESPONSETRANSACTION>
Example Error Response:
<EXTRESPONSETRANSACTION> <TRANSACTIONID></TRANSACTIONID> <TRANSACTIONDATE></TRANSACTIONDATE> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC>Er.MSG.</MESSAGEDESC> </EXTRESPONSETRANSACTION>
Post Instructions
Post is used to follow up the accepted ping response with the full content of the lead, or to provide the full content of the lead for multi-post (which bypasses the ping entirely). If the Ping-Post method is being used, the APPLICATIONID
field is required and must contain the ID returned by the Ping request.
Post Field Definitions
Field
Required
Description
USERID YES Assigned User ID
PASSWORD YES Assigned Password
APPLICATIONID YES* Application Id returned by PING, not required for multi-post
IPADDRESS YES IP address of applicant
SOURCE_URL NO Web site URL where form was completed
CUST_FNAME YES First Name
CUST_MNAME NO Middle Name
CUST_LNAME YES Last Name
HOME_PHONE YES 10 digits only, no dashes or spaces
CELL_PHONE YES 10 digits only, no dashes or spaces
May use home phone if not collected
EMAIL YES Email Address
DOB YES Date of Birth as yyyy-MM-dd
COUNTRY YES USA
CUSTADDR1 YES Home Address Line 1 (ex. House number and street)
CUSTADDR2 NO Home Address Line 2 (ex. Apt)
CUSTCITY YES Home Address City
CUSTSTATE YES Two character state abbreviation
CUSTZIP YES Digits only, no dashes or spaces
TIME_AT_ADDRESS_Y YES Years at home address, digits only
RENT_OWN YES 1 = Own, 0 = Rent
MONTHLY_RENT YES Monthly rent or mortgage payment, digits only, no decimal
EMPLOYER YES Employer's Name
JOB TITLE YES Job Title
MONTHLY_INCOME YES Income per month, digits only, no decimal
WORK_PHONE YES 10 digits only, no dashes or spaces
WORK_PHONE_EXT NO Work phone extension number, if any
TIME_AT_EMPLOYMENT_Y YES Years at current employer, digits only
TIME_AT_EMPLOYMENT_M YES Months at current employer, digits only
SSN YES Social Security Number, 9 digits only, no dashes or spaces
COSIGNER_AVAILABLE NO Does applicant have a cosigner? 1 = Yes, 0 = No
DOWNPAYMENT NO Requested downpayment amount, digits only, no decimals
TRADE_IN NO Trade In Available? 1 = Yes, 0 = No
EST_TRADE_IN_VALUE NO If trade in available, estimated value, digits only, no decimals CHECKING_ACCOUNT_OPEN NO Does applicant have checking account? 1 = Yes, 0 = No SAVINGS_ACCOUNT_OPEN NO Does applicant have savings account? 1 = Yes, 0 = No BANKRUPTCY NO Years since most recent bankruptcy (1-7), 0 for none.
TERMS_OF_SERVICE YES Has applicant agreed to terms of service, including credit check? 1 = Yes, 0 = No
<?xml version="1.0" encoding="utf-8"?> <AUTO_LOAN_PROCESSING> <AFFILIATE_INFO> <USERID>Testaff</USERID> <PASSWORD>password</PASSWORD> <APPLICATIONID></APPLICATIONID> </AFFILIATE_INFO> <CUSTOMER_TRACKING> <IPADDRESS>10.1.2.10</IPADDRESS> <SOURCE_URL>http://example.com/auto_application/form.html</SOURCE_URL> </CUSTOMER_TRACKING> <LEAD_DATA> <CUSTOMER_PERSONAL> <CUST_FNAME>Test</CUST_FNAME> <CUST_MNAME /> <CUST_LNAME>Test</CUST_LNAME> <HOME_PHONE>5092709000</HOME_PHONE> <CELL_PHONE>5092709000</CELL_PHONE> <EMAIL>[email protected]</EMAIL> <DOB>1985-11-26</DOB> </CUSTOMER_PERSONAL> <CUSTOMER_HOME> <COUNTRY>USA</COUNTRY>
<CUSTADDR1>PO BOX 710</CUSTADDR1> <CUSTADDR2 /> <CUSTCITY>Spokane</CUSTCITY> <CUSTSTATE>WA</CUSTSTATE> <CUSTZIP>99999</CUSTZIP> <TIME_AT_ADDRESS_Y>0</TIME_AT_ADDRESS_Y> <TIME_AT_ADDRESS_M>6</TIME_AT_ADDRESS_M> <RENT_OWN>1</RENT_OWN> <MONTHLY_RENT>1500</MONTHLY_RENT> </CUSTOMER_HOME> <CUSTOMER_EMPLOYMENT> <EMPLOYER>Yes</EMPLOYER> <JOB_TITLE>worker</JOB_TITLE> <MONTHLY_INCOME>3500</MONTHLY_INCOME> <WORK_PHONE>5097473424</WORK_PHONE> <WORK_PHONE_EXT>200</WORK_PHONE_EXT> <TIME_AT_EMPLOYMENT_Y>3</TIME_AT_EMPLOYMENT_Y> <TIME_AT_EMPLOYMENT_M>6</TIME_AT_EMPLOYMENT_M> </CUSTOMER_EMPLOYMENT> <LOAN_CREDIT_DETAILS> <SSN>100010001</SSN> <COSIGNER_AVAILABLE>1</COSIGNER_AVAILABLE> <DOWNPAYMENT>500</DOWNPAYMENT> <TRADE_IN>0</TRADE_IN> <EST_TRADE_IN_VALUE>0</EST_TRADE_IN_VALUE> <CHECKING_ACCOUNT_OPEN>1</CHECKING_ACCOUNT_OPEN> <SAVINGS_ACCOUNT_OPEN>0</SAVINGS_ACCOUNT_OPEN> <BANKRUPTCY>2</BANKRUPTCY> <PREFERRED_MONTHLY_PAYMENT>350</PREFERRED_MONTHLY_PAYMENT> <TERMS_OF_SERVICE>1</TERMS_OF_SERVICE> </LOAN_CREDIT_DETAILS> </LEAD_DATA> </AUTO_LOAN_PROCESSING>
Example Accepted Response:
<EXTRESPONSETRANSACTION> <TRANSACTIONID> </TRANSACTIONID> <APPLICATIONID></APPLICATIONID> <TRANSACTIONDATE></TRANSACTIONDATE> <LOANSTATUS>G</LOANSTATUS> <APPSTATUS>A</APPSTATUS> <APPLICATIONURL></APPLICATIONURL>
<COMMISSION>Commission</COMMISSION> *Final Commission Price </EXTRESPONSETRANSACTION>
Example Reject Response:
<EXTRESPONSETRANSACTION> <TRANSACTIONID></TRANSACTIONID> <TRANSACTIONDATE></TRANSACTIONDATE> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC></MESSAGEDESC> </EXTRESPONSETRANSACTION>Example Error Response:
<EXTRESPONSETRANSACTION> <TRANSACTIONID></TRANSACTIONID> <TRANSACTIONDATE></TRANSACTIONDATE> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC>Er.MSG.</MESSAGEDESC> </EXTRESPONSETRANSACTION>
Sending Live Leads
After confirming that an approved test lead was received, live credentials will be issued by our "Sales Contact." We require the process of sending live leads to begin on weekdays before noon, Pacific Standard Time (PST), so that we have time to monitor before the close of business that day. Please be sure to confirm with the "Technical Contact" before you begin sending live leads.
Returning Leads
We ask our Auto and New Car partners to submit and retrieve their returns through our extranet. You should receive your login credentials from Adworkz, but if you have not received them after going live, please ask for them.
We will have our return files ready for you to retrieve shortly after 3:30 pm PST/6:30 pm EST on the 15th of each month or the following business day if the 15th falls on a weekend or holiday.
