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