# --- App Identity (REQUIRED) ---
app_name: "" # canonical app name as displayed in stores
developer_account_name: "" # Apple team name / Google Play developer name
bundle_id_ios: "" # com.example.app
package_name_android: ""
app_store_id_ios: 0 # numeric ID from App Store URL
play_store_url: ""

# --- Platforms ---
platforms:
 ios: false
 android: false
 ipados: false
 mac_catalyst: false
 vision_os: false
 android_tablets: false
 android_tv: false
 wear_os: false

# --- Distribution Status ---
ios_status: "" # live | in_review | rejected | unpublished | not_submitted
android_status: "" # live | internal_testing | closed_testing | open_testing | unpublished
launch_date_ios: "" # YYYY-MM-DD
launch_date_android: ""

# --- Current Performance ---
downloads_ios_total: 0
downloads_android_total: 0
downloads_last_30d_ios: 0
downloads_last_30d_android: 0
mau_ios: 0
mau_android: 0
rating_ios: 0.0
rating_android: 0.0
review_count_ios: 0
review_count_android: 0
review_count_last_30d_ios: 0
review_count_last_30d_android: 0
crash_rate_ios: 0.0 # Xcode Organizer
crash_rate_android: 0.0 # Android Vitals
anr_rate_android: 0.0

# --- Category and Competition ---
primary_category_ios: ""
secondary_category_ios: ""
primary_category_android: ""
top_competitors: []

# --- Current ASO State ---
title_ios: "" # max 30
subtitle_ios: "" # max 30
keyword_field_ios: "" # 100
promotional_text_ios: "" # max 170
description_ios: "" # max 4000
title_android: "" # max 30
short_description_android: "" # max 80
long_description_android: "" # max 4000
screenshot_count_ios: 0
screenshot_count_android: 0
preview_video_ios: false
preview_video_android: false
custom_product_pages_ios: 0 # CPP
custom_store_listings_android: 0 # CSL
ppo_tests_ios: 0
sle_tests_android: 0

# --- Web Coordination Layer ---
marketing_page_url: ""
universal_links_configured: false # apple-app-site-association at .well-known
android_app_links_configured: false # assetlinks.json at .well-known
smart_app_banner_present: false # iOS Safari meta tag
applinks_meta_present: false
softwareapplication_schema_present: false
app_pack_visibility: "" # yes | no | intermittent | unknown
spotlight_indexing_implemented: false
nsuseractivity_implemented: false

# --- Localization ---
primary_languages_ios: []
primary_languages_android: []
cross_localization_enabled: false # English (US) plus Spanish (MX) stack etc.

# --- Goals ---
primary_goal: "" # increase_organic_installs | improve_cvr | expand_keywords | recover_rating | win_app_pack | launch_new
target_keywords_brief: ""

apple_app_store_ranking_signals:

 title:
 weight: "highest"
 max_chars: 30
 rule: "Brandplus1to3high-intentkeywords.Strongestindexedfield."
 source: "SearchEngineLand2022;AppTweak2025benchmark."

 subtitle:
 weight: "very_high"
 max_chars: 30
 rule: "Distinctkeywordsfromtitle;weightroughlyequaltothehiddenkeywordfield."

 keyword_field:
 weight: "high"
 max_chars: 100
 rule: "Comma-separated,nospaces,notitle/subtitlerepeats,singularonly."
 visibility: "Hiddenfromusers."

 screenshot_text:
 weight: "high"
 method: "AIextraction(confirmedatWWDC25;notclassicalOCR)"
 rule: "Captiontexttreatedaskeywordmetadata;topandbottomregionsweightedmost."
 launched: "June2025"
 source: "Appfigures,'TheBiggestAppStoreAlgorithmChangeisHere',June2025."

 ai_generated_tags:
 weight: "emerging"
 status: "BetaiOS26asofWWDC2025;notyetonpublicAppStore"
 method: "LLManalyzesmetadata,description,category,screenshots;tappablechips"
 developer_control: "Cannotaddmanually;canremoveirrelevantonesinAppStoreConnect"
 source: "TechCrunch,June2025."

 download_velocity:
 weight: "high"
 rule: "Recentvelocity(last7to30days)outweighstotalall-timedownloads."

 conversion_rate:
 weight: "high"
 rule: "Productpageviewstoinstalls.AppTweak2025:33.4%iOSmedian."

 retention:
 weight: "high_and_growing"
 note: "Post-installretentionisaqualitysignal(AppScreenshotStudio2026rankingguide)."

 ratings_and_reviews:
 weight: "high"
 factors: ["Starrating", "Velocity", "Recency", "Helpful-voteweighting"]
 note: "SensorTower2025:4.3to4.6liftincreasesconversion22to28%inFinanceandHealth."

 category:
 weight: "medium"
 rule: "DrivesBrowsetabandcategorycharts."

 in_app_purchase_names:
 weight: "low"
 rule: "IAPnamesindexed;canincludekeywords."

 developer_name:
 weight: "low_to_medium"

 description:
 weight: "negligible_for_search"
 note: "NOTindexedoniOS.Conversiononly.GooglePlayDOESindexitslongdescription."

