Affiliwatch Get Affiliwatch

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

  1. Unzip the Gumroad download. Inside is affiliwatch-wordpress-plugin.zip.
  2. In WordPress open Plugins → Add Plugin → Upload Plugin, choose that zip (don't unzip it), click Install Now, then Activate.
  3. Open Affiliwatch → Settings. Paste your licence key under Licence and click Activate.
  4. Add your tracking IDs, one per line. Add = amazon.co.uk after a tag that belongs to one store.
  5. 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.
  6. 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

  1. Unzip affiliwatch-any-website.zip into the top folder of your project.
  2. Run node affiliwatch/bin/affiliwatch.js init. It creates affiliwatch.config.json and a GitHub workflow.
  3. Put your tracking IDs in "tags" in affiliwatch.config.json.
  4. Create .env.affiliwatch next 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
  1. Run node affiliwatch/bin/affiliwatch.js activate, then test, then check, and open .affiliwatch/report.html.
  2. For the daily run, add the same three values as GitHub repository secrets, commit affiliwatch/, affiliwatch.config.json and .github/workflows/affiliwatch.yml, and push.

What the statuses mean

StatusWhat Amazon saidWhat to do
Out of stockCan't be bought right nowReplace it, or wait for stock
No offer to buyThe page exists but nobody sells itReplace it
Not a real product IDAmazon doesn't know this IDFix the typo
No data from AmazonAmazon won't report on itOpen the link and decide (why this happens)
Low stock, pre-order, watchingFor informationNothing yet

Help

Reply to your Gumroad receipt with a screenshot of Settings (WordPress) or the output of check (any-website edition).