Hyperlocal Options

Some mobile apps are location-aware, giving you the ability to target viewers based on their exact location using GPS coordinates. Hyperlocal options allow you to target (and exclude) these precise regions.

For example, if you want to target people who are going to a local baseball game, you set the center of your target area on the stadium. If you don't want to include everyone in the hospital nearby, you set up an excluded area within the targeted area. When coordinates overlap, excluded regions take precedence over targeted regions.

Hyperlocal options can be set for mobile hyperlocal campaigns and advanced campaigns.

Advanced campaigns: When you set up a hyperlocal campaign, you must also set conventional Location settings. Be sure to set an appropriately larger conventional geo-target that includes all of your hyperlocal targets. For example, if you are targeting hyperlocal points around the greater Chicago area, you might set the Location to Illinois. Targeting only the city of Chicago might be a problem if some points fall into areas that are not technically classified as Chicago, but rather use adjacent place names like Cicero.

Campaigns must include mobile delivery to use hyperlocal targeting. The latitude and longitude coordinates used in hyperlocal targeting are generally not available for desktop impressions.

Adding Hyperlocal Locations to Your Campaign

There are multiple ways to add hyperlocal locations to your campaign. Select Hyperlocal from the Advanced menu in the campaign’s General tab to get started.

Note: If you are editing an existing campaign, click Edit to change your Hyperlocal settings.


When you are finished, click Save.

Entering Coordinates and Addresses

  1. Under the Advanced menu, select Hyperlocal and click Enter. This is the default view when you first select Hyperlocal.


  2. Type the coordinates and addresses in the Enter… textbox.

    • Separate the latitude, longitude, and radius values with a space (e.g. 47.8781 -87.6298 4.00). The radius value is optional – if it is not included, it will default to 1 unit (defined by the Radius Units dropdown menu under Selected Locations.)

    • Be as specific as possible when entering an address. Include the street, city, state, and postal/ZIP code if possible (e.g. 11 E Madison Street Chicago, IL 60602).

    • Each coordinate or address must appear on a separate row. The maximum number of coordinates and addresses allowed in this field is 1000.

  3. Click Target or Exclude to add the regions. The new regions appear in the Selected Locations table and on the map.

Using the Map

  1. After you select Hyperlocal, click Map.


  2. Click anywhere on the map to create a targeted zone. The default radius is 1 unit.

    • Alternatively, use an address to add a region. Enter the address in the Search address... bar and select the location from the list.

  3. Adjust the target area as needed.

    • To move the target area, drag the labeled pin in the center of the region.

    • To change the radius, drag the edge of the circle.

    • The region that you add is targeted by default. To exclude it, edit the zone in the Selected Locations table next to the map. See Managing Hyperlocal Zones below for more detail.

  4. Add more targets as required. Every new region that you add appears in the Selected Locations table.

Uploading Coordinates from a File

  1. After you select Hyperlocal from the Advanced menu, choose Upload from file.

  2. Choose the Radius Units: kilometers, meters, miles, or feet.

  3. Upload a CSV file containing the coordinates. Each set of coordinates must appear on a separate line. Each line in the file must follow this pattern:

    latitude longitude radius

  4. Save your campaign to upload the file.

Note: The CSV file must only contain coordinates and radius values. Addresses are not recognized. If your file includes addresses, no locations will be added to the campaign.

Managing Hyperlocal Zones

Once you have added hyperlocal locations, either by entering coordinates, selecting areas on the map, or uploading a file, they are listed in the Selected Locations table and appear on the map. You can either adjust the locations directly on the map (see Using the map above) or use the table to make changes.


  • To change the unit of distance (kilometers, meters, miles, feet), use the Radius Units dropdown menu.

  • To deactivate a zone, uncheck the box in the Active column. Deactivate a zone if you no longer want it to be targeted or excluded by your campaign. Deactivated zones will still be visible on the map, but will be marked by a black circle instead of a green (targeted) or red (excluded) one.

  • To edit the latitude, longitude, or radius, click the value you want to change. Enter the new value and click Save.

  • To jump to the location on the map, click the pin button.

  • To delete a region, click the X button.

Note: When you run a hyperlocal campaign, you may notice that your campaign doesn't deliver on some exchanges. Some exchanges don’t provide lat/long data that is accurate enough to be appropriate for hyperlocal targeting (to protect user privacy, for example). Google provides a polygon of geolocation. This polygon can be up to 6,000 meters across, which can make targeting very inaccurate. Hyperlocal campaigns are meant to target users within the radius of a very specific point, so Basis DSP doesn't allow campaigns to target inventory on exchanges or apps that provide vague geolocation data.

Was this article helpful?
1 out of 1 found this helpful