google_play_store_ranking_signals:

 app_title: {weight: "highest", max_chars: 30}

 short_description:
 weight: "high"
 max_chars: 80
 note: "Indexedforsearch;visible.Googleauto-localizes(AppTweak2025:88%apps/94%games)."

 long_description:
 weight: "medium_to_high"
 max_chars: 4000
 rule: "Indexed;repeateachprimarykeyword2to3timesnaturally."

 install_count_and_velocity: {weight: "high"}

 ratings_and_reviews:
 weight: "high"
 factors: ["Starrating", "Velocity", "Recency", "Sentimentanalysisonreviewtext(PlayConsole)"]

 uninstalls:
 weight: "negative"
 rule: "Highuninstallratesuppressesranking."

 retention: {weight: "high", source: "30-dayretentionexposedinPlayConsole"}

 android_vitals:
 weight: "medium_to_high"
 thresholds:
 crash_rate: "under1.09%(PlayStoreBadBehaviorthreshold)"
 anr_rate: "under0.47%"
 additional: ["Slowrendering", "Slowstart", "Excessivewakeups", "Stuckwakelocks"]
 source: "AndroidVitalsdashboardinPlayConsole."

 tags: {weight: "medium", rule: "Controlledvocabulary;upto5perapp"}

 content_rating: {weight: "low", note: "Higherratingslimitreach;filter,notdirectrankingsignal"}

 developer_account_trust: {weight: "medium"}

keyword_research_sources:

 apple_app_store:
 apple_search_ads:
 url: "searchads.apple.com"
 data: "SearchPopularityscore(1to100,Appleinternal)"
 access: "Free"
 caveat: "October2025updatedroppedthenumberofUSAppStorekeywordswithpopularityabove5by77%(aso.devanalysis).Cross-referencewiththird-partydata."
 apple_search_term_rank_report:
 status: "InsightssectionofAppleSearchAds,betaasofOctober2025"
 data: "Monthlyreport;howsearchtermsrankwithingenresandcountries."
 third_party: ["AppTweak", "SensorTower", "AppFigures", "MobileAction"]

 google_play_store:
 play_console_search_term_acquisition:
 path: "Acquirereports>Searchtermacquisition"
 data: "Realacquisitionperformancebysearchtermforyourownapp"
 google_keyword_planner:
 note: "Websearchvolume;correlatedtoPlayStorevolumeforhigh-intentterms"
 play_store_autocomplete:
 method: "TypeseedterminPlayStoresearch;recordsuggestions"
 third_party: ["AppTweak", "SensorTower", "AppFigures", "MobileAction", "ASOdesk"]

aso_keyword_heuristics:
 brand_terms: "Exactbrandintitle;brandsearchesconvertat50%+installrate."
 high_intent_unbranded: "Subtitle(iOS)andshortdescription(Android)hold2to4high-intentunbrandedterms."
 long_tail_keyword_field: "iOS100-charfieldholdslong-tailcombinationsthatdonotfitintitleorsubtitle."

 cross_localization_ios:
 pattern: "Appleindexeskeywordsfromprimarylanguageplusoneormoresecondarylocalizations."
 us_example: "InUS,AppleindexesEnglish(US)plusSpanish(Mexico),Russian,Chinese,others."
 leverage: "UseSpanish(Mexico)keywordfieldonUS-targetedappfor100additionalEnglishkeywordcharacters(ifnotlocalizedintoSpanish)."
 citation: "AppTweak'HowtoBenefitfromCross-LocalizationontheAppStore';AppFigures'10xYourKeywordList'."

 apple_search_ads_research_loop: "Discoverycampaignbroad-matchharvestsconvertingtermsintoorganickeywordfield."
 google_play_long_description_repetition: "Eachprimarykeyword2to3timesnaturally;nostuffing(Googledetectsdensityanomalies)."
 competitor_gap_analysis: "Pulltop3competitors'indexedkeywordlists;targettheirhigh-volumetermsyoudonotyetcover."

