Proper country/tag mapping prevents broken affiliate attribution and low-converting cross-country sends.
When to Use This Guide
Use this before publishing new monetized content, changing integrations, or troubleshooting connection issues.
Before You Start
- You are logged into WordPress with an Administrator account.
- You can access PassiveWP -> Settings.
- You have any required keys or partner credentials ready.
Exact Menu Path
WordPress Admin -> PassiveWP -> Settings -> Amazon
Step-by-Step Walkthrough
Step 1: Set your default country to your primary buyer audience.
Go here WordPress Admin→PassiveWP→Settings→Amazon
Do this In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
Confirm No blocking error banner appears, and the next step is available.
Step 2: Add partner tags for every country you actively target.
Go here WordPress Admin→PassiveWP→Settings→Amazon
Do this In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
Confirm New rows should appear in the list and be editable.
Step 3: Set a default partner tag for fallback behavior.
Go here WordPress Admin→PassiveWP→Settings→Amazon
Do this In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
Confirm No blocking error banner appears, and the next step is available.
Step 4: Validate country-specific tags using the Amazon test tool.
Go here WordPress Admin→PassiveWP→Settings→Amazon
Do this In WordPress Admin→PassiveWP→Settings→Amazon, set "Default Country" and "Default Partner Tag", then confirm each marketplace row has the correct partner tag.
Confirm Check API Connections should show successful status with no country-level errors.
Step 5: Click through links from a VPN or test environment for key regions.
Go here WordPress Admin→PassiveWP→Settings→Amazon
Do this In WordPress Admin→PassiveWP→Settings→Amazon, click "Check API Connections" and wait for the status table to finish.
Confirm Check API Connections should show successful status with no country-level errors.
Quick Troubleshooting Checks
- Re-open the same settings tab and confirm values are still present.
- Run the built-in test for that integration (Amazon/OpenAI/MaxMind).
- If a key is defined in wp-config, update it there instead of the UI field.
Common Mistakes to Avoid
- Leaving defaults in place without checking if they match your niche.
- Ignoring failed connection tests before publishing monetized content.
- Using invalid or expired credentials and expecting background jobs to recover.
Success Checklist
- Connection test returns success.
- Defaults match your target country and monetization style.
- A test post renders correctly on desktop and mobile.
Pro Tips for Affiliate Marketers
- Re-test credentials after rotating keys.
- Keep credentials in one secure document so your team stays synced.
- Review settings monthly, especially before seasonal campaigns.
If You Get Stuck
Open the matching troubleshooting article in this help center and repeat one step at a time instead of changing multiple settings at once.
