Adworkz Posting Specifications Auto Ping & Post

Transcription

1 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: Post: For Post Multi: Testing Leads You will need the following information for testing: 1. Username: Testaff 2. Password: password 3. Use zip code for approvals and for denial responses. 4. Put your company name in the LEADID field.

2 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 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 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/xml Ping URL: 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 BANKRUPTCY NO Years since most recent bankruptcy (1-7), 0 for none.

3 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> </SSN> <CUSTZIP>99999</CUSTZIP> <MONTHLY_INCOME>3500</MONTHLY_INCOME> <DOB> </DOB><!-- optional --> <BANKRUPTCY></BANKRUPTCY><!-- optional --> </LEAD_DATA> </AUTO_LOAN_PROCESSING> Example Accepted Response: <TRANSACTIONID> </TRANSACTIONID> <APPLICATIONID> AppID </APPLICATIONID> *will need this number to resend Post <LOANSTATUS>G</LOANSTATUS> <APPSTATUS>A</APPSTATUS> <APPLICATIONURL></APPLICATIONURL> <COMMISSION>PRICE</COMMISSION> *this is the offer Price Example Reject Response: <TRANSACTIONID></TRANSACTIONID> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC></MESSAGEDESC> Example Error Response: <TRANSACTIONID></TRANSACTIONID> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC>Er.MSG.</MESSAGEDESC> Post Instructions

4 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 YES 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 TIME_AT_ADDRESS_M YES Months at home address, digits only

5 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 Example Post XML

6 <?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> </IPADDRESS> <SOURCE_URL> </CUSTOMER_TRACKING> <LEAD_DATA> <CUSTOMER_PERSONAL> <CUST_FNAME>Test</CUST_FNAME> <CUST_MNAME /> <CUST_LNAME>Test</CUST_LNAME> <HOME_PHONE> </HOME_PHONE> <CELL_PHONE> </CELL_PHONE> <DOB> </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> </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> </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: <TRANSACTIONID> </TRANSACTIONID> <APPLICATIONID></APPLICATIONID> <LOANSTATUS>G</LOANSTATUS> <APPSTATUS>A</APPSTATUS> <APPLICATIONURL></APPLICATIONURL> <COMMISSION>Commission</COMMISSION> *Final Commission Price

7 Example Reject Response: <TRANSACTIONID></TRANSACTIONID> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC></MESSAGEDESC> Example Error Response: <TRANSACTIONID></TRANSACTIONID> <LEADSTATUS>I</LEADSTATUS> <APPSTATUS>D</APPSTATUS> <REASONID></REASONID> <REASONDESC></REASONDESC> <SUCCESS>0</SUCCESS> <MESSAGENUMBER></MESSAGENUMBER> <MESSAGEDESC>Er.MSG.</MESSAGEDESC> 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. Contact Information Mailing Address: Adworkz, Inc PO Box 710 Spokane, WA Street Address: Adworkz, Inc 10 N. Post Street, Suite 422 Spokane, WA Phone: 877-ADWORKZ (tel: ) ( ) Fax: (fax: ) Sales Contact Technical Contact

8 Jason Coffman Phone: x200 (tel: ) Jason Coffman Phone: x200 (tel: )