Debt Posting Specs

Introduction

This document describes how to post debt leads to RGR Marketing. We accept both POST and GET requests.

Posting URL

https://www.reallygreatrate.com/formdov.php

Example Request Structure

A lead can be submitted via GET request. A well-formatted request looks like:

https://www.reallygreatrate.com/formdov.php?publisher_id=X&type=DEBT&first_name=Really&last_name=Rate&city=LA&state=CA&zip=99999&street_address=111First&work_phone=5558585&home_phone=5559696&email_address=rate@hotmail.com&include_in_market=Y&upload_type=RGR&lead_date=2005-05-05&field_1=xxx&field_2=xxx&field_3=xxx&field_4=xxx&field_6=xxx&field_7=xxx&field_8=xxx&field_9=xxx&field_10=xxx&best_time_to_call=Morning&ipaddress=1.1.1.1&subid=89&response=Yes&rcid=412&date_generated=09102005&work_ext=x456

Note that all field names are lower case and must match exactly for fields to be processed correctly.

publisher_id will be assigned to you by RGR Marketing. publisher_id is required for any lead to be accepted – it must be present in the posting string in the following format publisher_id=XXX where XXX is your assigned number.

Request Fields

Required Fields

parameter	description	required	data type	example
publisher_id	Publisher ID assigned by RGR before testing a new campaign	Yes	Integer	&publisher_id=1
type	Type of lead being submitted in all caps - DEBT	Yes	String	&type=DEBT
first_name	First Name	Yes	String	&first_name=Bob
last_name	Last Name	Yes	String	&last_name=New
state	2 Character State Abbreviation	Yes	String	&state=CA
home_phone	Home Phone without any dashes or parentheses	Yes	Integer	&home_phone=3105551234
email_address	Email address with @ and a valid extension (.com, .net, .gov, etc.)	Yes	String	&email_address=bobnew@mail.com
upload_type	Upload Type should be defaulted to RGR for the publishers unless otherwise instructed.	Yes	String	&upload_type=RGR
lead_date	Date of Submission in the format: YYYY-MM-DD	Yes	Date	&lead_date=2017-11-09
field_26	Jornaya LeadiD Token - Token genated by Jornaya LeadiD	Yes - *unless* NOT required by RGR for the publisher	String	&field_26=A033EC88-9C9F-576D-C04B-9A3183B4FBD9
field_1	Amount of credit card debt	Yes	Integer	&field_1=6000
ipaddress	IP Address of user	Yes	Integer	&ipaddress=123.236.23.355

Optional Fields

parameter	description	required	data type	example
city	City	No	String	&city=Temecula
zip	Zip	No	Integer	&zip=99999
street_address	Street Address	No	String	&street_address=123 Fourth Street
work_phone	Work Phone	No	Integer	&work_phone=5555555
include_in_market	Include in Market: Yes or No to include in our future marketing campaigns. Default to Yes of leave blank.	No	String	&include_in_market=Y
best_time_to_call	Best Time to Call. Valid values: Morning Afternoon Evening Defaults to Evening	No	String	&best_time_to_call=Morning
subid	Sub ID - used to track Publisher's marketing campaign/information.	No	String	&subid=Campaign123
rcid	Refer Code ID - used to validate the lead sent against a specific contract. Contact Matt Schaub for details and your specific RCID.	No	Integer	&rcid=1234
date_generated	The date you generated the lead in your system or the date the lead was captured by you.	No	Date	&date_generated=2017-01-01
work_ext	Work Extension The work extention, if used, can contain chars or numbers.	No	Integer	&work_ext=x456
field_2	Unsecured Debt: Amount of unsecured debt, note that you can either pass a value, 0 or nothing at all.	No	Integer	&field_2=10000
field_5	Home Owner: Y/N?	No	String	&field_5=Y
field_6	Credit Status	No	String	&field_6=Excellent
field_7	Secured Debt: Total Amount of secured debt.	No	Integer	&field_7=10000
field_8	Monthly Living Expenses: On average what are your monthly living expenses?	No	Integer	&field_8=5000
field_9	Monthly Income	No	Integer	&field_9=4000
field_10	Lead ID from the publisher: a unique number from the publisher per lead	No	String	&field_10=RGR12345
field_11	Current Financial Stability How would you rate your current financial stability? Scale of 1-10, 1 poor and 10 is great	No	String	&field_11=1
field_12	Type of Debt What type of debts do you have? Credit card, Tax, Student Loan, or Other (pass all that apply)	No	String	&field_12=Tax
field_13	Amount of other debt	No	Integer	&field_13=6000
field_14	Primary Source of Income	No	String	&field_14=Full time job
field_15	Amount of money set aside in savings and checking	No	String	&field_15=100000
field_16	Job Stability	No	String	&field_16=Stable
field_17	Own or Rent	No	String	&field_17=Own
field_18	Monthly Value: If field_17 is own, pass monthly mortgage payment. If field_17 is rent, pass the monthly rent.	No	String	&field_18=60000
field_19	House Value: If field_17 is own, pass the current house value.	No	String	&field_19=210000
field_20	Mortgage Balance: If field_17 is own, the current mortgage balance.	No	String	&field_20=60000
field_22	Readiness: How ready are you to resolve your financial debt? Scale of 1-10.	No	Integer	&field_22=10
field_21	Able to help If someone in your family needed $2000 today, could you help? Yes or No	No	String	&field_21=No
field_24	Is Canadian	No	String	&field_24=No
field_25	TrustedForm Token	No	String	&field_25=https://cert.trustedform.com/9a8b7c6d5e4f3g2h1i
field_27	Student Loan Debt Do you have student loan debt?	No	String	&field_21=Y
response	Response - Set to Yes if you want an HTTP response. If blank or No, then we serve our thank you page. Valid Values: Yes No *This is only used in posting.*	No	String	&response=Yes

