Hyperlocal Options

What are Hyperlocal Options?

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

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

Hyperlocal options are available 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 a 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. Hyperlocal options are found in the Location tab of the campaign editor.

Entering Coordinates and Addresses

  1. In the Location tab, scroll down to the Hyperlocal section.

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

    • Separate the latitude, longitude, and radius values with a space (for example, 47.8781 -87.6298 4.00). The radius is optional – if you do not define it, the default is 1 unit (as 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 (for example, 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. Click Map in the Hyperlocal section of the Location tab.

  2. Click anywhere on the map to create a targeted zone. The default radius is 1 unit (as defined by the Radius Units dropdown menu under Selected Locations).

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

  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 details.

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

Uploading Coordinates from a File

  1. Click Upload from file in the Hyperlocal section of the Location tab.

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

  3. Upload a CSV or TXT file that contains the coordinates. Each set of coordinates must appear on a separate line, and each line must follow this pattern:
    latitude longitude radius

  4. Save your campaign to upload the file.

Note: The CSV or TXT file must only contain coordinates and radius values. If your file includes addresses, the upload fails and no locations will be added to your campaign.

Managing Hyperlocal Zones

When you add hyperlocal locations, either by entering coordinates, selecting areas on the map, or uploading a file, they show up 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.

Bulk Editing Hyperlocal Locations

You can edit the latitude, longitude, radius, or targeting rules for multiple hyperlocal zones at once with the bulk edit feature.

  1. Select the locations that you want to edit.

  2. Click Bulk Edit above the locations grid.

  3. In the Bulk Edit Hyperlocal window, enter new values for the latitude, longitude, or radius. To change the targeting rules, use the Target dropdown menu. You do not have to edit every value to make changes.

  4. Click Save.

Note: When you run a hyperlocal campaign, you may notice that your campaign doesn't deliver on some exchanges. Some exchanges don’t provide geographic data that is accurate enough for hyperlocal targeting (to protect user privacy, for example).

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.