# Paywall Parity Guidelines

Practical public articles about regional Google Play pricing and Paywall Parity.
Account-specific operating guides are available in the dashboard.

## Start here

What the product does, how to get a first result, and what it will never do behind your back.

- [What Paywall Parity does](/guidelines/overview) — The closed pricing loop, what each stage is responsible for, and which stages are live today.
  markdown: /guidelines/raw/overview
- [Your first pricing matrix](/guidelines/quickstart) — Connect Google Play, import a catalogue, and read a full regional matrix. Roughly fifteen minutes, no store writes.
  markdown: /guidelines/raw/quickstart
- [The safety model](/guidelines/safety-model) — Every rule that stands between a calculation and a real price change, and why each one exists.
  markdown: /guidelines/raw/safety-model

## Concepts

The vocabulary every screen uses: baselines, parity targets, strategies, rounding, confidence, drift.

- [Store baselines](/guidelines/store-baseline) — What Google's own converted price is, why it is shown beside your price, and every reason the column can be blank.
  markdown: /guidelines/raw/store-baseline
- [Parity targets](/guidelines/parity-target) — How a recommended regional price is derived, from purchasing-power data through dampening, bounds, and rounding.
  markdown: /guidelines/raw/parity-target
- [Strategies](/guidelines/strategies) — The three strategy presets, the exact intensities and bounds behind each, and how to choose between them.
  markdown: /guidelines/raw/strategies
- [Confidence](/guidelines/confidence) — How the confidence score is computed, the thresholds that gate a recommendation, and when the system abstains entirely.
  markdown: /guidelines/raw/confidence
- [Drift](/guidelines/drift) — The four drift severity bands, what triggers each, and why an exchange-rate movement can never authorize a store write.
  markdown: /guidelines/raw/drift
- [Protected markets](/guidelines/protected-markets) — Markets whose price is held regardless of what the strategy computes, and how to tell a real recommendation from a data artifact.
  markdown: /guidelines/raw/protected-markets

## Workflows

The operating loop, one task at a time, from connecting a store to measuring what a change did.

- [Connecting Google Play](/guidelines/connect-google-play) — The eight steps from a service-account key to an imported catalogue, and what to check when one of them fails.
  markdown: /guidelines/raw/connect-google-play
- [Reviewing recommendations](/guidelines/review-recommendations) — How the inbox is ordered, what makes an item approvable, and what approval does and does not do.
  markdown: /guidelines/raw/review-recommendations
- [Staging and publishing](/guidelines/dry-run-and-publish) — How a deployment draft is built and validated, what publishing does, and how a write is verified.
  markdown: /guidelines/raw/dry-run-and-publish
- [Price history and restoring original prices](/guidelines/price-history) — Every price a market has had since import, who changed it, and how to return a plan family to its original prices.
  markdown: /guidelines/raw/price-history

## Reference

Exact formulas, inputs, statuses, and error codes. Look things up here rather than inferring them.

- [Pricing formulas](/guidelines/pricing-formulas) — The exact arithmetic behind a parity target and a confidence score, with every constant and weight stated.
  markdown: /guidelines/raw/pricing-formulas
- [Error codes](/guidelines/error-codes) — Every error code the application surfaces, what actually caused it, and what to do about it.
  markdown: /guidelines/raw/error-codes
- [Terminology](/guidelines/terminology) — The words the product uses, and how each differs from the one it is most often mistaken for.
  markdown: /guidelines/raw/terminology

## Integrations

What each provider supplies, what it is allowed to change, and where its limits are.

- [Google Play](/guidelines/google-play) — The Android Publisher endpoints used, the scope and permissions required, and the limits of what the provider can do.
  markdown: /guidelines/raw/google-play
- [Apple App Store](/guidelines/apple-app-store) — Connect App Store Connect to import an iOS app's subscriptions and current regional prices in read-only mode.
  markdown: /guidelines/raw/apple-app-store
- [Revenue signals](/guidelines/revenue-signals) — What the RevenueCat connection measures today, how coverage is reported, and why its ROI remains directional.
  markdown: /guidelines/raw/revenue-signals

## Trust and operations

Permissions, credential custody, retention, audit records, and how failures are reported.

- [Credential custody](/guidelines/credential-custody) — Where store credentials live, what the application database holds, and why authenticated calls execute outside it.
  markdown: /guidelines/raw/credential-custody
- [Methodology and sources](/guidelines/methodology) — Where the economic data comes from, how coverage and freshness are handled, and which markets cannot be analyzed.
  markdown: /guidelines/raw/methodology
- [Audit log](/guidelines/audit-log) — What the workspace audit log records, who can see it, how long it is kept, and how to export it.
  markdown: /guidelines/raw/audit-log