ios_keyword_field_rules:

 total_chars: 100
 format: "Comma-separated,nospacesaftercommas(everyspacewastesachar)."
 case: "Lowercase;capitalizationdoesnotaffectmatching."
 no_repeats: "Donotincludewordsalreadyintitleorsubtitle."
 singular_only: "Applematchespluralautomatically.Includingbothwasteschars."
 no_competitor_names: "TrademarkrejectionriskunderGuideline4.0."
 no_apple_terms: "Avoid'free','app','iPhone','iPad','appstore'.Applestripsorrejects."
 no_punctuation_other_than_comma: true
 per_localization: "Eachlocalizationhasitsown100-charfield.Usecross-localizationtoexpandsurface."

 example:
 bad: "best,free,meditation,app,sleep,meditationapp,sleeping,meditate"
 why_bad: "'best'and'free'arefiller;'app'rejected;'meditationapp'repeats'meditation';'sleeping'isjustpluralof'sleep'."
 good: "meditation,sleep,calm,anxiety,mindfulness,breathing,relax,unwind,zen"
 why_good: "Ninedistinctindexedtermsin67chars;33charsremain."

icon_guidelines:
 technical:
 ios: "1024x1024PNGnoalpha;Appleappliesrounded-cornermaskatruntime."
 android: "512x512PNGalphaallowed;adaptiveicontreatment."
 design:
 simplicity: "Recognizableat60x60pxhomescreensize."
 contrast: "Strongagainstlightanddarkstorebackgrounds."
 no_text: "Brandletteronly;fulltextillegibleatthumbnailsize."
 palette: "Twotothreecolorsmax."
 category_signaling: "Category-signalingiconsoutperformclever-but-ambiguousmarks(SplitMetrics2024-2025)."
 conversion_lift: "5to15%onaverage;outliers30%+(SplitMetrics2024-2025)."
 priority: "Highest-leveragesingleassettotestfirstformostcategories;Shoppingexception(firstscreenshotleads)."
 testing:
 ios: "PPO;upto3treatmentsvscontrol."
 android: "SLE."

screenshot_guidelines:

 technical_ios:
 iphone_6_7: "1290x2796px(iPhone15ProMax).Required;Appledownsizesforsmallerdevices."
 iphone_5_5: "1242x2208pxlegacy.Optional."
 ipad_12_9: "2048x2732px.RequiredifiPad-compatible."
 count: "Upto10perdevicesize."

 technical_android:
 phone: "Min320px,max3840px;aspectratio16:9to9:16."
 count: "Upto8."
 feature_graphic: "1024x500pxbannerattopoflisting."

 composition:
 first_two_critical: "Firsttwoseenbeforescroll.Mostdecisionshappenhere."
 caption_text: "SinceJune2025AppleAI-extractscaptiontextaskeywordmetadata.CaptionsmustbebothhumanbenefitANDindexedkeyword."
 caption_example:
 bad: "Thebestappever!"
 good: "TrackSleepPatterns"
 why: "Goodcaptionsurfaces'tracksleep'and'sleeppatterns'asindexedtermswhilereadingasabenefit."
 device_frame_vs_full_bleed: "A/Btestbycategory."
 visual_hierarchy: "Largetextfirst,UIsecond,micro-textlast."

 storytelling_pattern:
 s1: "Herobenefitwithbrand"
 s2: "Primaryfeature"
 s3: "Socialproof"
 s4_5: "Secondaryandtertiaryfeaturesorusecases"
 s6_to_10: "Additionalfeaturesandedgebenefits"

 conversion_lift:
 source: "AppTweak2025ASOTrendsandBenchmarks;SplitMetricsA/Bcompilation"
 findings:
 - "QuarterlyA/Btestingyields20to30%higherCVRthanstaticscreenshots"
 - "ScreenshotA/Btestsproduce11.8%medianCVRliftacrossvariants"
 - "IffirsttwoscreenshotsdonotchangebetweenPPOvariants,thetestiseffectivelyidenticaltocontrol"

 category_priorities:
 productivity: "Icon,thenscreenshots,thensubtitle"
 shopping: "Firstscreenshot,secondscreenshot,thenpreviewvideo"
 games: "Gameplayscreenshotsandpreviewvideodominate"
 finance_health: "Trustsignalingcritical(securitybadges,certifications,ratings)"

