How to Post Home Improvement 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 lp_return_dd_matches Yes 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 Yes String First Name
16 last_name No Yes String Last Name
17 phone_home No Yes US Phone Phone Home
18 phone_cell No No US Phone Phone Cell
19 phone_work No No US Phone Phone Work
20 phone_ext No No Number Phone Ext
21 address No Yes US Address Address
22 address2 No No String Unit / Apt / Suite
23 city No Yes US City City
24 state No Yes US State State
25 zip_code Yes Yes US Zip Code Zip Code
26 county No No String County
27 country No No String Country
28 email_address No Yes E-Mail E-Mail Address
29 dob No No Date Date of Birth
Expected date format: YYYY-MM-DD
30 ip_address Yes Yes IP IP Address
31 trusted_form No No String Trusted Form
32 lp_caller_id No No Phone LP Caller ID
33 tcpa_optin Yes Yes Bool TCPA Optin
Pass 1 for true; Pass 0 for false
34 tcpa_text No Yes Text TCPA Text
35 jornaya_lead_id No No String Jornaya Lead ID
36 lead_generated_date No No Date Lead Generated Date
Expected date format: YYYY-MM-DD
37 vendor_lead_id No No String Lead ID generated from your system
38 url No No URL Url
39 project Yes Yes List Project
40 phone_last4 No No Number Phone Last 4
41 residence_ownership Yes Yes List Residence Ownership
42 trusted_form_Y_N Yes No List Does this lead have TrustedForm? (Y for Yes and N for No)
43 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.


Project

