How to Test Paywalls with Local Currency for a Specific Country
Learn how to preview your paywall as a user in a specific country would see it, including local currency and audience matching.
When you create a campaign that targets users in a specific country, you may want to preview the paywall as those users would see it, with their local currency instead of your default. This requires two changes on your test device: matching the audience filter and changing the displayed currency.
Matching country-based audience filters
If your campaign uses device.storeFrontCountryCode to filter by country, your test device must report that same country to match the audience. On iOS, change your App Store region:
- Open Settings on your device.
- Tap your Apple ID at the top.
- Go to Media & Purchases and tap View Account.
- Tap Country/Region and select the country you want to test.
Changing your App Store region may require you to update your payment method to one valid in that country. You can switch back after testing.
If your campaign uses device.deviceLocale instead (e.g. en_GB, fr_FR), change the device locale in Settings > General > Language & Region to match the target locale.
Displaying local currency
The currency shown on your paywall is determined by the App Store storefront country, not the device locale. To see prices in the currency a user in that country would see, change your App Store region using the steps above.
The App Store returns product prices in the currency of the storefront country. For example, if your App Store region is set to France, prices will appear in EUR. If set to Japan, prices will appear in JPY.
The actual price amount is determined by what you have configured in App Store Connect for each territory. The storefront country controls which currency and price tier is used.
Summary of required changes
| What you want to test | What to change | Where to change it |
|---|---|---|
Match a storeFrontCountryCode audience filter | App Store country/region | Settings > Apple ID > Media & Purchases > View Account > Country/Region |
Match a deviceLocale audience filter | Device locale | Settings > General > Language & Region |
| See prices in local currency | App Store country/region | Settings > Apple ID > Media & Purchases > View Account > Country/Region |
If your campaign uses storeFrontCountryCode, changing the App Store region handles both matching the audience filter and displaying the correct local currency in one step.
How is this guide?
Edit on GitHub