Settings & Configuration
Store Mappings
Mapping integrations and data to your store allows AIQ to connect the dots and translate that data into information you can use within your AIQ account. If you are a multi-store account, this helps AIQ identify your shopper's favorite store and how to send them the right messages.
Until a data source or POS connection is mapped to a location, AIQ cannot attribute its data to the correct store.
Within 24 hours of linking to a new integration or adding a new connection, you should be prompted to map the new data source or destination to a store via your Retail Store Settings.
â ď¸ Order of operations matters. You must enter your POS credentials on the integration card before creating the new location in AIQ. If you create the location first, the Store Mappings prompt will not appear and the new location will not be linked to your POS data source.
â ď¸ Warning: Newly added integrations and stores will typically sync overnight. If your integration is not currently active and you are not seeing any information from your integration partner in 24 hours, you may need to create a test transaction to start the syncing process.
To map a location: go to Settings > Company Account > Retail Locations, select the location you want to map, find the Store Mappings section listing your connected integrations, then click the empty field next to the integration's symbol and choose the correct data source from the dropdown. Save, and repeat for any additional locations you add to the account. The exact navigation (tab name, icon, or step order) can vary slightly by integration â check your specific integration's connection article if this doesn't match what you see.
Store Review Links
Populate the shopper's favorite store-specific links to leave their review where it matters, when that information is available from the social partner.
The review widget, native app, and web wallet will populate the shopper's favorite store-specific pages when applicable.
â
Troubleshooting Store Mapping Issues
Store Not Available for Mapping
If a newly added POS store does not appear for location mapping, ensure that:
The API key for the store has been added.
At least one sale has been completed using that API key.
Allow up to 24 hours for the integration to sync.
You're getting an "unmapped stores" notification
Once data starts coming through from your POS, you must map the API key to the store to assign a favorite store to shoppers. Follow the steps in How to Map a Location above.
Mapping looks correct, but data still isn't syncing or reporting correctly
Go to Settings > Company Account > Retail Locations and confirm the correct store is mapped to the appropriate API key and location.
Double-check that the store address, online menu/shop URL, and API key mapping all match your POS system exactly â even small mismatches can cause syncing or reporting issues. The online menu/shop URL must be the direct menu link, not your homepage.
Allow time for initial data synchronization after setup, then check your reports to confirm sales data is being captured.
If data is still missing or incorrect, recheck the mapping and credentials with your POS provider.
Best Practices for Managing Location Mappings
Avoid manual deletions: Do not delete store mappings unless explicitly instructed by support, as this can disrupt data attribution.
Allow processing time: Be patient after making changes or uploading data, as the system needs time to process updates.
Verify with your POS provider: Ensure your POS provider has correctly configured integration keys and other settings to avoid mapping issues.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.