Skip to content

Documentation

Your first sync

What the extension is doing while you wait, and the three screens worth opening when it stops.

The first sync is the long one. It reads your whole sales history and as much advertising history as Amazon will give it, and on a large catalogue that is not a thirty-second job. Later syncs are incremental and quick.

What it is doing

Three lanes, running together:

  1. Your listings — every design, in every marketplace, in every product type.
  2. Your sales — day by day, per marketplace, with the royalty each sale actually paid.
  3. Your advertising — campaigns, ad groups, targets, search terms, and what each of them spent.

The Data health tab shows this happening, and it is worth watching once so the vocabulary makes sense later.

One thing that will look wrong and is not

Advertising history does not go back as far as sales history. Amazon serves roughly the last 90 days of daily advertising data — a window that always ends today and rolls forward with it, and one that starts at a different point in each marketplace. Search terms reach back a shorter 65 days, and have no deeper history behind them at all.

So a product can show two years of sales beside three months of ad spend. That is the data Amazon gives, not something the extension failed to fetch.

A day with no spend recorded is not the same as a day with no advertising. The extension is careful never to present the first as the second — before the window opens, a zero means not known, not no ads ran.

Days that are not finished

A day is only counted as complete once it has actually ended in Los Angeles — the timezone Amazon's own reporting uses, and the one every day boundary in the extension is measured in — and the extension has fetched it afterwards. Today's numbers move; yesterday's usually do not.

This is why comparisons in the app only ever compare equal counts of complete days, and why "today" never gets a comparison at all — there is no hour-of-sale data to compare it against.

The three screens to open first

Overview — the money, by period and marketplace. Start here to see whether the sync found what you expected.

Catalog — every design and where it exists. The interesting column is the one showing where it does not: markets and product types your design is missing from.

Advertising — the console, down to the search term. The column that makes it different from Amazon's own is break-even ACoS: what each product can afford, computed from its real royalty.

The Data health and sync page goes further into all of this: what runs when, what the two sync screens each show, and why a number moves.

Next

Nothing reaches Amazon without your approval — worth reading before you touch anything, because it explains the one mechanism every change in the product goes through.