preview_video_guidelines:

 technical_ios:
 duration: "Upto30seconds"
 count: "Upto3perlanguage"
 format: "MOV,M4V,MP4;under500MB"
 resolution: "Matchdevicesize(e.g.,2796x1290foriPhone15ProMax)"
 autoplay: "Yes,muted,onproductpageandinsearchresults"
 source: "AppStoreConnectHelp:Apppreviewspecifications."

 technical_android:
 hosting: "YouTube-hosted;onepromovideoperlisting"
 duration: "Recommendedunder30sec;2minhardlimit"
 autoplay: "Onthelistingpage"

 content:
 audio_muted_default: "On-screentextandvisualsmustcarrythemessage."
 first_3_seconds: "Openwithherobenefitvisually."
 actual_app_footage: "Bothstoresrequirefootageoftheactualapp;conceptvideosriskrejection."

 conversion_lift:
 source: "Hilomedia2025PreviewVideosguide;SplitMetricsaggregateddata"
 findings:
 - "Well-producedpreviewliftsCVR20to40%overscreenshots-onlylistings"
 - "Watchersandengagersareroughly2xmorelikelytoinstall"
 - "Atleasthalfofviewerswatchthroughtoend"

 poster_frame_ios: "Appleshowswhenautoplaydisabled.Pickaframeconveyingvaluepropwithcaptiontext."

custom_pages:

 ios_cpp:
 customizable: "Screenshots,previewvideos,promotionaltext,deeplinktarget"
 fixed: "Name,subtitle,icon,description,keywords"
 max_per_app: 70 # since October 29, 2025
 keyword_assignment: "Sincemid-2025CPPscanbeassignedkeywords;appearinorganicsearchresults."
 deep_links: "EachCPPcandeep-linkintoaspecificin-appdestinationafterinstall."
 use_cases: ["Audiencesegments", "Trafficsources", "Marketswithinalocale", "Featureemphasisforpaid"]
 source: "AppleDeveloperAppStoreConnectHelp:CustomProductPages."

 ios_ppo:
 elements: "Icon,screenshots,previewvideos"
 treatments: "Upto3vscontrol"
 duration: "Upto90dayspertest;oneatatime"
 reporting: "AppAnalytics"

 android_csl:
 customizable: "Title,shortdescription,longdescription,graphics,video"
 max_per_app: 50
 targeting: "Country,language,installstate,pre-registration"
 google_ads_integration: "IntegrateswithGoogleAdscampaigns"
 ai_text_generation: "2025:experimentalGeminiAIgeneratesCSLtextbytheme,tone,audience."

 android_sle:
 elements: "Icon,featuregraphic,screenshots,shortdescription"
 concurrent_tests: "Upto5onmainlisting;upto5perCSL(50CSLs=250+parallel)"
 reporting: "Significanceandconfidenceinterval"

review_acquisition:

 ios_skstorereviewcontroller:
 api: "StoreKitSKStoreReviewController/requestReview()"
 throttle: "Applelimitspromptsto3peruserper365-dayperiod."
 timing: "Onlyafterdemonstrateduservalue.Neveronlaunch."
 apple_control: "Appledecideswhethertoactuallyshow;developerhasnooverride."
 source: "AppleDeveloperDocumentation:SKStoreReviewController."

 android_in_app_review_api:
 api: "GooglePlayIn-AppReviewAPI(PlayCorelibrary)"
 throttle: "Quotaenforced;over-frequentcallssilentlyno-op."

 prohibited:
 - "Incentivizedreviews(paying,rewarding,unlockingcontentforreviews)"
 - "Reviewgating(askingsatisfactionfirst;onlypromptinghappyusers)"
 - "Customnon-platformreviewprompts(AppleGuideline1.1.7)"
 - "Buyingreviews"
 - "Askingemployees,family,orpaidactors"
 citation: "AppleAppStoreReviewGuideline1.1.7;GooglePlayDeveloperProgramPolicyonRatings,Reviews,andUser-GeneratedContent."

 ethical_pattern:
 - "Triggerafteramomentofvalue"
 - "Pre-emptcomplaintswithavoluntaryin-appsupportchannelthatdoesNOTgatetheratingprompt"

review_response:
 why:
 ranking: "Developerresponsesarevisible;signalactivemanagement."
 conversion: "Prospectiveusersreadresponsestonegativereviews."
 rating_recovery: "AppFollowbenchmark:5to15%ofusersupdateratingupafterathoughtfulresponse."
 pattern:
 structure: ["Acknowledgespecificissue", "Apologizewherewarranted(nounverifiedbugadmissions)", "Offerspecificnextstep", "Signasaperson"]
 tone: "Human,specific,accountable."
 timing: "Within7days;AppFollowtop-100medianisunder48hours."
 languages: "Respondinthelanguageofthereview."
 priority: "1-starfirst,2-starsecond,selectiveon4-5star."
 rating_decay:
 finding: "Reviewsolderthan12to24monthsdeeplydiscountedinbothstores."
 implication: "Anappwith100Kreviewsfrom5yearsagobut10inthelast30daysbehaveslikealow-velocityapp."
 citation: "LocalFalcon;SensorTowerreviewvelocitystudies."

