Walmart Connect
Connect Walmart Connect for Sponsored Products and Sponsored Brands performance, plus Walmart Marketplace orders and inventory.
Walmart Connect is Walmart's retail media platform. Meerkats imports Sponsored Products and Sponsored Brands campaigns with daily performance, keywords and item-level results, and, with Walmart Marketplace connected, the orders and inventory behind them.
| How it connects | API key |
| Reads | Campaigns, ad groups, Keywords and items, Daily reports, Marketplace orders and inventory |
| Can change | Pause or enable a campaign, ad group or keyword; Change a budget or bid; Add keywords or items to a campaign |
| Refresh | On your plan's schedule, plus Resync anytime |
Before you start#
- A Walmart Connect advertiser account and the advertiser ID.
- API access requested from Walmart Connect for Meerkats (Walmart issues a client ID and secret per advertiser).
- For orders and inventory, a Walmart Marketplace seller account with API keys.
Permissions#
What Meerkats needs, and why.
| Permission | Why Meerkats needs it |
|---|---|
Walmart Advertising API | Read campaigns, ad groups, keywords, items and reports; make changes you approve |
Walmart Marketplace API: Orders | Read marketplace orders |
Walmart Marketplace API: Inventory | Read stock per item |
Connect#
1. Connect Walmart Connect#
- Get API credentials
In Walmart Connect, request API access and note the advertiser ID, client ID and client secret. For Marketplace, create a key pair under Settings › API.
- Open Integrations
In Meerkats, select Integrations, find Walmart Connect and select Connect.
- Paste the credentials
Enter the advertiser ID, client ID and secret, and optionally the Marketplace keys. Meerkats stores them encrypted.
- Resync
Go to Data Hub › Bronze Layer, pick Walmart and select Resync.
What syncs#
| Walmart Connect | In Meerkats |
|---|---|
| Campaigns, ad groups | Campaign type, status, budget (daily and total), bidding, placement settings, schedule |
| Keywords and items | Keyword, match type, bid, status; advertised items |
| Daily reports | Campaign, keyword, item, placement and page-type performance by day |
| Marketplace orders and inventory | Orders and line items, stock per item |
Raw data lands in Data Hub › Bronze Layer. Modelled tables, with metrics defined once, are in Data Hub › Gold Layer. Every number in a report or an agent’s answer comes from a query on these tables, never from the model’s own arithmetic.
Metrics you get#
The metrics people ask for most, named as Walmart Connect names them. The full list, with each definition, is in the metric catalog.
Ad spendAttributed salesROASOrdersUnitsImpressionsClicksCTRCPCConversion rate
How often it syncs#
Meerkats syncs on your plan's schedule: daily on Free, hourly on the $49 plan, every 30 minutes on $149 and every 15 minutes on $399. You can run a sync at any time with Resync in Data Hub › Bronze Layer.
- Walmart attributes sales in a 14-day window by default. Reports restate for several days; each sync re-imports them.
What Meerkats can change#
In every connected tool, Meerkats can create, read, update and delete records, within the permissions you grant and the permissions the tool allows. These are the changes it proposes for Walmart Connect, and the limit that applies to each.
| Change | Limit |
|---|---|
| Pause or enable a campaign, ad group or keyword | Medium risk: always proposed for approval |
| Change a budget or bid | Budget down up to 20%, up to 50% per week; bid up to 15% |
| Add keywords or items to a campaign | Proposed for approval |
How every change is governed
Every change starts as a proposal in your Inbox. Nothing changes in the connected tool until a person approves it, unless you set that rule to act on its own.
Before it runs an approved change, Meerkats re-reads the live value. If the value moved since the proposal, it asks again instead of acting on stale data.
Meerkats stores the value it replaced, so every change can be undone from Agents run history.
Anything Meerkats creates starts paused. Switching it on is a second, separate approval.
Troubleshooting#
Credentials rejected
Walmart issues separate credentials for the Advertising and Marketplace APIs. Check you pasted each into the right field, and that the advertiser ID matches the account the client ID was issued for.