#LabelValue
1AdditionsAdditions
2Basement RemodelingBasement Remodeling
3Bathroom Remodeling - Bathtub LinerBathroom Remodeling - Bathtub Liner
4Bathroom Remodeling - BathwrapsBathroom Remodeling - Bathwraps
5Bathroom Remodeling - Cabinets VanityBathroom Remodeling - Cabinets Vanity
6Bathroom Remodeling - CountertopsBathroom Remodeling - Countertops
7Bathroom Remodeling - FlooringBathroom Remodeling - Flooring
8Bathroom Remodeling - Full RemodelBathroom Remodeling - Full Remodel
9Bathroom Remodeling - OtherBathroom Remodeling - Other
10Bathroom Remodeling - Shower BathBathroom Remodeling - Shower Bath
11Bathroom Remodeling - SinksBathroom Remodeling - Sinks
12Bathroom Remodeling - ToiletBathroom Remodeling - Toilet
13Bathroom Remodeling - Walk In TubBathroom Remodeling - Walk In Tub
14Deck or Porch - Build or ReplaceDeck or Porch - Build or Replace
15Deck or Porch - Clean and SealDeck or Porch - Clean and Seal
16Deck or Porch - RepairDeck or Porch - Repair
17Electrical - Cable/TV/Voice/Data WiringElectrical - Cable/TV/Voice/Data Wiring
18Electrical - Ceiling or Exhaust FansElectrical - Ceiling or Exhaust Fans
19Electrical - Circuit Breakers and BoxesElectrical - Circuit Breakers and Boxes
20Electrical - Code Violations Corrections / Permit IssuesElectrical - Code Violations Corrections / Permit Issues
21Electrical - Electric Vehicle Charging StationsElectrical - Electric Vehicle Charging Stations
22Electrical - Electrical InspectionsElectrical - Electrical Inspections
23Electrical - Exterior Building LightingElectrical - Exterior Building Lighting
24Electrical - General Electrical RepairElectrical - General Electrical Repair
25Electrical - Generators / UPSElectrical - Generators / UPS
26Electrical - Light FixturesElectrical - Light Fixtures
27Electrical - Lightning ProtectionElectrical - Lightning Protection
28Electrical - OtherElectrical - Other
29Electrical - Outlets and SwitchesElectrical - Outlets and Switches
30Electrical - Recessed and Track LightingElectrical - Recessed and Track Lighting
31Electrical - Remodeling, Renovation or New ConstructionElectrical - Remodeling, Renovation or New Construction
32Electrical - Service UpgradesElectrical - Service Upgrades
33Electrical - Trouble Shooting / Short CircuitsElectrical - Trouble Shooting / Short Circuits
34Electrical - Wiring for an Old HouseElectrical - Wiring for an Old House
35Electrical - Wiring or Panel UpgradeElectrical - Wiring or Panel Upgrade
36Exterior Door - InstallExterior Door - Install
37Exterior Door - RepairExterior Door - Repair
38Fences - Aluminum Or SteelFences - Aluminum Or Steel
39Fences - Barbed Wire - Install or RepairFences - Barbed Wire - Install or Repair
40Fences - Chain Link - Install or RepairFences - Chain Link - Install or Repair
41Fences - Electric Pet Fence - Install or RepairFences - Electric Pet Fence - Install or Repair
42Fences - OtherFences - Other
43Fences - Vinyl or PVC - Install or RepairFences - Vinyl or PVC - Install or Repair
44Fences - Wood - Install or RepairFences - Wood - Install or Repair
45Fences - Wrought Iron - Install or RepairFences - Wrought Iron - Install or Repair
46Flooring - Carpet - InstallFlooring - Carpet - Install
47Flooring - Carpet - RepairFlooring - Carpet - Repair
48Flooring - Composite - InstallFlooring - Composite - Install
49Flooring - Composite - RepairFlooring - Composite - Repair
50Flooring - GraniteFlooring - Granite
51Flooring - Hardwood - InstallFlooring - Hardwood - Install
52Flooring - Hardwood - RepairFlooring - Hardwood - Repair
53Flooring - Tile - InstallFlooring - Tile - Install
54Flooring - Tile - RepairFlooring - Tile - Repair
55Flooring - Vinyl - InstallFlooring - Vinyl - Install
56Flooring - Vinyl - RepairFlooring - Vinyl - Repair
57Garage Build - 1 CarGarage Build - 1 Car
58Garage Build - 2 CarsGarage Build - 2 Cars
59Garage Build - 3 CarsGarage Build - 3 Cars
60Garage Door - Install or ReplaceGarage Door - Install or Replace
61Garage Door - RepairGarage Door - Repair
62Gutters - Copper Gutters - InstallGutters - Copper Gutters - Install
63Gutters - Copper Gutters - RepairGutters - Copper Gutters - Repair
64Gutters - Galvanized Gutters - InstallGutters - Galvanized Gutters - Install
65Gutters - Galvanized Gutters - RepairGutters - Galvanized Gutters - Repair
66Gutters - Gutter CleaningGutters - Gutter Cleaning
67Gutters - Gutter Cover InstallGutters - Gutter Cover Install
68Gutters - Gutter Cover RepairGutters - Gutter Cover Repair
69Gutters - PVC Gutters - InstallGutters - PVC Gutters - Install
70Gutters - PVC Gutters - RepairGutters - PVC Gutters - Repair
71Gutters - Seamless Metal Gutters - InstallGutters - Seamless Metal Gutters - Install
72Gutters - Seamless Metal Gutters - RepairGutters - Seamless Metal Gutters - Repair
73Gutters - Wood Gutters - InstallGutters - Wood Gutters - Install
74Gutters - Wood Gutters - RepairGutters - Wood Gutters - Repair
75Handyman - OtherHandyman - Other
76Handyman - Single ProjectHandyman - Single Project
77Handyman - Variety Of ProjectsHandyman - Variety Of Projects
78Home Security - CommercialHome Security - Commercial
79Home Security - ResidentialHome Security - Residential
80HVAC - Boiler - Electric - InstallHVAC - Boiler - Electric - Install
81HVAC - Boiler - Electric - RepairHVAC - Boiler - Electric - Repair
82HVAC - Boiler - Natural Gas - InstallHVAC - Boiler - Natural Gas - Install
83HVAC - Boiler - Oil - InstallHVAC - Boiler - Oil - Install
84HVAC - Boiler - Oil - RepairHVAC - Boiler - Oil - Repair
85HVAC - Boiler - Propane Gas - InstallHVAC - Boiler - Propane Gas - Install
86HVAC - Boiler - Propane Gas - RepairHVAC - Boiler - Propane Gas - Repair
87HVAC - Central A/C - InstallHVAC - Central A/C - Install
88HVAC - Central A/C - RepairHVAC - Central A/C - Repair
89HVAC - Furnace - Electric - InstallHVAC - Furnace - Electric - Install
90HVAC - Furnace - Electric - RepairHVAC - Furnace - Electric - Repair
91HVAC - Furnace - Natural Gas - InstallHVAC - Furnace - Natural Gas - Install
92HVAC - Furnace - Natural Gas - RepairHVAC - Furnace - Natural Gas - Repair
93HVAC - Furnace - Oil - InstallHVAC - Furnace - Oil - Install
94HVAC - Furnace - Oil - RepairHVAC - Furnace - Oil - Repair
95HVAC - Furnace - Propane Gas - InstallHVAC - Furnace - Propane Gas - Install
96HVAC - Furnace - Propane Gas - RepairHVAC - Furnace - Propane Gas - Repair
97HVAC - New Heat PumpHVAC - New Heat Pump
98HVAC -Boiler - Natural Gas - RepairHVAC -Boiler - Natural Gas - Repair
99Insulation - BattenInsulation - Batten
100Insulation - Blown InInsulation - Blown In
101Insulation - OtherInsulation - Other
102Insulation - Spray FoamInsulation - Spray Foam
103Kitchen Remodeling - AppliancesKitchen Remodeling - Appliances
104Kitchen Remodeling - Cabinets - InstallKitchen Remodeling - Cabinets - Install
105Kitchen Remodeling - Cabinets - RepairKitchen Remodeling - Cabinets - Repair
106Kitchen Remodeling - Counter Tops or SinksKitchen Remodeling - Counter Tops or Sinks
107Kitchen Remodeling - Floor PlanKitchen Remodeling - Floor Plan
108Kitchen Remodeling - FlooringKitchen Remodeling - Flooring
109Kitchen Remodeling - Full KitchenKitchen Remodeling - Full Kitchen
110Painting - ExteriorPainting - Exterior
111Painting - Interior 1 or 2 RoomsPainting - Interior 1 or 2 Rooms
112Painting - Interior 3 or 4 RoomsPainting - Interior 3 or 4 Rooms
113Painting - Interior 5 or 6 RoomsPainting - Interior 5 or 6 Rooms
114Painting - Interior 5 or More RoomsPainting - Interior 5 or More Rooms
115Painting - OtherPainting - Other
116Painting - Specialty Painting - Faux FinishesPainting - Specialty Painting - Faux Finishes
117Painting - Specialty Painting - TexturesPainting - Specialty Painting - Textures
118Paving - Asphalt - InstallPaving - Asphalt - Install
119Paving - Asphalt - RepairPaving - Asphalt - Repair
120Paving - SealingPaving - Sealing
121Pest Control - BatsPest Control - Bats
122Pest Control - BirdsPest Control - Birds
123Pest Control - BugsPest Control - Bugs
124Pest Control - OtherPest Control - Other
125Pest Control - RodentsPest Control - Rodents
126Pest Control - TermitesPest Control - Termites
127Plumbing - Appliance RepairPlumbing - Appliance Repair
128Plumbing - Basement Drainage ChannelsPlumbing - Basement Drainage Channels
129Plumbing - BathtubsPlumbing - Bathtubs
130Plumbing - Commercial or Industrial PlumbingPlumbing - Commercial or Industrial Plumbing
131Plumbing - Faucets, Fixtures and PipesPlumbing - Faucets, Fixtures and Pipes
132Plumbing - Gas PipesPlumbing - Gas Pipes
133Plumbing - General RepairPlumbing - General Repair
134Plumbing - Leak Detection and RepairPlumbing - Leak Detection and Repair
135Plumbing - OtherPlumbing - Other
136Plumbing - Other PlumbingPlumbing - Other Plumbing
137Plumbing - Remodeling or ConstructionPlumbing - Remodeling or Construction
138Plumbing - Septic SystemsPlumbing - Septic Systems
139Plumbing - Sewer and DrainsPlumbing - Sewer and Drains
140Plumbing - ShowersPlumbing - Showers
141Plumbing - Solar Water Heater SystemsPlumbing - Solar Water Heater Systems
142Plumbing - Sump PumpsPlumbing - Sump Pumps
143Plumbing - Tankless Water HeatersPlumbing - Tankless Water Heaters
144Plumbing - ToiletsPlumbing - Toilets
145Plumbing - Water HeatersPlumbing - Water Heaters
146Plumbing - Water or Fuel TankPlumbing - Water or Fuel Tank
147Plumbing - Water Treatment and PurificationPlumbing - Water Treatment and Purification
148Plumbing - Well PumpPlumbing - Well Pump
149Pool and Spa - Inground PoolPool and Spa - Inground Pool
150Restoration - Cleaning ServicesRestoration - Cleaning Services
151Restoration - Fire DamageRestoration - Fire Damage
152Restoration - Mold RemediationRestoration - Mold Remediation
153Restoration - OtherRestoration - Other
154Restoration - Storm DamageRestoration - Storm Damage
155Restoration - Water DamageRestoration - Water Damage
156Roofing - Asphalt - InstallRoofing - Asphalt - Install
157Roofing - Asphalt - RepairRoofing - Asphalt - Repair
158Roofing - Cedar - InstallRoofing - Cedar - Install
159Roofing - Cedar - RepairRoofing - Cedar - Repair
160Roofing - Composite - InstallRoofing - Composite - Install
161Roofing - Composite - RepairRoofing - Composite - Repair
162Roofing - Metal - InstallRoofing - Metal - Install
163Roofing - Metal - RepairRoofing - Metal - Repair
164Roofing - Slate - InstallRoofing - Slate - Install
165Roofing - Slate - RepairRoofing - Slate - Repair
166Roofing - Tar - InstallRoofing - Tar - Install
167Roofing - Tar - RepairRoofing - Tar - Repair
168Roofing - Tile - InstallRoofing - Tile - Install
169Roofing - Tile - RepairRoofing - Tile - Repair
170Siding - Aluminium - InstallSiding - Aluminium - Install
171Siding - Aluminium - RepairSiding - Aluminium - Repair
172Siding - Brickface - InstallSiding - Brickface - Install
173Siding - Brickface - RepairSiding - Brickface - Repair
174Siding - Fiber CementSiding - Fiber Cement
175Siding - Stoneface - InstallSiding - Stoneface - Install
176Siding - Stoneface - RepairSiding - Stoneface - Repair
177Siding - Vinyl - InstallSiding - Vinyl - Install
178Siding - Vinyl - RepairSiding - Vinyl - Repair
179Siding - Wood - InstallSiding - Wood - Install
180Siding - Wood - RepairSiding - Wood - Repair
181Sunrooms - Enclose PorchSunrooms - Enclose Porch
182Sunrooms - Fabric Awning CoverSunrooms - Fabric Awning Cover
183Sunrooms - Metal Awning CoverSunrooms - Metal Awning Cover
184Sunrooms - New Sunroom PatioSunrooms - New Sunroom Patio
185Sunrooms - Repair SunroomSunrooms - Repair Sunroom
186Sunrooms - Screen Porch PatioSunrooms - Screen Porch Patio
187Window Replacement - 1 Window - InstallWindow Replacement - 1 Window - Install
188Window Replacement - 1 Window - RepairWindow Replacement - 1 Window - Repair
189Window Replacement - 10+ Windows - InstallWindow Replacement - 10+ Windows - Install
190Window Replacement - 10+ Windows - RepairWindow Replacement - 10+ Windows - Repair
191Window Replacement - 2 Windows - InstallWindow Replacement - 2 Windows - Install
192Window Replacement - 2 Windows - RepairWindow Replacement - 2 Windows - Repair
193Window Replacement - 3-5 Windows - InstallWindow Replacement - 3-5 Windows - Install
194Window Replacement - 3-5 Windows - RepairWindow Replacement - 3-5 Windows - Repair
195Window Replacement - 6-9 Windows - InstallWindow Replacement - 6-9 Windows - Install
196Window Replacement - 6-9 Windows - RepairWindow Replacement - 6-9 Windows - Repair
Residence Ownership

#LabelValue
1OwnOwn
2RentRent

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>