negative_review_recovery:
 triage: ["Pulllast30daysof1-and2-starreviews", "Categorize:bugs,featurerequests,UX,content,monetization", "Identifydominantcategory"]
 fix_then_respond:
 - "Shipfixaddressingdominantcomplaint"
 - "Respondtoeachnegativereviewnotingthefix;askusertotrynewversion"
 - "Bumpversionconspicuously"
 reset_options:
 ios: "Resetappliestonewversiononly;cumulativestillincludeslegacy."
 android: "Noresetfeature;diluteviafreshpositivevelocity."
 flag_for_removal: "Bothstoresallowflaggingspam,off-topic,ordefamatoryreviews;successratevaries."

app_marketing_page_structure:

 url:
 pattern: "/apps/[app-slug]/or/[app-slug]/"
 rule: "Stable.Donotversion;deep-linkrecordsdependonit."

 above_the_fold:
 - "Appname(H1)"
 - "One-linevalueproposition"
 - "AppStorebadge"
 - "GooglePlaybadge(bothpresent;missingplatformlabeled'Comingsoon'or'Notavailableon[platform]')"
 - "Heroimage"
 - "Starratingandreviewcount"

 body_content:
 - "Whattheappdoes(3to5paragraphs)"
 - "Keyfeatures(5to10bullets)"
 - "Howitworks(3to5steps)"
 - "Screenshotsgallery(3to6withcaptions)"
 - "Reviews(2to5best,linkedtostores)"
 - "FAQ(5to10:pricing,platforms,privacy,support,cancellation)"
 - "Aboutthedeveloper(1to2paragraphs,linkedtoOrganization)"
 rule: "Contentfirst.EverysectionininitialserverresponseHTML,notJS-injected.Seeframework-contentfirst.md."

 conversion_elements:
 primary_cta: "Bothstorebadgesinhero"
 secondary_cta: "Repeatedbadgesaftereachmajorsection"
 smart_app_banner: "iOSSafarimetatag(Section8.3)"
 qr_code_for_desktop: "QRopeningstorepageonuser'sphone"

 trust_signals: ["Starratinglinkedtostorereviews", "Presslogosifreal", "Privacyandterms", "Awardbadgesifrealandcurrent"]

<a href="https://apps.apple.com/us/app/example-app/id123456789">
 <img src="/img/app-store-badge.svg" alt="Download on the App Store" width="180" height="60">
</a>
<a href="https://play.google.com/store/apps/details?id=com.example.app">
 <img src="/img/google-play-badge.png" alt="Get it on Google Play" width="200" height="60">
</a>

<meta name="apple-itunes-app" content="app-id=123456789, app-argument=https://example.com/path/to/content">

<meta property="al:ios:url" content="exampleapp://path/to/content">
<meta property="al:ios:app_store_id" content="123456789">
<meta property="al:ios:app_name" content="Example App">
<meta property="al:android:url" content="exampleapp://path/to/content">
<meta property="al:android:package" content="com.example.app">
<meta property="al:android:app_name" content="Example App">
<meta property="al:web:url" content="https://example.com/path/to/content">

location = /.well-known/apple-app-site-association {
 default_type application/json;
 add_header Cache-Control "public, max-age=3600";
}
location = /.well-known/assetlinks.json {
 default_type application/json;
 add_header Cache-Control "public, max-age=3600";
}

<script type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "MobileApplication",
 "name": "Example App",
 "applicationCategory": "HealthApplication",
 "applicationSubCategory": "Meditation",
 "operatingSystem": "iOS, Android",
 "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD", "availability": "https://schema.org/InStock"},
 "aggregateRating": {"@type": "AggregateRating", "ratingValue": "4.7", "ratingCount": "12453", "bestRating": "5", "worstRating": "1"},
 "downloadUrl": ["https://apps.apple.com/us/app/example-app/id123456789", "https://play.google.com/store/apps/details?id=com.example.app"],
 "installUrl": ["https://apps.apple.com/us/app/example-app/id123456789", "https://play.google.com/store/apps/details?id=com.example.app"],
 "screenshot": ["https://example.com/img/screenshot-1.jpg", "https://example.com/img/screenshot-2.jpg", "https://example.com/img/screenshot-3.jpg"],
 "publisher": {"@type": "Organization", "name": "Example, Inc.", "url": "https://example.com"},
 "datePublished": "2024-03-15",
 "softwareVersion": "3.2.1"
}
</script>

