BullseyeLocations

Use this section to import your locations. This section is required and must contain at least one entry. New locations are created when the ThirdpartyID does not match an existing location. Locations that have an existing ThirdPartyID will be updated. Locations that have been previously imported but that are not included in the XML file, will be deleted or made inactive if the account has Lead Manager service.

Field name

Required/Optional

Description

ThirdPartyID

Required

This is your own ID. This must be a unique key field. It is used to control adds/edits/deletes. If this field matches a location currently in Bullseye, that location will be updated. If not, then this will be an insert. (At the end of the process, any remaining locations in Bullseye that were not updated are assumed to be deletes.)

Name

Required

Location name

CountryCode

Required

It accepts ISO alpha-2 country code, ISO3Code, Name and AlternateNamesAndCodes. See codes

InternetLocation

Required

A boolean value specifying if this location is only an internet location and not brick and mortar. If this is brick and mortar set the value to "false."

LeadManager

Required

a boolean value specifying whether or not this location should be used with the LeadManager service. Set this value to false if you do not subscribe to LeadManager. If you specify true for this value and provide an e-mail address, the e-mail address will be used as the contact e-mail address for the location.

StoreLocator

Required

A Boolean value specifying whether or not this location should show in the store locator. You must specify true for StoreLocator, LeadManager, or both.

Active

Optional

Controls whether a location shows up in search results. Default value is "True"

ID

Optional

This is the Bullseye location ID. This field is currently ignored.

LocationType

Optional

Should correspond to one of your valid location types, e.g. “Standard”.

StateAbbr

Rules vary

Our Codes and Values section includes specifications for States and Provinces based on country.

ContactName

Optional

Use this to provide contact information for the location.

ContactPosition

Optional

Use this to provide contact information for the location.

ContactURL

Optional

Use this to provide contact information for the location.

TimeZoneID

Optional

Use this to specify a time zone for your location (must be the Bullseye ID for the time zone.)

MondayOpen - SundayClose

Optional

These fields should contain valid time strings with seconds in military time, e.g. “09:00:00”, “05:00:00”, "17:30:00", etc.

Latitude/Longitude

Optional

If the geocodes for a location are known, enter them here. Be sure to limit each value to 6 decimal places.

ImageURL

Optional

Use this field if there is a preview image you wish to associate with the location.

YelpPlaceID

Optional

Use this field to specify the location's Yelp ID when the Reviews module is enabled.

GooglePlaceID

Optional

Use this field to specify the location's Google Place ID when the Reviews module is enabled.

Territory

Optional

Specify valid Bullseye territory names here.

Attribute

Optional

See the subsection for how to specify attributes for a location.

Category

Optional

Pass in the unique category name or ID for every category to which you will be assigning this location.

SEO

Optional

This allows a title and description to be put in for a location which will show up in search engines for that location's landing page.

LandingPageImage

Optional

Add images which will be associated with the landing page for this location.

SocialMediaLinks

Optional

Use this tag to specify social media ID's for a location. The URL for each social media type is not required. If a location does not have any social media ID's then this section can be omitted. The XML Sample Data File has examples of various social media types.

LocationGroup

Optional

Use this tag to assign a location group to a location.

The following sections are blocked from being updated by default:

SEO
LandingPageImage
SocialMedialLinks
LocationGroup

If you wish any of these sections to be updateable, contact us at Bullseye and your XML Import can be configured to allow those to be overwritten.

Note: Coupons and Events are not included in the XML import and therefore their association with locations will not be overwritten.