Apple App Site Association (AASA)

AASA files enable iOS apps to support Universal Links by associating web domains with app content.

Why it matters

Facilitates seamless navigation between web and app content.
Improves user experience by bypassing browser redirects.

How to measure

Track successful Universal Link openings.
Monitor user engagement post-link activation.

Details

The Apple App Site Association (AASA) file is a JSON file hosted on your web server that allows your iOS app to handle Universal Links. This file specifies which paths on your website should be associated with your app, enabling users to open content directly in the app instead of a web browser. The AASA file must be placed at the root of your domain in a specific location: /.well-known/apple-app-site-association. It is crucial to ensure the file is properly formatted and accessible over HTTPS.

Implementing AASA files requires collaboration between developers and web administrators to ensure the correct paths are listed and the file is correctly deployed. Regular testing is recommended to ensure links are functioning as expected, especially after app updates or website changes.

Examples & formulas

For instance, an AASA file might include paths like "/products/*" to ensure any product page on your website opens directly in the app.

{"applinks": {"apps": [], "details": [{"appID": "TEAMID.com.example.app", "paths": ["/products/*"]}]}}

Common mistakes

Incorrect file placement; ensure it's at /.well-known/apple-app-site-association.
Omitting necessary paths; verify all relevant paths are included.