universal_links_setup:

 capabilities:
 location: "Xcode>Project>SigningandCapabilities>AssociatedDomains"
 add: "applinks:example.com"

 aasa_file:
 path: "https://example.com/.well-known/apple-app-site-association"
 content_type: "application/json"
 https: "Required;noHTTPfallback."
 no_redirect: "Apple'srequestmusthita200directly."
 size_limit: "128KBuncompressed."
 example: |
 {"applinks": {"apps": [],
 "details": [{"appID": "ABCD1234EF.com.example.app",
 "paths": ["/path/to/content/*", "/another/*", "NOT /admin/*"]}]}}
 appID_format: "TeamID.BundleID(10-charAppleDeveloperTeamID)."
 paths_syntax: "Globpatterns;NOTprefixexcludes."

 validation:
 apple_validator: "search.developer.apple.com/appsearch-validation-tool/"
 curl_check: "curl-Ihttps://example.com/.well-known/apple-app-site-association"
 cache: "iOScachesAASAupto7days;forcerefreshbydeletingandreinstalling."

 source: "AppleDeveloperDocumentation:Supportinguniversallinksinyourapp."

android_app_links_setup:

 manifest:
 location: "AndroidManifest.xml>Activity>intent-filter"
 example: |
 <intent-filter android:autoVerify="true">
 <action android:name="android.intent.action.VIEW" />
 <category android:name="android.intent.category.DEFAULT" />
 <category android:name="android.intent.category.BROWSABLE" />
 <data android:scheme="https" android:host="example.com" android:pathPrefix="/path" />
 </intent-filter>

 assetlinks_file:
 path: "https://example.com/.well-known/assetlinks.json"
 content_type: "application/json"
 example: |
 [{"relation": ["delegate_permission/common.handle_all_urls"],
 "target": {"namespace": "android_app",
 "package_name": "com.example.app",
 "sha256_cert_fingerprints": ["14:6D:E9:83:C5:73:..."]}}]
 sha256_source: "`keytool-list-v-keystore[keystore]`orPlayConsole>Setup>AppIntegrity."

 dynamic_app_links_2025:
 feature: "Android15(API35)+supportsDynamicAppLinks."
 declaration: "Path,query,fragmentmatchersinassetlinks.jsonitself;mergedwithmanifestatruntime."
 source: "AndroidDevelopersBlog:DynamicAppLinks,October2025."

 validation:
 google_tool: "developers.google.com/digital-asset-links/tools/generator"
 curl_check: "curl-Ihttps://example.com/.well-known/assetlinks.json"
 auto_verify: "android:autoVerify=truetriggersfetchoninstall."

 source: "GoogleDevelopersDigitalAssetLinks;AndroidDevelopersConfigurewebsiteassociations."

core_spotlight_indexing:

 apis:
 nsuseractivity: "Indexactivitiesasuserperformsthem(visitingpage,creatingcontent,viewingitems)."
 corespotlight: "Indexcontentprogrammaticallywithoutuservisit.Fordocuments,photos,persistentdata."
 web_markup: "WebURLswithmatchingschemacanalsobecrawledbyAppleforSpotlight."

 best_practice: "UsethesameidentifieracrossNSUserActivity,CoreSpotlight,andwebURL.Applededuplicatesbyidentifier;sameiteminmultipleAPIsranksstronger."

 privacy: "Indexison-device.Appledoesnotseethecontent."

 source: "AppleDeveloperDocumentation:CoreSpotlight;TechnicalNoteTN2416iOSSearchAPIBestPractices."

app_pack_inclusion:
 prerequisite_published: "Liveonatleastonestore;appsinreviewdonotappear."
 prerequisite_metadata_alignment: "Storetitleorcategoryalignswithquery."
 signal_install_velocity: "Recentinstallvelocityinrelevantcategory."
 signal_rating: "Higherstarratingfavored."
 signal_marketing_page_seo: "Well-rankedmarketingpageincreasesAppPackinclusionfortargetqueries."
 signal_appindex_legacy: "HistoricalGoogleAppIndexingsignalspersistinpart."
 practical_strategy:
 - "Optimizestoremetadatafortargetquery"
 - "Optimizemarketingpagefortargetquery"
 - "LinkmarketingpagetostoreURLs"
 - "ConfigureUniversalLinksandassetlinks.json"
 - "MonitorviaSemrush,Ahrefs,AccuRankerSERPfeaturesfilter"

