App Clips Advanced Experiences not showing up in Apple Maps and Siri Suggestions

Hello everyone,

I’m experiencing an issue with App Clips Advanced Experiences and Apple Maps/Siri Suggestions. We have already contacted Apple Support before, but they are investigating the cause of this issue and it has not been resolved til date.

The App Clip is bundled with the main app and has been already available on the App Store for several months. The business running the app has several physical shops and wants to offer the App Clip to show up in Apple Maps and Siri Suggestions at each location.

The App Clip is correctly exposed in the AASA file, and it's also validated correctly by the AASA APIs available at https://app-site-association.cdn-apple.com/a/v1.

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TEAMID.bundleid",
                "paths": []
            }
        ]
    },
    "appclips": {
        "apps": [
            "TEAMID.bundleid.Clip"
        ]
    }
}

(with TEAMID and bundleid being the team and bundle identifiers of the app)

The App Clip is displayed correctly when loading the website and when scanning a QR code or App Clip code, but doesn't appear in the Maps app or in Siri suggestions. We have set up the App Clip Advanced Experiences on the App Store Connect page of the app, and each URL has been linked to a physical shop. All URLs are in the "Received" state, so they should appear correctly on Maps. Unfortunately, I don't see any "Order" button in Apple Maps at any location card. We tried with both iOS 17 and 16. According to feedbacks from people in the shops, they don't see the app suggested in the Siri Suggestions. I have just submitted a Custom Action Link on Apple Business Connect for one of the shops, but without success: the App Clip doesn't appear. Any idea why is this happening?

Thank you for reaching out. I appreciate you including details about your previous contact with Apple Developer Support. To better assist you, could you please provide me with any relevant code-level request number?

I've checked the AASA file link you provided: https://app-site-association.cdn-apple.com/a/v1 but I'm encountering a HTTP 404 error.

curl -v https://app-site-association.cdn-apple.com/a/v1
* Request completely sent off
< HTTP/2 404 
< content-type: text/plain; charset=utf-8
< x-content-type-options: nosniff
< via: https/1.1 ussjc2-vp-vst-017.ts.apple.com (acdn/255.14450), https/1.1 ussjc2-vp-vfe-016.ts.apple.com (acdn/255.14450), 1.1 varnish
< cdnuuid: 535e2f39-9b08-440d-98fc-556820a5aee7-1443437687
< accept-ranges: bytes
< age: 0
< date: Tue, 03 Sep 2024 18:11:20 GMT
< x-cdn: fsly
< x-served-by: cache-sjc10061-SJC
< x-cache: hit-stale, miss, MISS
< x-cache-hits: 0
< x-timer: S1725387081.927022,VS0,VE50
< content-length: 19
< 
404 page not found

To initiate our investigation, I'd like you to assist me by following these steps:

  1. Please verify the AASA file URL: Ensure that it matches the correct format: https://<fully qualified domain>/.well-known/apple-app-site-association. From your app, could you please provide the exact link to your AASA file?

  2. Share Association Domain Entitlement: From your app project, I will need to see the Associated domain entitlement.

  3. Double-check AASA File Placement: Review the steps outlined in the Apple documentation on supporting associated domains: https://developer.apple.com/documentation/xcode/supporting-associated-domains.

Please note that I recommend reviewing our troubleshooting tech note TN3155: Debugging Universal Links, as it often contains helpful solutions to common issues: (https://developer.apple.com/documentation/technotes/tn3155-debugging-universal-links)

Once you have these details, please reply to this message, and I'll be happy to delve deeper into the investigation on your behalf.

From set up an advanced App Clip experience with place association: A place association is an optional component that connects the App Clip to a physical location, and is needed for the experience to be invoked in Maps. Place association doesn’t guarantee inclusion in Apple Maps and may not be available in all regions.

If an App Clip is part of the location’s official app, it'll be approved for that location. If it’s not part of the official app, either the business owner must claim the location through Apple Business Connect and approve the App Clip to display, or the creator of the App Clip must be authorized as a partner on the business’ website.

The App Clip is displayed correctly when loading the website and when scanning a QR code or App Clip code, but doesn't appear in the Maps app

Is the location approved for your business on Apple Maps as described in the above paragraph?

Hi, thanks for your messages. Regarding the last message: I tried to associate the place in Business Connect as a further step to try making the implementation work, but as I understood this is not required in my situation, considering all locations are associated to an App Clip URL in App Store Connect. This is how the App Clip Advanced Experiences page look like in ASC:

They are all in the "Received" status, but I can't see them in Apple Maps.

So I have three questions around the current implementation of my App Clips:

  • Some of the stores are based in Italy, while others are based in UK, but none of them are displayed in Maps. Which countries support App Clip Advanced Experiences?
  • Each App Clip location is associated to an invocation URL which adds an additional parameter to the base URL, e.g. https://www.example.com/p01, https://www.example.com/p02, https://www.example.com/p03, etc.. When browsing these URLs from Safari, they return a 404 error, because they are intended to deeplink the user within the app to the proper store location. Might this be an issue with showing up the App Clip in Maps?
  • Even if I remove the invocation of the URL (p01, p02 etc.) to a location in ASC Advanced Experiences, the App Clip action still doesn't appear on Maps. Might this be caused by the fact that the same URL (in this case, www.example.com) cannot be present with multiple buttons inside the location card in Maps? (I can't find the reference for this specification from the docs right now)

Im having very similar issues on my end with associating app clips to locations in Apple Maps. Here is my app clip advanced experience setup along with my AASA file setup for the related app. Everything looks to be in order but there is there a way to check or verify if Apple sees/approves the association.

@daniel_at_curate , @nicorsm, There was an issue where Advanced App Clip Experiences could not be published. The issue is now resolved. Please try again ​to launch your App Clip and let me know if you can still reproduce this issue.

Hi @DTS Engineer / @DTS Engineer ,

Thank you for the update. Unfortunately, the problem persists and I can't see my App Clip Advanced Experience listed in the actions of my location in Apple Maps.

Could you please provide feedback to my previous questions so that I can try to figure out where the problem is? Attached you can find the current situation in Maps, where the "Takeout" action is not available, but it looks to be okay on App Store Connect.

App Clips Advanced Experiences not showing up in Apple Maps and Siri Suggestions
 
 
Q