About the AIQ <> Meadow Integration
Review our Integration Grid for supported features.
This article covers Meadow connection for AIQ Marketing + Loyalty only. If you are looking for AIQ Ecommerce instructions, see Connect Meadow to AIQ Ecommerce.
How to Connect AIQ with Meadow
Meadow Steps
As an admin with full permissions, navigate to the secret API key creation page: https://admin.getmeadow.com/settings/api/new
Choose AIQ from the dropdown.
Check the box for Analytics Access and Customer Access, as both are required.
Click the purple Create button.
Copy your key. Save it for the next step.
AIQ Steps
Navigate to Settings > Integrations, search for Meadow and click on it to open the integration card.
Fill out the credentials
StoreName: Name assinged to the credentials.
ClientKey: Setup in Meadow
After these are filled in, click the Add Credential button.
Scroll down to the Loyalty section and check off the box next to Required All users from this source have passed an age gate compliant with my industry.
Lastly, click the purple Connect button in the top right. You have now completed the minimum settings needed to connect your integration!
How to Map a Store
Navigate to Settings -> Company Account > Retail Store
Click Edit on the store you wish you map
Under Store Mappings you'll see the Meadow symbol
Click on the empty field to the right of the symbol and a dropdown will appear to "map" the key
Click Save settings and you are done mapping the store. Keep in mind this must be repeated for any additional stores that you add to the account.
AIQ \<> Meadow: User Guide
Opt-In Queue
If you have a waiting room or check-in shoppers with their phone numbers prior to checkout, there is the ability to send a pending request to ask them to join your loyalty & marketing program while at the store.
In order to enable this:
Locate in your AIQ dashboard Settings > Retails Stores
On the store you want to enable, click Edit
Expand Additional Settings
Enable Meadow Opt-in Queue
Save
Redeeming Discounts
All discounts/rewards you want to offer in the wallet to shoppers must be created in AIQ first and then mirrored in Meadow.
Additional AIQ Settings
The following additional settings are available on the Meadow integration card in AIQ. To access them, navigate to Settings > Integrations, locate Meadow and click on it to open the integration card.
Enroll Personas in loyalty program who purchased after
Automatically enrolls shoppers in the loyalty program if they had a sale on or after the date you specify. Enrolled shoppers earn points for sales on or after that date. Takes 24 hours to reflect.
Send SMS double opt-ins to Personas who purchased after
Sends an SMS double opt-in request to shoppers with a phone number who had a sale on or after the date you specify. Takes 24 hours to trigger.
⚠️ Warning: If this setting is removed after it has been set, it can cause loyalty Personas to be lost if they only became a member through this setting and did not use a signup form. We do not recommend changing this after it is set.
Loyalty points imported on
If a date is filled in, AIQ will pull in loyalty points from Meadow up to that date and stop afterwards. Use this in conjunction with Settings > Loyalty > Points accrual start date, setting that to the following day.
ℹ️ Note: This is a one-time sync. Once the date is set and points have been imported, this setting does not need to be updated again.
Mirror integration loyalty point values?
Pulls points from Meadow but keeps loyalty settings managed within Meadow.
⚠️ Warning: When Mirror Points is enabled, AIQ continuously overrides loyalty balances with values coming from Meadow. Freezing or disconnecting the integration will not stop this behavior — it only leaves the last mirrored balance in place.
ℹ️ Note: Points mirroring is not supported by First In, First Out (FIFO) Point Expiration. Please use legacy Points Expiration setting if you would like to Mirror Points from your POS system.
Use AIQ's last backup
Freezes data from this source at the last audience run and stops AIQ from hitting the Meadow API for new data.
⚠️ Warning: Do not turn this on unless you are switching POS systems and want to retain existing data.
FAQs
How long does it take before I start to see my POS data in AIQ?
Within 24 hours, you should see data populating in AIQ
How can I confirm that the integration is active and signups are being sent?
Look under your Personas page in AIQ. The integration is functioning properly if you see "meadow" under the Sourced from column
I am getting an account notification that I have unmapped stores, how can I fix this?
Once you see data coming through AIQ, you must "map" the API key to the store(s) to assign a "favorite store" to the shopper. See How to Map a Store above for directions on how to accomplish this.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.