# App*Sprint* ASO App*Sprint* ASO is the macOS workflow for App Store keyword research, metadata, screenshots, localization, pricing, Apple Ads, and keyword-level revenue measurement. ## Important URLs - App*Sprint* ASO: https://appsprint.app/aso - ASO docs: https://appsprint.app/aso/docs - ASO sitemap: https://appsprint.app/aso/sitemap.xml - Full ASO docs for LLMs: https://appsprint.app/aso/llms-full.txt ## ASO Docs - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. ## Notes for AI assistants - Use the ASO docs for App*Sprint* ASO and Apple Ads return on ad spend setup. - Use the general /docs pages only for the broader App*Sprint* attribution product. - The ASO SDK setup is intentionally focused on Apple Ads install attribution for keyword revenue reporting. --- # Full AppSprint ASO Documentation --- # App*Sprint* ASO: Start here Use App*Sprint* ASO to answer three questions: 1. Which searches are worth chasing? 2. Why do the current winners rank? 3. Do those searches turn into trials, purchases, or revenue once you run Apple Ads, the App*Sprint* SDK, and your revenue provider? ## First 20 minutes 1. Install App*Sprint* ASO for macOS and paste your license key. 2. Click the app picker in the sidebar, choose Add New App, then search by app name or App Store ID. 3. Open Keywords, click the round + button, pick a country, then add 10 to 20 relevant seed keywords. 4. Read estimated downloads, difficulty, current position, top-5 downloads, and top-5 MRR. 5. Open competitors before editing metadata. Check revenue, downloads, ratings, pricing, screenshots, and keyword rankings. ## Setup guides - App*Sprint* SDK: Send Apple Ads install signals so App*Sprint* can connect keywords to trials, revenue, and return on ad spend. - App Store Connect integration: Fetch localizations and edit title, subtitle, and keyword fields. - Apple Search Ads integration: Connect Apple Search Ads so keyword performance includes spend, installs, and revenue context. - RevenueCat integration: Send subscription events to App*Sprint* so Apple Ads keywords can show revenue. - Superwall integration: Send paywall and subscription events to App*Sprint* for keyword revenue reporting. - MCP Server: Let AI assistants read local ASO data and help with metadata. ## Basic clicks - Add an app: Click Select App in the sidebar, click Add New App, search by name or App Store ID, then pick your app. - Choose a country: Use the country button in the toolbar or the country selector in the Add Keywords sheet. - Add keywords: In Keywords, click the round + button. Type one keyword and press Enter, or paste a comma-separated list. - Read the table: Sort by estimated downloads, difficulty, position, top-5 downloads, or top-5 MRR. - Find competitors: Open Competitors, search for an app, and compare revenue, downloads, ratings, screenshots, keyword rankings, and similar apps. ## Keyword rules - Popularity is only a filter. A keyword matters when ranking for it can bring real downloads. - Keep keywords relevant to your app or the problem it solves. - Read keyword and country together. The same keyword can be weak in one country and valuable in another. - Do not kill terms too early. Wait for enough rank movement, taps, installs, or spend. - Use winners in both ASO and Apple Ads. ## Metadata checklist - Title has the most keyword weight. Put the strongest keyword early unless your brand already has search demand. - Subtitle is for the next best phrase, not a vague tagline. - Keyword field is for useful words you did not already use in title or subtitle. - Never repeat the same word across title, subtitle, and keyword field. - Think in combinations. "Daily affirmations" can help rank for "daily", "affirmations", and "daily affirmations". If that phrase has demand and fits the app, it is a better slot than a weak pair such as "kind affirmations". ## Conversion fixes - Use simple screenshots with strong contrast and one clear promise. - Measure current conversion in App Store Connect if you are not running Apple Ads. - Ask for ratings after a positive moment, ideally after a paying user completes a useful action. - If tap-through rate or install conversion is weak, fix the App Store page before raising Apple Ads bids. ## Weekly routine 1. Review rank movement, downloads, MRR, Apple Ads spend, trials, paid conversions, and revenue by keyword and country. 2. Add a few new keywords from competitors, autocomplete, and Apple Ads search terms. 3. Remove keywords that had enough signal and still did not rank, convert, or pay back. 4. Improve one asset: metadata, first screenshot, local pricing, or a campaign structure. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Golden rules Use this as the practical ASO playbook. The goal is not to track every keyword. The goal is to find searches where people care, the current winners are beatable, and your App Store page can make a clearer promise. ## Start with the tool 1. Add one app and one country where users can actually pay. 2. Add 10 to 20 seed keywords from your title, subtitle, keyword field, competitor names, App Store autocomplete, and terms you already want to own. 3. Sort by estimated downloads, difficulty, current position, top-5 downloads, and top-5 MRR. 4. Open competitors before editing anything. 5. Change one thing with a reason: metadata, screenshots, local pricing, ratings flow, or Apple Ads setup. ## Rules that matter most - Downloads beat popularity. Keyword popularity is not enough. Ask what happens if you actually rank. - Country changes the answer. Keyword, country, price, and competitor strength belong together. - Competitors set the bar. Check ratings, revenue, screenshots, and positioning before editing. - Metadata is about combinations. Use title, subtitle, and keyword field to build strong phrases. - Screenshots close the deal. Ranking gets the visit. Screenshots make the user tap and install. - Revenue decides scale. Cheap installs can still be bad users. ## Metadata rules - Title first. Put the strongest keyword early. - Subtitle second. Use it for the next strongest phrase. - Keyword field last. Use the 100 characters for useful words you did not already use. - Never repeat the same word twice across metadata. - Pick the strongest pair around your main word. "Daily affirmations" can cover "daily", "affirmations", and the full phrase. Do not repeat "affirmations" somewhere else just to target it again. - Keep one clear theme. A focused metadata set usually beats a messy list. ## Screenshot rules - The first screenshot should explain the app without swiping. - Use short captions, usually 3 to 7 words. - Show real product proof, not decorative UI. - Compare the current winners. - If you do not run Apple Ads, check current product page conversion rate in App Store Connect before changing screenshots. ## Apple Ads rules - Start with Search Results only. - Turn Search Match off at first. - Add keywords manually and use Exact match while learning. - Keep countries separate when language, purchasing power, or LTV is different. - Judge keywords by trials, paid conversions, revenue, and return on ad spend. CPI is not enough. - Use ads to support the same keywords you care about organically. ## Ratings - More reviews and a stronger rating can improve ranking and conversion. - A good prompt moment is after a paying user completes a useful action. - Do not prompt too early or you may create negative reviews. ## Weekly loop Research, compare, change, measure. Review keyword performance by country, move obvious winners into metadata or tighter Exact campaigns, and cut one weak thing at a time. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Apple Ads playbook Apple Ads works best when it is tied to ASO. Use the same keywords you care about organically, keep the first campaign simple, and scale only when the keyword turns into revenue. ## Benchmarks to watch - TTR around 15 percent can be a good sign that the keyword and creative match the search. - CR above 75 percent is a useful target, but not a universal rule. - If conversion is weak, fix the icon, first screenshot, and first promise before raising bids. - Judge by trials, paid conversions, revenue, and return on ad spend. Cheap installs are not the goal. ## First campaign setup 1. Choose Search Results only. It has the cleanest intent because the user is already searching. 2. Pick countries carefully. Do not put every market into one campaign. 3. Choose Manage bids. 4. Set a daily budget you are comfortable losing while you learn. 5. Start around EUR 0.50 to EUR 1 CPT, or about $1 max CPT. If nothing spends, increase slowly. 6. Use all eligible users and the default ad. 7. Keep the first research setup simple. Once you see signal, split only the winners into tighter campaigns. ## Keyword setup - Disable Search Match at first. - Add keywords manually. - Start from your title, subtitle, keyword field, competitor names, App Store autocomplete, and organic ASO targets. - Switch keywords to Exact match while you are learning. - Test competitor keywords, but judge them by trials and revenue. - Do not scale 50 half-good keywords. Move only the few promising ones into tighter Exact campaigns. ## Daily checks - Impressions: If there are almost none, the bid may be too low or the keyword too narrow. - TTR: Low TTR usually means the keyword, icon, title, or screenshot promise does not match the search. - CR: Low conversion often means the product page is not selling. - Spend and installs: Useful, but not enough. - Trials, paid conversions, revenue, and return on ad spend: These decide whether to scale. ## Optimization loop 1. Run the first pass for about a week. 2. Use the exact keywords you are also testing for organic ASO. 3. Do not kill keywords too early. Early data can lie. 4. Read keyword and country together. 5. Move winners to Exact campaigns. 6. Scale what pays back. ## Budget notes - If Apple offers a $100 credit, use it to learn which keywords and countries deserve more budget. - $300/day is scale context, not a day-one starting point. - A $2K test can produce learning and still hurt short-term profit. - US can be more expensive, but higher LTV can make higher CPA worth it. - A cheap country can still lose money if LTV is low. ## Attribution and revenue Apple Ads gives spend and installs. That is not enough for real scaling decisions. You need trials, paid conversions, revenue, and return on ad spend by keyword and country. App*Sprint* ASO keeps Apple Ads work next to keyword and App Store context so you can compare paid signal with organic targets. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Screenshots Screenshots make the search promise obvious. A good set says what the app does, why it matters, and why this app is worth trying instead of the other apps on the page. ## When to work on screenshots - Taps do not turn into installs. - The first screenshot does not explain the app in one glance. - Competitors make the benefit clearer than you do. ## Build the first three 1. Screenshot 1: main promise. Put the strongest keyword or benefit here. Keep it readable in search results. 2. Screenshot 2: proof. Show the real screen where the user gets the result. 3. Screenshot 3: reason to believe. Show a specific outcome, comparison, saved time, revenue signal, review, or feature that makes the promise feel real. Use later screenshots for secondary features, social proof, pricing clarity, integrations, or advanced use cases. Do not use them as decoration. ## Use competitors first - Open Competitors and search for apps that rank for your target keyword. - Compare the first three screenshots. - Write down their promise, visual style, and proof. - Find the gap your screenshots can own. ## Caption rules - Use 3 to 7 words. - Use real keywords that match the search intent. - Keep contrast high. - Use one idea per screenshot. - Localize captions when the store page is localized. ## Test in App Store Connect If you are not running Apple Ads, use App Store Connect to measure the current product page conversion rate before changing screenshots. Then ship the change and compare the same metric after enough traffic comes through. If you run Apple Ads, check whether better screenshots improve both tap-through rate and install conversion. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Localization and pricing Localization is not just translating English. Pick a country where the keyword has demand, use the words people actually search, and set a price that fits the market. ## When to localize - The keyword has estimated downloads in that country. - Top apps have revenue or pricing that suggests the market can pay. - The product can serve users in that language or country. - You can measure rankings, installs, trials, paid conversions, or revenue. ## Pick the country first 1. In App*Sprint* ASO, use the country button in the toolbar or the country selector in the Add Keywords sheet. 2. Start with one market, not ten. 3. Compare estimated downloads, difficulty, current position, top-5 downloads, and top-5 MRR. 4. Open competitors and compare ratings, screenshots, revenue, pricing, and whether their product is truly localized. ## Localize metadata - Do local keyword research. Do not translate the English keyword list word for word. - Keep the intent the same even if the words change. - Keep title and subtitle within 30 characters each. - Keep the keyword field within 100 characters. - Avoid duplicate words across metadata. - Build local phrases around your main word. The best English combo may not be the best local combo. ## Localize screenshots - Translate every overlay. - Leave room for longer words. - Use local currency, examples, or workflows only when they are true inside the app. - Match the first screenshot to the local search intent. ## Pricing - Start from competitors. - Check purchasing power. - Watch trials, paid conversions, refunds, and revenue. - Change one market at a time. - Pick the highest price that still converts in that country. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Local MCP server App*Sprint* ASO includes a local MCP server so AI assistants can read your tracked apps, keyword metrics, metadata suggestions, Apple Ads insights, and App Store Connect metadata. ## Endpoint ``` http://localhost:9001/mcp ``` In the macOS app sidebar, turn on MCP Server. Keep App*Sprint* ASO open while your assistant uses the server. The server runs locally on your Mac and uses the data already available inside the app. ## Client setup Use the same configuration shown in the app's MCP Server sheet. ### Claude Code ```bash claude mcp add --transport http app-sprint-aso http://localhost:9001/mcp claude mcp list ``` ### Claude Desktop ```json { "mcpServers": { "app-sprint-aso": { "transport": { "type": "http", "url": "http://localhost:9001/mcp" } } } } ``` ### Cursor ```json { "mcpServers": { "app-sprint-aso": { "url": "http://localhost:9001/mcp" } } } ``` ### VS Code ```json { "servers": { "app-sprint-aso": { "type": "http", "url": "http://localhost:9001/mcp" } } } ``` ## Available tools - list_apps: List all tracked apps. - get_app_keywords: Get keywords with metrics. - search_rankings: Keyword position history. - add_keywords: Add keywords to track. - search_app_store: Search the App Store. - set_keyword_note: Set a note on a keyword. - get_metadata_suggestions: Optimization tips per locale. - get_ads_insights: Search Ads bidding insights. - get_metadata: Read App Store Connect metadata per locale. - update_metadata: Edit and save metadata to App Store Connect. ## Troubleshooting - If the assistant cannot connect, confirm MCP Server is enabled and the app is still open. - If metadata tools fail, connect App Store Connect first. - If Cursor or VS Code does not show the server, save the config and restart the editor. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO SDKs Use the ASO-only SDK setup when you want Apple Ads keyword revenue inside App*Sprint* ASO. ## When to add it Add the SDK after Apple Ads is connected and RevenueCat or Superwall is ready. The ASO SDK sends just the Apple Ads install signal App*Sprint* needs to match revenue back to keywords. It does not turn on unrelated app analytics or event tracking. ## Setup 1. Open Apple Ads in the Mac app. 2. Open return on ad spend setup. 3. Connect RevenueCat or Superwall. 4. Send one test webhook event. 5. Pick iOS, Flutter, or React Native and copy the generated prompt. ## iOS ```swift import AppSprintSDK import RevenueCat await AppSprintAppleAds.configure(apiKey: "YOUR_ASO_KEY") let params = AppSprintAppleAds.getAttributionParams() Purchases.shared.setAttributes(params) ``` ## Flutter ```dart import 'package:appsprint_flutter/appsprint_flutter.dart'; import 'package:purchases_flutter/purchases_flutter.dart'; await AppSprintAppleAds.configure('YOUR_ASO_KEY'); final params = await AppSprintAppleAds.getAttributionParams(); await Purchases.setAttributes(params); ``` ## React Native ```tsx import { AppSprintAppleAds } from '@appsprint/react-native'; import Purchases from 'react-native-purchases'; await AppSprintAppleAds.configure({ apiKey: 'YOUR_ASO_KEY' }); const params = await AppSprintAppleAds.getAttributionParams(); await Purchases.setAttributes(params); ``` ## Verify After the app receives an Apple Ads install, reopen return on ad spend setup. The SDK card shows install pings received in the last 24 hours and the last time App*Sprint* saw one. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # RevenueCat integration RevenueCat sends trials, purchases, renewals, refunds, and cancellation events to App*Sprint* ASO. App*Sprint* joins those events to Apple Ads installs so the Apple Ads dashboard can show revenue and return on ad spend by keyword. ## Requirements - An active App*Sprint* ASO Pro plan. - A published app selected in the Mac app. - RevenueCat admin access. ## Setup 1. In App*Sprint* ASO, select the app you want to measure. 2. Open the **Apple Ads** tab. 3. Click the **SDK & revenue tracking** button in the top-right toolbar. 4. Choose **RevenueCat**. 5. Click **Create webhook**. 6. Copy the webhook URL. 7. Copy the bearer token. 8. In RevenueCat, open **Project Settings** → **Integrations** → **Webhooks**. 9. Add a webhook using the App*Sprint* URL. 10. Add the **Authorization** header as `Bearer YOUR_TOKEN`. ## Test event Send one RevenueCat test webhook. App*Sprint* marks the connection verified after the first valid webhook for this app. Then return to the same SDK & revenue tracking flow in the Mac app and continue to SDK setup. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # Superwall integration Superwall sends paywall purchase and subscription events to App*Sprint* ASO. App*Sprint* joins those events to Apple Ads installs so the Apple Ads dashboard can show revenue and return on ad spend by keyword. ## Requirements - An active App*Sprint* ASO Pro plan. - A published app selected in the Mac app. - Superwall admin access. ## Setup 1. In App*Sprint* ASO, select the app you want to measure. 2. Open the **Apple Ads** tab. 3. Click the **SDK & revenue tracking** button in the top-right toolbar. 4. Choose **Superwall**. App*Sprint* shows the webhook URL for this app. 5. In Superwall, open **Settings** → **Integrations** → **Webhooks**. 6. Create a webhook using the App*Sprint* webhook URL. 7. Open the webhook in Superwall. 8. Copy the Svix signing secret. 9. Return to the same **Superwall** step in App*Sprint* ASO. 10. Paste the signing secret and save it. ## Test event Send one Superwall test webhook. App*Sprint* marks the connection verified after the first valid signed webhook for this app. Then return to the same SDK & revenue tracking flow in the Mac app and continue to SDK setup. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: App Store Connect integration Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. ## Steps 1. Sign in to App Store Connect. 2. Go to Users and Access. 3. Open Integrations. 4. Select App Store Connect API in the left sidebar under Keys. 5. Click the plus button next to Active to create a new key. 6. Name it App*Sprint* ASO or anything clear. 7. Select the App Manager role. 8. Click Generate. 9. Copy the Issuer ID into App*Sprint* ASO. 10. Copy the Key ID into App*Sprint* ASO. 11. Download the .p8 file. You can only download it once. 12. Select the .p8 file in App*Sprint* ASO. The credentials are saved locally in Keychain. ## Common issues - Localizations do not load: confirm the key has App Manager access for the selected app. - Key file is missing: create a new key because Apple only allows the .p8 file to be downloaded once. - Wrong app data appears: check the Apple team and selected app in App*Sprint* ASO. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue. --- # App*Sprint* ASO: Apple Search Ads integration Invite a dedicated API user, generate a public key, and connect Apple Search Ads to App*Sprint* ASO. ## Steps 1. Create a separate Apple Account at account.apple.com/account. 2. In Apple Search Ads Advanced, click your account name in the top right corner. 3. Go to Settings. 4. Open User Management. 5. Click Invite Users. 6. Invite the new Apple Account as API Account Manager. 7. Sign out of your main account before accepting the invite. 8. Open the invitation email on the new Apple Account and accept it. 9. Enter the activation code and join. 10. Go back to Settings as the invited account. 11. Open the API page. 12. In App*Sprint* ASO, click Generate Key Pair. 13. Copy the public key from App*Sprint* ASO into Apple Search Ads. 14. Click Generate API Client. 15. Copy clientId, teamId, and keyId into App*Sprint* ASO. App*Sprint* ASO keeps the generated private key on your Mac and only asks Apple Search Ads to store the public key. For campaign setup, bids, metrics, and scaling, use the Apple Ads playbook. --- ## ASO Docs navigation - [App*Sprint* ASO Start Guide](https://appsprint.app/aso/docs) - Start using App*Sprint* ASO with a simple workflow for keywords, metadata, the App*Sprint* SDK, revenue integrations, Apple Ads, and weekly checks. - [ASO Golden Rules for App*Sprint* ASO](https://appsprint.app/aso/docs/golden-rules) - A practical ASO playbook for keywords, metadata, screenshots, localization, Apple Ads, ratings, and weekly routines. - [Apple Ads Playbook for App*Sprint* ASO](https://appsprint.app/aso/docs/apple-ads-playbook) - A practical Apple Ads guide for campaign setup, bids, Search Match, Exact keywords, metrics, scaling, and revenue tracking. - [Screenshot Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/screenshots) - Improve App Store screenshots with competitor research, clear captions, and App Store Connect tests. - [Localization and Pricing Guide for App*Sprint* ASO](https://appsprint.app/aso/docs/localization) - Choose countries, localize App Store metadata and screenshots, and set country-level prices. - [Use the local MCP server](https://appsprint.app/aso/docs/mcp) - Let AI assistants access your local App*Sprint* ASO data through the built-in MCP server. - [App*Sprint* ASO SDKs](https://appsprint.app/aso/docs/sdks) - Add the ASO-only Apple Ads SDK setup for iOS, Flutter, and React Native apps. - [RevenueCat integration](https://appsprint.app/aso/docs/revenuecat) - Connect RevenueCat to App*Sprint* ASO so subscription revenue appears beside Apple Ads keywords. - [Superwall integration](https://appsprint.app/aso/docs/superwall) - Connect Superwall to App*Sprint* ASO so paywall revenue appears beside Apple Ads keywords. - [App Store Connect integration](https://appsprint.app/aso/docs/app-store-connect) - Create the API key App*Sprint* ASO needs to read and update App Store metadata for your apps. - [Apple Search Ads integration](https://appsprint.app/aso/docs/apple-ads) - Connect Apple Search Ads to App*Sprint* ASO so keyword reporting includes spend, installs, and revenue.