Walmart Sales Rewards and Attribution

Walmart Sales Rewards and Attribution APIs enable programmatic access to affiliate campaign performance data for offsite traffic driven to Walmart.com. It is designed for sellers and platforms that manage marketing through automated or API-driven workflows and need scalable, reliable attribution and reporting.

This API extends the Sales Rewards and Attribution experience beyond Seller Center by allowing you to retrieve performance metrics directly into your systems, dashboards, and optimization pipelines. It supports both aggregated campaign insights and detailed, item-level attribution data within a specified date range.

Prerequisites

Before using the Walmart Marketplace APIs, ensure that you have:

Seller or approved Solution Provider access to Walmart Marketplace APIs.
Retrieve API keys (clientId and clientSecret) from the Developer Portal and use the keys to call Marketplace APIs.
OAuth 2.0 authentication is required to access the Walmart Marketplace APIs. Ensure that you have obtained the necessary credentials and tokens before making API requests. For more information, refer to OAuth 2.0 authorization.

How to use the Sales Rewards and Attribution APIs

Using the Walmart Sales Rewards and Attribution APIs is a multi-step process that starts in Seller Center and ends with programmatic access to performance and attribution data. The steps below walk through the full lifecycle, from activation to reporting.

Step 1: Activate Sales Rewards in Seller Center

Before any API data is available, you must activate the Sales Rewards program in Seller Center.

Sign in to Seller Center.
Navigate to Sales Rewards.
Complete the program activation flow.

Activation is required before tags, attribution, or reporting data can be generated. For more details, refer to Sales Rewards and Attribution: Overview

Step 2: Retrieve your tag template

Once activated, retrieve your unique tracking tag template using the Tags Template endpoint.

The response includes a URL template with required and optional query parameters.
Each parameter represents an attribution dimension (for example, campaign, ad group, creative, or placement)

You are responsible for populating the template values consistently so downstream reporting aligns with your campaign structure.

Tip: Use stable, human-readable values for campaign and creative identifiers to simplify analysis and reporting.

Step 3: Deploy tags across offsite marketing channels

Use the populated tracking links in your offsite marketing efforts, including but not limited to:

Google Ad Manager
Meta Ads Manager
TikTok Ads Manager
Email marketing campaigns
Influencer marketing
Blogs, vlogs, and other content-driven traffic

All offsite traffic that should be attributed to Walmart Sales Rewards must use the generated tracking links.

Step 4: Allow time for attribution processing

After links are live and generating traffic:

Clicks and conversions are processed asynchronously.
Reporting data becomes available within 48 hours.
Metrics will not appear in campaign or item-level reports before this processing window completes.

Plan reporting jobs and dashboards accordingly.

Step 5: Retrieve campaign-level performance data

Use the performance report endpoint to analyze aggregated performance metrics, such as impressions, clicks, orders, GMV. This endpoint is ideal for campaign and channel optimization, high-level performance reporting, and trend analysis over time. You can filter results by campaign, ad group, or creative to align with your attribution strategy.

Step 6: Retrieve item-level attribution data

Use the item-level report endpoint to understand which products are driving offsite performance.

This endpoint provides:

Item-specific attribution metrics.
Insight into product-level contribution to orders and GMV.
Support for merchandising and catalog optimization decisions.

Item-level reporting complements campaign-level insights and enables deeper performance analysis.

Step 7: Use async reporting for advanced data needs

If your reporting requirements exceed what can be derived from the campaign and item-level endpoints, use the Async reporting APIs. Submit a report request, poll for completion status, and download the generated report once ready. they get details and links on how to leverage async reporting with a step by step guidance.??

Detailed, step-by-step guidance is available in the async reporting documentation.

Market availability

The Walmart Seller Performance API is available for sellers listing in the US marketplace.

Key benefits

The Walmart Sales Rewards and Attribution API helps you scale and automate offsite performance marketing by providing direct access to attribution and performance data.

With this API you can:

Retrieve performance analytics for affiliate campaigns, including clicks, impressions, orders, GMV, conversions, and revenue
Analyze performance at different aggregation levels, such as campaign, ad group, or creative/link
Access item-level attribution data to understand which products are driving offsite revenue
Filter results by campaign, ad group, creative, or item to support targeted analysis
Automate reporting and integrate attribution data into existing marketing and analytics tools

Key data considerations

Reporting data is available for up to the last 12 months
Each request supports a maximum date range of 90 days
Attribution metrics are based on Walmart’s defined attribution model and lookback windows (for example, last-touch 14-day)