How to Post Solar Leads to LL Media, LLC

These instructions describe how leads should be posted to LL Media, LLC's shared campaign and understand what to expect in response.


Ping / Post

Ping URL https://llmedia.leadspediatrack.com/ping.do
Post URL https://llmedia.leadspediatrack.com/post.do
Request Method POST or GET are supported. We strongly recommend using POST.

Posting Fields


# Field Ping Required Post Required Data Type Description
1 lp_campaign_id Yes Yes String Provided to you by LL Media, LLC
2 lp_campaign_key Yes Yes String Provided to you by LL Media, LLC
3 lp_s1 Yes Yes String Sub Affiliate 1
4 lp_s2 No No String Sub Affiliate 2
5 lp_s3 No No String Sub Affiliate 3
6 lp_s4 No No String Sub Affiliate 4
7 lp_s5 No No String Sub Affiliate 5
8 lp_test No No String 1 for Test Post
9 lp_response No No String Response back XML or JSON
10 lp_ping_id No Yes String Returned Ping ID from the Ping Post
11 lp_return_dd_matches No No bool true or false
12 lp_return_dd_hash_parameter Yes No string phone or email
13 lp_return_dd_hash_type Yes No string sha1 or md5
14 lp_num_sold Yes No Number Number of time the lead has been sold
15 first_name No No String First Name
16 last_name No No String Last Name
17 phone_home No Yes US Phone Phone Home
18 address No No US Address Address
19 city No No US City City
20 state No No US State State
21 zip_code Yes Yes US Zip Code Zip Code
22 email_address No No E-Mail E-Mail Address
23 ip_address Yes Yes IP IP Address
24 average_utility_bill Yes Yes List Average Utility Bill
25 residence_ownership Yes Yes List Residence Ownership
26 shade Yes Yes List Shade
27 lead_id No No String Vendor Lead ID 1
28 universal_lead_id Yes Yes String Universal Lead ID
29 utility_company Yes Yes String Utility Company
30 credit_score No No List Credit Score
31 vendor_lead_id Yes Yes String Vendor Lead ID 2
32 notes_for_installer No No Text Notes for Installer
33 trusted_form No No String Trusted Form
34 trusted_form_Y_N Yes No List Does this lead have TrustedForm? (Y for Yes and N for No)
35 jornaya_Y_N Yes No List Does this lead have Jornaya? (Y for Yes and N for No)

Exclusive Directory - Shared Leads - Hash Information

To use the Exclusive Directory you must include the xml in the distribution_directives parameter

  • Parameter accepts phone, email, company or group.
  • hash accepts md5, sha1 or plain.

Sample XML
<distribution_directives>
	<excludes>
		<exclude>
			<parameter>phone</parameter>
			<hash>sha1</hash>
			<value>5bcb3745df55b139f734287d59bed53ede160e3d</value>
		</exclude>
		<exclude>
			<parameter>phone</parameter>
			<hash>sha1</hash>
			<value>382887879bcf7231478398d4b0bcc20fcf489aa3</value>
		</exclude>
	</excludes>
	<includes>
		<include>
			<parameter>phone</parameter>
			<hash>sha1</hash>
			<value>605fe0261fa3ab90d32092117c1d75ff8d7b68c3</value>
		</include>
		<include>
			<parameter>phone</parameter>
			<hash>sha1</hash>
			<value>4bab5a2b22cbded666d3b00595b3b27a28f287f3</value>
		</include>
	</includes>
</distribution_directives>


Sample Post
distribution_directives =<distribution_directives><excludes><exclude><parameter>phone</parameter><hash>sha1</hash><value>5bcb3745df55b139f734287d59bed53ede160e3d</value></exclude><exclude><parameter>phone</parameter><hash>sha1</hash><value>382887879bcf7231478398d4b0bcc20fcf489aa3</value></exclude></excludes></distribution_directives>

List Values

When posting leads, make sure you post the list value.


Average Utility Bill

# Label Value
1 $0-99 $0-99
2 $100-150 $100-150
3 $151-200 $151-200
4 $201-300 $201-300
5 $301+ $301+
6 $400+ $400+
7 $500+ $500+
8 $600+ $600+
9 $700+ $700+
10 $800+ $800+
11 $900+ $900+
Residence Ownership

# Label Value
1 Own Own
2 Rent Rent
Shade

# Label Value
1 A Little Shade A Little Shade
2 A Lot Of Shade A Lot Of Shade
3 No Shade No Shade
4 Uncertain Uncertain
Credit Score

# Label Value
1 Excellent Excellent
2 Good Good
3 Fair Fair
4 Poor Poor

Posting Tests

There are multiple ways to post a test lead. You can either post:

  • test in the first name or last name field; or
  • 1 in the lp_test field

Ping Responses

When a ping is posted, you will get a real-time response. The default response is in XML format; You can request the response to be JSON if you pass json in lp_response field.

Success
<response>
    <result>success</result>
    <ping_id>0UTNS5ND</ping_id>
    <price>15.00</price>
    <distribution_directives>
        <includes>
            <include>
                <parameter>phone</parameter>
                <hash>sha1</hash>
                <value>b56ca1215e5bddf98ebdb88a99bc274f9d0fa1b1</value>
            </include>
        </includes>
    </distribution_directives>
    <msg>Ping Accepted</msg>
</response>
Failure
<response>
    <result>failed</result>
    <ping_id>YZDRPBC7</ping_id>
    <price>0.00</price>
    <msg>Ping Rejected</msg>
    <errors>
        <error>No Match</error>
    </errors>
</response>

Post Responses

When a lead is posted, you will get a real-time response. The default response is in XML format; You can request the response to be JSON if you pass json in lp_response field.

Success
<response>
    <result>
success</result>
    <lead_id>
0UTNS5ND</lead_id>
    <price>
15.00</price>
    <redirect_url>
http://www.example.com/</redirect_url>
    <msg>
Lead Accepted</msg>
</response>
Failure
<response>
    <result>
failed</result>
    <lead_id>
YZDRPBC7</lead_id>
    <price>
0.00</price>
    <msg>
Lead Rejected</msg>
    <errors>

        <error>
No Match</error>
    </errors>

</response>