Connecting Seller Central (SP-API) for Total Sales metrics

Connecting your Seller Central account via the Selling Partner API (SP-API) unlocks a set of metrics that the Advertising API alone cannot provide — including Total Sales, Sessions, Buy Box percentage, TACoS, and organic sales. This guide walks you through the connection process, explains what data becomes available, and covers what to expect once the link is active.

Note: You need an active Amazon Ads Optimiser subscription and at least one Amazon Advertising account already connected to 1smart.link. You also need login credentials for the Seller Central account that owns the products you advertise.

Why SP-API matters

When only the Advertising API is connected, your dashboard shows ad-specific metrics: Ad Spend, PPC Sales, ACoS, impressions, and clicks. These are valuable, but they only tell half the story.

SP-API pulls data directly from Seller Central, giving you the full picture — how much total revenue your products generate, how many shoppers visit your listings, and how efficiently your ad spend drives overall sales (not just attributed PPC sales). Without this connection, metrics like TACoS and Organic Sales display as — on your dashboard.

What metrics SP-API unlocks

Once connected, the following metrics populate across your dashboard:

Metric	What it measures
Total Sales	PPC sales + organic sales combined
Total Orders	PPC orders + organic orders combined
Sessions	Unique shopper sessions on your product detail pages
Buy Box %	Percentage of page views where you held the Buy Box
Listing CVR	Conversion rate — Total Orders ÷ Sessions
TACoS	Total Advertising Cost of Sales — Ad Spend ÷ Total Sales
Organic Sales	Total Sales minus PPC Sales
PPC Dependency	Percentage of your total sales that come from ads
Per-ASIN TACoS	TACoS broken down for each individual product

These metrics help you understand how your advertising investment affects your overall business — not just the clicks and sales directly attributed to ads.

Connect Seller Central step by step

1. Log in to your 1smart.link dashboard and navigate to Dashboard → Ads.

1. Click the account dropdown in the top bar. This is the same dropdown you use to switch between advertising accounts.

1. Look for the Connect Seller Central option. If your Seller Central account is not yet linked, this option appears in the dropdown list.

1. Click Connect Seller Central. A new window or tab opens, taking you to Amazon's SP-API authorisation flow.

1. Log in to Seller Central using the credentials for the account that owns the products you want to track. Use the same marketplace account that matches your connected Advertising account.

1. Review the permissions Amazon displays. These cover the Selling Partner API access scope, which allows 1smart.link to pull sales and traffic reports on your behalf.

1. Click Approve (or the equivalent confirmation button Amazon presents) to grant access.

1. Amazon redirects you back to 1smart.link. The redirect happens automatically — do not close the browser tab while it is in progress.

1. Once the redirect completes, 1smart.link securely stores your authorisation tokens (encrypted) and records your Seller ID. You do not need to copy or paste any tokens manually.

1. A background process immediately begins pulling your initial data — the last 14 days of sales and traffic reports. This typically takes 1–3 minutes.

1. When the pull is complete, your dashboard refreshes to show Total Sales, Sessions, Buy Box %, Listing CVR, TACoS, and the other SP-API metrics alongside your existing advertising data.

Tip: You do not need to refresh the page manually. The dashboard updates once the background fetch finishes. If the metrics still show — after five minutes, try a hard refresh of your browser.

How data is pulled and stored

Understanding how the data pipeline works helps set expectations about freshness and availability.

Report endpoint: 1smart.link uses Amazon's GET_SALES_AND_TRAFFIC_REPORT endpoint to retrieve daily aggregated data, broken down by date and ASIN. This is the same data you would see in Seller Central's Business Reports section.

Initial pull: On first connection, the system performs a 14-day lookback. This gives you an immediate baseline of recent performance to work with.

Ongoing pulls: After the initial fetch, data is pulled daily as part of the standard report processing cycle. Each day's data is stored with a unique combination of your account and the report date, ensuring no duplicates.

Historical data: Amazon's GET_SALES_AND_TRAFFIC_REPORT makes up to two years of historical data available. However, 1smart.link pulls daily data from the day of first connection forward. The automatic backfill covers only the initial 14-day window — historical data beyond that period is not fetched automatically.

What the SP-API nudge banner means

If you have not yet connected Seller Central, you may notice a banner on your dashboard reminding you that your account is running with the Advertising API only. This is the SP-API nudge banner.

The banner is informational and dismissible — you can close it if you prefer to connect later. It simply highlights that TACoS, organic metrics, and session data are unavailable until the SP-API connection is made.

Your advertising metrics (ACoS, Ad Spend, PPC Sales, impressions, clicks) continue to work normally regardless of whether SP-API is connected.

What happens next

Once the connection is active and the initial 14-day pull completes, your dashboard displays the full set of metrics listed above. Daily data continues to arrive automatically — no further action is needed from you.

You can now:

• Track TACoS alongside ACoS to understand how efficiently your ad spend drives total revenue.
• Monitor Organic Sales to see whether your advertising is lifting organic performance.
• Review PPC Dependency to assess how reliant your business is on paid traffic.
• Analyse Listing CVR and Sessions to identify product pages that need optimisation.
• View per-ASIN TACoS to pinpoint which products benefit most from advertising.

Troubleshooting

Metrics still show "—" after connecting

The initial data pull takes 1–3 minutes. If metrics remain blank after five minutes, try a hard refresh (Ctrl+Shift+R or Cmd+Shift+R). If the issue persists, the SP-API authorisation may not have completed — repeat the connection steps above.

"Connect Seller Central" option does not appear

This option only appears if no Seller Central account is linked to the selected advertising account. If you have already connected, the option will not show. Switch to a different advertising account in the dropdown to check whether that account needs connecting.

Authorisation fails or Amazon shows an error

Make sure you are logging in to the correct Seller Central account — the one that owns the products in the marketplace matching your connected Advertising account. If you manage multiple marketplaces, confirm you are authorising the right one.

Data appears incomplete or covers fewer than 14 days

If your Seller Central account is newer or has limited sales history, the 14-day lookback may return fewer days of data. This is normal — daily pulls will continue to accumulate data going forward.

Still stuck? Contact support through your 1smart.link dashboard or email the team directly. Include your account email and the marketplace you are trying to connect.

Related articles

• Article #31
• Article #32
• Article #37