Setting Up a Location Feed

General

A location feed is an advertiser's structured list of physical locations (stores, businesses, dealerships, or restaurants). A location feed must have the following information mapped for each location:

• Location ID
• Location name
• Country code (two-letter ISO format)
• One of the following mapping combinations:
  • Latitude and longitude
  • Address line (street and building number), region/state (name or code), and city (unabbreviated name)

During ad serving, a location can be selected based on a user's location, and its details can be displayed in programmatic campaign ads.

You can add location feeds to your Flight Control account through file uploads or online file hosting using a URL. Flight Control supports the following location feed file formats:

• CSV
• TSV
• XML
• ZIP files
  • Note: The ZIP must contain a single supported file (CSV, TSV, or XML) at the root level.
• JSON - This isn't supported within the Flight Control UI. Contact your Clinch account representative for assistance.

Note: The maximum number of locations (rows) allowed in a location feed varies by account. To find your specific limit, see the Limits & Quotas tab in your account settings. You can request a limit increase by creating a support ticket (Help > Open Support Ticket).

Setting Up a Location Feed

Step 1: Create the Feed 

1. Go to Libraries > Location Feeds.
2. Click Create.
   • The Create Location Feed window will be displayed.
3. Enter a name for the location feed.
4. Select a type for the location feed.
5. Click Submit.

Step 2: Set up the Feed Source

1. Click the Feed Source tab while editing the feed.
2. Select an upload method.
3. Take one of the following steps depending on your upload method:
   • File Upload: Drag and drop, or click the plus sign to upload a file from your local device.
   • URL Upload Methods: Enter your file URL(s).
4. Optional. Click the Set a Schedule checkbox to configure an hourly, daily, weekly, or monthly update schedule for the feed.
5. Click Save.

Step 3: Map Feed Columns

1. Go to the Mapping tab while editing the feed.
2. Click Get Fields from File to retrieve columns from the location feed’s file.
3. Map each column to a Flight Control naming convention.
4. Click Save and Update once finished.

Note: For more information on this location feed tab's functionality, see Location Feed Mapping Tab.

Step 4: Validate Results

To see the feed's update status:

1. Go to the Update History tab while editing the feed.
   • You should look at the topmost row, the latest feed update.
   • Note: For more information on this location feed tab's functionality, see Location Feed Update History Tab.
2. Review the Summary column to ensure all feed data is ingested correctly without warning or errors.
   • Important: Ensure that all feed columns have data, and the number of rows imported matches your feed’s file.
3. Optional. Click Download Report to see further update statistics, warnings, and insights.
4. Go to the Locations tab while editing the feed.
5. Ensure that locations are present within the table and fields are mapped correctly.

Note: Radius is automatically added as a column in your location feed. This is used for campaign decisioning and can't be edited.

Using Location Feeds in Creatives

You can utilize location feed values within creative designs by enabling a creative template's Location feature and setting your location feed as a dynamic source for a dynamic parameter value within the creative template or child creative's Set step.

Using Location Feeds in Campaigns

You can use location feeds in programmatic campaigns through location cards, and you can condition for location feed columns in condition cards connected to a location card.

For programmatic campaigns that don't require video rendering, changes made to feeds used in an active campaign version will affect the live campaign.