Store Catalog

The Store Catalog is the master list of all physical and digital store locations in Loyal Guru. It powers store-level targeting in campaigns, audience conditions, and performance reporting. Every purchase sent via the Streaming API includes a store_id that maps to an entry in this catalog.

What You Can Do

Capability	Benefit
Create and manage store locations with addresses and contact details	Enables accurate store-level campaign targeting and reporting
Assign stores to categories and taxonomies	Unlocks store-category conditions in the audience builder and campaign delivery
Mark stores as active or inactive	Ensures campaign delivery excludes closed or inactive locations

How It Works

1. Store locations are loaded during onboarding from your store master data.
2. Each store has attributes (region, format, franchise) that are used as targeting conditions in campaigns and audiences.
3. When a cart event is sent via the Streaming API, it includes a store_id that maps to this catalog entry.
4. Campaign reports and audience counts automatically filter by the store's attributes.

---

Stores

Go to Company Data → Stores Catalog → List tab.

Fields

Field	Description
ID	Unique identifier assigned to each store.
Code	Alternative alphanumeric identifier for the store.
Name	The store's name.
Address	Street address.
State	State or region.
City	City.
Postal Code	Postal/ZIP code.
Country	Country. Select from the dropdown menu.
Longitude	Geographic coordinate (longitude).
Latitude	Geographic coordinate (latitude).
Schedule	Store working hours.
Status	Active — the store is open for business (regardless of opening hours). Inactive — the store is not currently operating.
Store available for gift cards	Whether the store accepts gift card transactions.
Categorizations	Store category assignments.
Phone	Contact phone number.
Email	Contact email address.
Weekly signups	Expected or tracked weekly loyalty signups at this store.

Searching and viewing stores

1. Go to Company Data → Stores Catalog → List tab.
2. Filter by ID, Code, Name, Postal Code, or Status.
3. Click Search. Results also show Synchro date — the last time the store record was changed or created.
4. Click View to open full store details: address, contact channels, and assigned categories.

Creating a store

1. Go to Company Data → Stores Catalog → List tab.
2. Click Create New Store.
3. Fill in the required fields (see table above).
4. Click Save.

Editing a store

1. From the store list, click Edit on the target row, or open the store details and click Edit.
2. Update any of the available fields.
3. Click Save.

---

Store Categories

Store categories group stores for use as targeting conditions in campaigns and audience segments.

Go to Company Data → Stores Catalog → Categories tab.

Fields

Field	Description
Name	The category's common name.
External ID	The category ID used by the company (not generated by Loyal Guru).
Key	A slug-format identifier (no spaces). Used in the search view.
Taxonomy	The store taxonomy associated with this category.
Store	The list of stores that belong to this category. Select multiple.

Searching and viewing store categories

1. Go to Company Data → Stores Catalog → Categories tab.
2. Filter by Key, Name, or Taxonomy.
3. Click Search. Results show the category's assigned ID.
4. Click View to see full details, including External ID if the category was migrated from an external system.

Creating a store category

1. Click Create New Category.
2. Fill in Name, External ID, and Taxonomy.
3. Add stores by selecting them from the Store dropdown.
4. Click Save.

Editing a store category

From the store category list or details view, click Edit. You can change the Name and the stores belonging to the category. ID and Taxonomy are not editable.

---

Store Taxonomies

Store taxonomies define the classification structure that store categories belong to. Taxonomies must exist before categories can be created.

Go to Company Data → Stores Catalog → Taxonomies tab.

Fields

Field	Description
Name	The taxonomy's common name.
Slug	A slug-format identifier (letters, numbers, underscores, hyphens). Usually matches the name without spaces.

Searching store taxonomies

1. Go to Company Data → Stores Catalog → Taxonomies tab.
2. Filter by Name or Slug.
3. Click Search. Results show a list of matching taxonomies.
4. Click View to see the taxonomy's ID.

Creating a store taxonomy

1. Click Create New Taxonomy.
2. Fill in Name and Slug.
3. Click Save.

Editing a store taxonomy

Only the Name is editable. Slug is fixed after creation.