apple_intelligence_app_discovery:

 spotlight_search:
 description: "Device-widesearch(swipedownonhome;Cmd+SpaceonMac)."
 indexes: "Apps,files,contacts,messages,calendar,in-appcontent(viaCoreSpotlight)."
 ai_layer: "Resultspersonalizedbyon-deviceAI;usagepatterns,time,location,recentactivity."
 scale: "Approximately700to900Mdailyusersglobally;85%ofiPhoneusersengageweekly(TechLila2026statistics)."

 siri_suggestions:
 description: "ProactivesuggestionsinLockScreen,Notifications,Spotlight."
 overlap: "80to90%samedataasSpotlight."

 app_store_today_tab:
 scale: "Approximately500Mweeklyusersbegindiscoveryhere(AppleDeveloperdocumentation)."
 ai_layer: "AI-generatedtagchips(betainiOS26)."
 featuring: "FeaturingNominationsinAppStoreConnect;2-weekminimumnotice."

 ai_generated_tags:
 description: "Tappablechipsgroupingappsbyinferredfunction('Meditation','SleepTracking')."
 status: "BetaiOS26developerbuildasofWWDC2025;notyetonpublicAppStore."
 source: "TechCrunchJune2025;AppleWWDC2025keynote."

 writing_tools_app_picks: "SomeflowssuggestappsduringAppleIntelligencedrafting,replying,summarizing."
 control_center_widget_suggestions: "SuggestedappsinControlCenterandWidgetGallery."

apple_intelligence_aso_levers:
 spotlight_indexing: "ImplementCoreSpotlightandNSUserActivity(Section9.5)."
 app_store_metadata_quality: "AItagspullfrommetadata,screenshots,description,category.Precisemetadataleadstoaccuratetags."
 ai_tags_review: "Whenlive,auditandremoveinaccuratetagsinAppStoreConnectatlaunchandquarterly."
 featuring_nominations: "SubmitforTodaytabeditorialconsideration."
 category_choice: "PrimarycategorydrivesTodaytabplacement."
 cannot_influence: ["Personalizationweights", "SiriSuggestionsranking", "Spotlightrankingfromexternalcontent"]

common_aso_mistakes:

 m1_keyword_stuffing_title:
 pattern: "Titleis'YourBrand:Meditation,Sleep,Calm,Yoga,Mindfulness'."
 why_bad: "ApplerejectsunderGuideline2.3(misleadingmetadata).Usersskipasspammy."
 fix: "Brandplus1to2keywords;subtitleforadditionalterms."

 m2_skipping_subtitle:
 pattern: "Subtitleblankorgenerictaglinelike'Thebestappever'."
 why_bad: "Wastes30charsequivalentinweighttothekeywordfield."
 fix: "Keyword-densereadabledescription:'Sleep,Meditate,RelaxDaily'."

 m3_keyword_field_repeats_title:
 pattern: "Titlehas'meditation';keywordfieldhas'meditation,meditate,meditations'."
 why_bad: "Title/subtitleindexedseparately;repetitionwastesthe100-charfield."
 fix: "Auditaftereachmetadatachange."

 m4_screenshots_without_captions:
 pattern: "Baredevicerenders,nocaptiontext."
 why_bad: "SinceJune2025AppleAI-extractscaptiontextasmetadata.Wastedrankingsignal."
 fix: "Captioneveryscreenshot;matchtorealkeywordswithconversionphrasing."

 m5_no_a_b_testing:
 pattern: "Screenshotsandiconsetatlaunch,neverupdated."
 why_bad: "AppTweak:quarterlyA/Btesterssee20to30%higherCVR."
 fix: "QuarterlyPPO(iOS)/SLE(Android)."

 m6_review_gating:
 pattern: "Asks'Areyouhappy?'thenonlypromptsSKStoreReviewControlleronyes."
 why_bad: "ViolatesAppleGuideline1.1.7andGooglePlayDeveloperPolicy.Removalrisk."
 fix: "Triggernativepromptunconditionallyaftervaluemoment;separatesupportchannelforcomplaints."

 m7_no_universal_links_no_assetlinks:
 pattern: "MarketingpagelinkstostoreURLsbutappdoesnothandledomainviaUniversalLinks/AppLinks."
 why_bad: "Installed-appuserslandonmarketingpageinsteadofintheapp."
 fix: "Implementboth;validate.well-knownfiles."

 m8_marketing_page_is_csr_spa:
 pattern: "Client-renderedReact/Vue;serverreturnsemptyshell."
 why_bad: "AIbots(GPTBot,ClaudeBot,PerplexityBot)cannotrender;pageinvisibletoAIcitation.AppPacksuffers."
 fix: "Server-render.Next.js,Astro,Hugo,plainHTML.Seeframework-contentfirst.md."

 m9_no_schema:
 pattern: "NoMobileApplicationorSoftwareApplicationschema."
 why_bad: "Norichresults;AIenginescannotextractappasstructuredentity."
 fix: "MobileApplicationin@graphcross-referencingOrganizationandWebSite.Validateatvalidator.schema.org."

 m10_ignoring_play_long_description:
 pattern: "200-wordPlaylongdescriptionwithnokeywordstrategy."
 why_bad: "GooglePlayindexeslongdescriptionforsearch."
 fix: "1500to3000chars;eachprimarykeyword2to3timesnaturally."

