Getting started

Getting started

The goal of the first session: connect your Amazon Associates account, cache a product, drop a shortcode on a post, and confirm clicks track.

1. Configure your Associates program

Oamazon -> Settings -> Amazon Associates Programs.

For each region you sell in:

1. Pick a Locale from the dropdown (US, UK, DE, FR, IT, ES, JP, AU, IN, BR, MX, SG, AE, NL, SE, TR, PL, CA - 18 in total).
2. Enter your Associates ID (the partner tag, e.g. mysite-20).
3. Enter the TLD (e.g. .com, .co.uk).
4. Enter your API Key and API Secret from the PA API console.
5. Check Active.
6. Save.

Without a configured program, OAM_API::get_items() returns WP_Error: oam_no_program.

2. Set general settings

Under Settings -> General Settings:

• Default Locale: fallback when geo routing can't detect visitor country.
• Link Prefix: URL segment for cloaked links (default go, so links resolve at /go/<slug>/).
• Geo Routing: enable to redirect international visitors to their local Amazon storefront.
• Click Retention (days): how long click events stay in oam_clicks.

Under Settings -> Revenue Estimate:

• Commission Rate (%): default 4. Used to estimate earnings.
• Conversion Rate (%): default 10. Used to estimate orders from clicks.
• Avg Order Value Low/High ($): bounds for revenue estimates.

3. Add a product

Products tab -> Add Product. Enter an ASIN (10 chars, e.g. B08N5WRWNW). OAmazon calls the PA API, caches the response in oam_products, and shows the product card.

Product data refreshes every 24 hours by default via OAM_Cron.

4. Render a product in a post

Shortcodes:

[oam_product asin="B08N5WRWNW" display="card" style="light"]
[oam_button asin="B08N5WRWNW" text="Buy on Amazon"]
[oam_price asin="B08N5WRWNW"]
[oam_disclosure context="post"]

For multi-product displays, save a Display first under the Displays tab, then embed it:

[oam_display id="5"]

5. Verify

1. Visit the post in an incognito window. Click the affiliate button.
2. The URL should be a cloaked /go/<slug>/ link that 302-redirects to Amazon with your associate tag appended.
3. Analytics tab should show a click event within a few seconds.