Responses

If you put &response=Yes in the post string, we will return an HTML response in the following format. If response is empty or equal to no, we will redirect you to the appropriate RGR thank you page.

Successful Response

The format of a successful post will be:

<html><body>status=success<br>id=1234567</body></html>

Failed Response

The format of a rejected lead will be:

<html><body>status=Failed<br>Reason=Duplicate from publisher<br>id=1234567</body></html>

The format of a flagged lead will be:

<html><body>status=Flagged<br>Reason=Address in correct<br>id=1234567</body></html>

Jornaya LeadiD Integration

You can check out Jornaya's guide on how to set up with Jornaya Intelligence (LeadiD Audit) here.

In order to implement Jornaya LeadiD on your landing pages:

Go to Jornaya and click "SIGN UP". Fill out the Signup form, and await your confirmation email.

Create a campaign in LeadID for your Landing Page.

Implement the hidden field for LeadID:

<input id="leadid_token" name="universal_leadid" type="hidden" value=""/>

Get the code for your newly created campaign and place before the closing body tag on each step of your form:
(Example Script – DO NOT USE)

<script id="LeadiDscript" type="text/javascript">
    (function() { 
        var s = document.createElement('script'); 
        s.id = 'LeadiDscript_campaign'; 
        s.type = 'text/javascript'; s.async = true; 
        s.src = (document.location.protocol + '//d1tp4234w7krrh.cloudfront.net/campaign/32121057-a216-ba9c-7121212-4ec1212121dfsafafdaf.js'); 
        var LeadiDscript = document.getElementById('LeadiDscript'); 
        LeadiDscript.parentNode.insertBefore(s, LeadiDscript);})();
</script>
<noscript><img src='//create.leadid.com/noscript.png?lac=23424-324234-324-23432-234234&lck=32daf057-343-343-32423-234234 /></noscript>

Place the Thank You Page Code on your form’s Thank You Page/Confirmation Page:
(Example Script – DO NOT USE)

<script id="LeadiDscript" type="text/javascript">
    (function() { 
        var s = document.createElement('script'); 
        s.id = 'LeadiDscript_campaign'; 
        s.type = 'text/javascript'; 
        s.async = true; 
        s.src = (document.location.protocol + '//234234.cloudfront.net/campaign/asdfasf-32424-23423-23432-324234324.js?f=submit'); 
        var LeadiDscript = document.getElementById('LeadiDscript'); 
        LeadiDscript.parentNode.insertBefore(s, LeadiDscript);})();
</script>
<noscript><img src='//create.leadid.com/noscript.png?lac=324324-234234-23423-23432-324234&lck=23432-23432-234-234-23423423 /></noscript>

Please reach out to RGR Tech Team at T--E--C--H (at) rgrmarketing.com (no hyphens) if you have further questions.

TrustedForm Integration

To get the most up-to-date script for TrustedForm Integration, go to this URL: Add and Verify the TrustedForm JavaScript in a form

In order to integrate TrustedForm with your form, install the following script on the last page of your form; before the closing body tag (the page that is actually submitting the lead):

<script type="text/javascript">
    (function() { 
        var field = 'xxTrustedFormCertUrl'; 
        var provideReferrer = false; 
        var tf = document.createElement('script'); 
        tf.type = 'text/javascript'; 
        tf.async = true; 
        tf.src = 'http' + ('https:' == document.location.protocol ? 's' : '') + '://api.trustedform.com/trustedform.js?provide_referrer=' + escape(provideReferrer) + '&field=' + escape(field) + '&l='+new Date().getTime()+Math.random(); 
        var s = document.getElementsByTagName('script')[0]; 
        s.parentNode.insertBefore(tf, s); } )(); 
</script> 
<noscript> <img src="http://api.trustedform.com/ns.gif" /> </noscript>

This script will automatically add xxTrustedFormCertUrl field to your form. Use the field variable to customize the name of the field that is inserted into your form.

Please reach out to RGR Tech Team at T--E--C--H (at) rgrmarketing.com (no hyphens) if you have further questions.