Setup guide
Ten minutes from download to your first fix list. The full guide with troubleshooting is the PDF in your download.
Before you start
- Your Amazon Associates tracking ID, for example
mysite-20. How to find it. - Your Affiliwatch licence key, from your Gumroad receipt.
- Creators API keys for stock checks, if you have them. How to get them. Without them, tag and link checks still run.
WordPress
- Unzip the Gumroad download. Inside is
affiliwatch-wordpress-plugin.zip. - In WordPress open Plugins → Add Plugin → Upload Plugin, choose that zip (don't unzip it), click Install Now, then Activate.
- Open Affiliwatch → Settings. Paste your licence key under Licence and click Activate.
- Add your tracking IDs, one per line. Add
= amazon.co.ukafter a tag that belongs to one store. - Paste your Credential ID and Secret into the row for your region: North America for credential version 3.1, Europe and India for 3.2, Far East for 3.3. Click Save settings, then Test connection.
- Click Run a check now. A site with 500 Amazon products takes about a minute.
Keys can go in wp-config.php instead of the database:
define( 'AFW_LICENSE_KEY', '…' );
define( 'AFW_NA_ID', '…' );
define( 'AFW_NA_SECRET', '…' );
Next.js, Astro, Hugo and static sites
- Unzip
affiliwatch-any-website.zipinto the top folder of your project. - Run
node affiliwatch/bin/affiliwatch.js init. It createsaffiliwatch.config.jsonand a GitHub workflow. - Put your tracking IDs in
"tags"inaffiliwatch.config.json. - Create
.env.affiliwatchnext to it. It is ignored by git; never commit it.
AFFILIWATCH_NA_ID=your credential id
AFFILIWATCH_NA_SECRET=your credential secret
AFFILIWATCH_LICENSE_KEY=your licence key
- Run
node affiliwatch/bin/affiliwatch.js activate, thentest, thencheck, and open.affiliwatch/report.html. - For the daily run, add the same three values as GitHub repository secrets, commit
affiliwatch/,affiliwatch.config.jsonand.github/workflows/affiliwatch.yml, and push.
What the statuses mean
| Status | What Amazon said | What to do |
|---|---|---|
| Out of stock | Can't be bought right now | Replace it, or wait for stock |
| No offer to buy | The page exists but nobody sells it | Replace it |
| Not a real product ID | Amazon doesn't know this ID | Fix the typo |
| No data from Amazon | Amazon won't report on it | Open the link and decide (why this happens) |
| Low stock, pre-order, watching | For information | Nothing yet |
Help
Reply to your Gumroad receipt with a screenshot of Settings (WordPress) or the output of check (any-website edition).