By default, Poper determines a user's location based on their IP address (via Cloudflare). However, for high-accuracy targeting, you can request explicit browser-level location permissions from your visitors.
Using the user's precise GPS/Browser location allows for much more accurate geo-targeting compared to IP-based estimation.
Step 1: Update Your Poper Installation Script
Because requesting browser permissions is a sensitive action, you must enable this feature within your website's Poper installation code.
Locate the Poper script in your website's <head> or <footer> and add the browserLocation: "true" parameter to your configuration.
Your updated code should look like this:
<script
id="poper-js-script"
data-account-id="YOUR_ACCOUNT_ID"
src="https://app.poper.ai/share/poper.js"
defer
></script>
<script>
window.Poper = window.Poper || [];
window.Poper.push({
accountID: "YOUR_ACCOUNT_ID",
browserLocation: "true" // Add this line to enable location requests
});
</script>
Note: Make sure to keep your unique accountID intact when adding the browserLocation line.
Step 2: Configure the Popup Button Action
Once the script is updated, you need to tell Poper which button should trigger the permission request.
Open the Popup Editor: Go to the Poper dashboard and edit the popup you want to use.
Select a Button: Click on the button element inside your popup.
Set Button Action: In the left-hand settings panel, find the Action dropdown and select "Location Permission".
Save and Publish: Click Update to save your changes.
How it Works
The Request: When a visitor clicks that specific button, their browser will display the standard system prompt: "website.com wants to know your location."
Accuracy: Once granted, Poper uses this precise data for targeting instead of IP-based location.
Persistence: Poper remembers this permission. Every subsequent time Poper initiates on your site for that user, it will reuse the granted location data automatically.
Why use this?
This is ideal for local businesses, delivery services, or region-specific offers where city-level accuracy via IP might not be enough and you need street-level or precise neighborhood data.