How to Post Solar Leads to LL Media, LLC

These instructions describe how leads should be posted to LL Media, LLC's 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 first_name No Yes String First Name
12 last_name No Yes String Last Name
13 phone_home No Yes US Phone Phone Home
14 address No Yes US Address Address
15 city No Yes US City City
16 state Yes Yes US State State
17 zip_code Yes Yes US Zip Code Zip Code
18 email_address No Yes E-Mail E-Mail Address
19 ip_address Yes Yes IP IP Address
20 average_utility_bill Yes Yes List Average Utility Bill
21 residence_ownership Yes Yes List Residence Ownership
22 shade Yes Yes List Shade
23 lead_id No No String Lead ID
24 universal_lead_id No No String Jornaya Universal Lead ID Token
25 utility_company Yes Yes String Utility Company
26 credit_score No No List Credit Score
27 vendor_lead_id No Yes String Vendor Lead ID
28 notes_for_installer No No Text Notes for Installer
29 trusted_form No No String Trusted Form
30 trusted_form_Y_N Yes No List Does this lead have TrustedForm? (Y for Yes and N for No)
31 jornaya_Y_N Yes No List Does this lead have Jornaya? (Y for Yes and N for No)

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>
    <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>