Which location types can I prepare in the feed?

The best way to set up your feed is to make sure you prepare your locations in one of the following formats:

Country
Town/City
Postal code (ZIP code)
Coordinates

If you need Places, for now you should use Postal codes instead, as Places are not yet supported via API.

If you need Address, it is highly recommend to use Coordinates instead, as Meta API might not return results for your strings that are predictable enough.

How do I organise locations inside the feed?

Prepare a column for locations. Each row (ad) will have its own value.

One location value can be one location, or many separated by ; character.

You can list locations of any type, it is not necessary to stick to just one.

For example:

France | country;New York, United States | city;1091 || Netherlands

What if I want to apply radius?

Radius value is always in meters and it can be applied to:

coordinates
town/city

In any case, you can add radius in two ways:

add a separate radius column for each ad
This is easier when there is only one location per ad set. Many locations per ad set will result in a list of locations and a list of radius, without clear preview which one belongs to which.
add ^^[radius_value] to the end of the location string
This is easier in case you have or expect many locations for one ad set.

New York, United States | city^^10000;Paris, France | city^^10000

Radius limitations

For cities
When you select a city on Meta, you are actually getting a city with a default radius 40km (25 miles).
The minimal radius you can set for cities is 17km (10 miles), and the maximum is 80km (50 miles).
For coordinates
If you don't set up a radius, a default radius will be applied. For coordinates, a default radius is 16km (10 miles).
The minimal radius you can set for coordinates is 1km (1 mile), and the maximum is 80km (50 miles). The default is 16km (10 miles).
Special category ads
Location selection must include all areas equal or larger than 15 mile or 25 kilometer radius for the US and Canada, and 15 kilometer radius for Europe of any selected city or coordinate.

Good practices for all location types

Your value should be well defined because of a simple reason - Meta API that Hunch is using to fetch data will return results in different order in different situations. Hunch is choosing the first result that gets back.

So, even if you think your target is obvious, sometimes the results are surprising.

For example, your feed value can target Switzerland just with word "Switzerland". Hunch will use the first value that the API will return, but in this case your results might look like this (depending on your ad account, location, etc.):

But Germany will fetch a more logical order, and you will get the good value:

So, a good advice would be - always name the type of the location.

To do this, write down location like this:
[Location] | [Type]

Examples

France | country

New York, United States | city

Locations from feed: Setup Instructions per Location Type

For more guidance per location type, read this article.