Hyperlocal Settings

Some mobile apps are location-aware, giving you the ability to target viewers based on their exact location using GPS coordinates. Hyperlocal options let you target (and exclude) these precise regions. One tactic can have up to 15,000 hyperlocal targets.


  • When you set up a hyperlocal tactic, you must also set conventional Location settings. Be sure to set an appropriately larger conventional geotarget 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 adjacent place names like Cicero.)
  • Tactics must include mobile delivery to use hyperlocal targeting. Lat/long coordinates used in hyperlocal targeting are generally not available for desktop impressions.

To access hyperlocal settings in the tactic editor, open the Location tab and select Hyperlocal.

Entering Coordinates and Addresses

You can enter coordinates and addresses manually in the text box. Click Enter in the upper right corner of the Hyperlocal panel.

  1. Choose the Default Radius length and Units: meters, feet, kilometers, or miles.

  2. Enter a list of comma-separated coordinates and/or addresses. Each location must appear on a separate line, and each set of coordinates must follow this pattern:

    latitude, longitude, radius

    The radius value is optional. If you don't set a radius, the Default Radius value applies.

    For example:

    	39.9598, -83.0070
    	40.1538, -83.1177
    	4850 W Powell Rd, Powell, OH 43065
    	39.9644, -82.9878				

  3. Click Target or Exclude to add the coordinates to your list.

After you add your hyperlocal targets, you can edit them in grid to the right or using the map view.

Bulk Uploading Coordinates

If you have a list of coordinates to enter, you can upload them all at once in a TXT file.

File Requirements

  • Your TXT file can include up 1000 sets of latitude and longitude coordinates and/or addresses. If you need more than 1000 addresses, you must perform additional uploads (up to 15,000 total coordinates and addresses per tactic).

  • Each location must appear on a new line in the file.
  • Coordinates must be separated by commas, so each line follows this format:

    latitude, longitude, radius

    The radius value is optional. If you don't set a radius, the Default Radius value that you set in the Hyperlocal panel applies to these coordinates.

  • Addresses should be as detailed as possible, including postal codes.
  • Do not include a radius after addresses. If you do, that location will not be successfully added to your hyperlocal targets. The default radius applies to all addresses, and you can edit them after you upload the file.

Uploading the File

  1. Click Bulk upload in the upper right corner of the default Hyperlocal panel.

  2. Choose the Default Radius length and Units: meters, feet, kilometers, or miles. The Default Radius applies to any set of coordinates in the file that doesn't specify a radius. The Units value applies to all coordinates and addresses in the file.

  3. Click Attach TXT and choose your file.

  4. Click Upload. If your file contains any formatting errors, you'll see a message.

Review your locations in the panel on the right or on the map.

Using the Map

  1. Click Map in the upper right corner of the default Hyperlocal panel.

    The first time you use the map, your browser may ask if you'd like to share your current location.

    If you share your location, the default map shows your immediate area. If you don't allow the browser to know your location, the default map shows the United States, Canada, and Mexico.

  2. Create targeting areas.

    1. Choose the center of the targeting area.


      1. Enter a street address.
        • Include as much detail as you can, including the city, state, and postal code for the address. Many cities share street names.


      2. Use the map's controls to zoom in on the location you want to target. Click anywhere on the map to set a target centered on that location. The default radius is 1 kilometer.

    2. Adjust the target area as needed.

      • On the map:
        • Click and drag your target around the map to relocate it. You must click on the exact center of your location, otherwise you will create a new target.
        • Expand or contract the circle to change your target radius.
      • In the grid in the panel on the right:
        • Manually adjust the Latitude, Longitude, or Distance.
    3. To block a zone from being targeted, change Target to Exclude on the grid.

  3. Add more targets by entering more addresses or clicking again on the map.

Note: To expand the map to fill the entire window, click the full screen button:

Hyperlocal Example

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

Note: When you run a hyperlocal tactic, you may notice that your tactic doesn't deliver on some exchanges.

Some exchanges don’t provide lat/long data that's accurate enough to be appropriate for hyperlocal targeting. For example, to protect user privacy, Google provides a polygon of geo location. This polygon can be up to 6,000 meters across, which can make targeting very inaccurate.

Hyperlocal campaigns are meant to target users within a radius of a very specific point, so the DSP doesn't allow the campaigns to target inventory on exchanges or apps that provide vague geo location data.