Point Embedded Address to Shopping Cart
If you want an address box on your website that sends customers into your public shopping cart, your site needs to pass the address to the cart using the link (URL). The address is added to the end of your cart link as “extra details” called URL parameters.
Our public cart base link looks like this (example):https://signup.websitedomainhere.net
Step 1: Choose how you want to send the address
You have two options:
Option A: One address box (recommended)
Use this when your site has one input box where the customer types their full address.
-
Parameter name:
fulladdress -
Example:
-
https://signup-abcbroadband.fibersmith.systems/?fulladdress=204 Austin Ave Columbia MO 65203
Notes:
Option B: Multiple address boxes
Use this when your site has separate fields like Street, City, State, Zip.
Use these four parameter names:
Example:
Notes:
What happens after the address is sent
Once the cart receives the address, it takes over:
-
The cart can handle different formatting styles.
-
A complete address gives the best results, but it can still work if the formatting isn’t perfect.
-
address1,city,state,zip -
https://signup-abcbroadband.fibersmith.systems/?address1=204%20Austin%20Ave&city=Columbia&state=MO&zip=65203 -
Using all four gives the best match rate.
-
If your form has extra fields, you can include them too, but the cart only needs those four to try to find a match.
-
If the address matches one already in the system, the customer is taken straight to View Available Offers.
-
If it does not match, the customer goes into the cart’s address validation step, and the cart will pre-fill the address fields using what was sent from your website.
-
-
Code template (copy/paste)
-
If you want a ready-to-use widget that includes the address field, autocomplete dropdown, and the “Check Availability” button, use the template code below. Replace the highlighted values (Mapbox token, cart URL, and subscriber type IDs) with your own. Visuals have no impact on the performance of the code so they can be replaced to match company goals.
- Note: Address auto complete and offer type selection are not required to get this to work--the shopping cart does not rely on these services. The only requirement is that the submitted address is valid and properly formatted. As long as a valid address is passed to the form in one of the formats below, it will work:
https://yoursite/?fulladdress=204 Austin Ave Columbia MO 65203
https://yoursite/?address1=204%20Austin%20Ave&city=Columbia&state=MO&zip=65203
The cart will then handle the rest, by redirecting users to the “View Available Offers” page if a matching address exists or placing users into the cart’s address validation process if no match is found. You can remove these sections if you do not wish to use them.
Address Autocomplete
Google Autocomplete
Consider using Google Autocomplete to make it easier for customers to find/enter their address, and to improve the quality of addresses going into Vision - More info here - https://developers.google.com/maps/documentation/javascript/place-autocomplete 
Alternative: Mapbox Autocomplete for Your Shopping Cart
You can use Mapbox instead of Google for free to suggest addresses and send them to your cart.
Steps
-
-
Sign up at mapbox.com and create a public token with geocoding/autocomplete permissions.
-
-
Add an Input Field
-
Fetch Suggestions from Mapbox
-
Handle Selection
-
When a user clicks a suggestion, encode it and open the shopping cart:
Notes
-
Debounce input to reduce API calls.
-
Close the dropdown when the user clicks outside.
-
Works best with '&country=us'
-
You can use a single-field (fulladdress) or multi-field (address1, city, state, zip) URL.
-
Google Maps and Mapbox are optional enhancements for user experience, but proper address validation is the only requirement for integration with the shopping cart.
Choose Subscriber Type
If you want to allow the shopper to choose whether they want to see subscriber type specific offers, you can add a field to your address embed.
Choose Subscriber Type (Residential vs Business)
If you want customers to choose Residential or Business before entering the cart, you can add that choice to your embedded form.
How it works:
-
The customer selects Residential or Business.
-
When they click Check Availability, your site opens the cart link and includes:
-
the address, and
-
the subscriber type value (Residential or Business)
-
The cart uses a subscriber type ID (called a UUID) to decide which offers to show.
Where to find the subscriber type UUID
-
Go to Admin Utilities → Subscriber Management
-
Open the Subscriber Types tab
-
Click the subscriber type you want
-
Copy the UUID from the page URL
(It will work as long as that subscriber type has offers tied to it.)
Result:
-
The customer is sent to the cart with both the encoded address and the subscriber type UUID included in the link.
.
To find the UUID of the subscriber type you want to direct the cart to, go to Admin Utilities > Subscriber Management. Go to the subscriber types tab and click on whichever subscriber type you want the UUID for. You can find that UUID in the URL and it will work as long as the type has offers associated to it.
Working properly, it will direct the user to the shopping cart link with the encoded address + the subscriber type UUID.
Below is a nearly ready to use widget similar to the previous template but with the addition of the email field. Once again, replace the highlighted values (Mapbox token, cart URL, and subscriber type IDs) with your own.
