What is captured?
Every app is scheduled daily against the grossing chart and against its own free or paid chart, depending on its price. Each observation records the app, the date, the collection and the genre.
Capture is home market only in v1, like snapshots and reviews. See Countries and markets.
Read the chart
Chart positions use the same convention as keyword positions: 1 based, with an absent position meaning the app was not found within the captured chart depth rather than zero. See Positions and rank depth. Read a chart movement against your keyword positions on the same dates. A chart fall with stable keyword positions usually points at conversion or at a competitor’s promotion rather than at your metadata.What does it cost?
Two jobs per app per day, because every app is scheduled against the grossing chart as well as its own free or paid chart. That is roughly twice the count of price collection alone. Category jobs remain the smallest slice of the daily budget, and the settings budget card reports the real number. See The daily pipeline and rate limits.How long are they kept?
RETENTION_CATEGORY_RANKS_DAYS defaults to 365 days. Set it to 0 to keep chart history forever.
Troubleshooting
- No chart position at all. The app is outside the captured chart depth for that category, which is common outside the top categories.
- The app appears on the grossing chart but not the free chart. A paid app is charted against paid and grossing, not free.
- A gap in the history. The daily job for that date failed and its retries were exhausted. Check the queue dashboard at
/admin/queues.
Related
Read rankings and SERPs
Keyword positions over the same dates.
Compare a portfolio
Roll several apps up into one view.