first_90_days:
 day_0_to_7:
 - "Pullcurrentmetadata,assets,ratings,reviewsintointake"
 - "Runkeywordresearch(AppleSearchAds,PlayConsole,AppTweak/SensorTower)"
 - "Identifytop10targetkeywordsperplatform"
 - "Auditcompetitormetadatafortop3"
 day_8_to_30:
 - "Rewritetitle,subtitle,keywordfield(iOS);shortdescription(Android)"
 - "Writenewlongdescription(Android)withtargetkeywords"
 - "Designandshipnewscreenshotswithkeyword-alignedcaptions"
 - "Submitnewmetadataforreview"
 - "Buildorrefreshmarketingpage;shipschema,AppLinks,SmartAppBanner"
 - "Deployapple-app-site-associationandassetlinks.json"
 day_31_to_60:
 - "LaunchfirstPPO(iOS)/SLE(Android)oniconorfirstscreenshot"
 - "ConfigurefirstCPPs/CSLs"
 - "ImplementSKStoreReviewController/In-AppReviewAPI"
 - "ImplementCoreSpotlightindexing(iOS)"
 - "Setupreviewresponseworkflow"
 - "Submitfeaturingnominationforanupcomingproductmoment"
 day_61_to_90:
 - "Concludefirsttest;shipwinner"
 - "Launchsecondtestonnextpriorityelement"
 - "Add2to3additionalCPPs/CSLs"
 - "Refinekeywordperformance"
 - "AuditAppPackinclusion;refinemarketingpageifnotappearing"
 - "AuditAppleIntelligencesurfaces"
 - "Generatefirst90-dayreport"

aso_maintenance_cadence:
 weekly:
 - "Ratingandreviewvelocity"
 - "Respondto1-and2-starwithin7days"
 - "MonitorAppPackandSpotlightvisibilityfortopqueries"
 - "Crashrate(XcodeOrganizer)andAndroidVitals"
 monthly:
 - "Keywordrankingdeltas"
 - "Competitormetadatachanges"
 - "PPO/SLE;shipwinners;queuenexttest"
 - "DownloadsandCVRnumbers"
 - "Refreshfeaturingnominationsifproductmoment"
 quarterly:
 - "Fullmetadataaudit(title,subtitle,keywordfield,descriptions)"
 - "Refreshscreenshotswithnewfeatureorseasonalangle"
 - "Refreshpreviewvideoifolderthan6to9months"
 - "Re-runkeywordresearch"
 - "AuditAppleAI-generatedtagswhenpublic"
 - "AuditUniversalLinksandassetlinks.json"
 - "ReviewmarketingpageSEO(CoreWebVitals,schema,content)"
 annually:
 - "FullASOauditagainstSection13rubric"
 - "Strategiccompetitivepositionreview"
 - "Re-evaluateprimarycategoryifappfunctiondrifted"
 - "Refreshiconifolderthan18to24monthsandtrendshifted"

aso_monthly_report:
 period: "[YYYY-MM-DD]to[YYYY-MM-DD]"
 downloads:
 ios_new: 0
 android_new: 0
 delta_vs_prior: ""
 conversion_rate:
 ios_cvr_pct: 0.0 # store as percentage; compare to category benchmark
 android_cvr_pct: 0.0
 ratings:
 ios_rating: 0.0
 android_rating: 0.0
 new_reviews_ios: 0
 new_reviews_android: 0
 response_rate_pct: 0
 keyword_ranking:
 tracked_top_10_ios: "NofN"
 tracked_top_10_android: "NofN"
 notable_movements: []
 tests:
 active_or_concluded: []
 web_marketing_page:
 sessions: 0
 branded_query_rank: 0
 non_branded_query_rank: 0
 app_pack_visibility: ""
 action_items_next_period: []

aso_quarterly_report:
 quarter: "Q[N][YYYY]"
 executive_summary: "" # two to four sentence narrative
 downloads_trend:
 quarter_total: 0
 prior_quarter: 0
 yoy_delta_pct: 0.0
 monthly_breakdown: []
 conversion_rate_trend:
 ios_q_minus_1: 0.0
 ios_q: 0.0
 android_q_minus_1: 0.0
 android_q: 0.0
 ratings_trend:
 ios_q_minus_1: 0.0
 ios_q: 0.0
 android_q_minus_1: 0.0
 android_q: 0.0
 test_outcomes: [] # list of {test_name, winner_shipped, lift_pct}
 keyword_strategy_update:
 keywords_added: 0
 keywords_retired: 0
 ranking_distribution: ""
 web_marketing_page:
 organic_sessions_qoq_delta_pct: 0.0
 schema_audit: ""
 universal_links_status: ""
 assetlinks_status: ""
 core_web_vitals: ""
 goals_next_quarter: []