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.
Updated about 4 years ago