Apple App Clips integration guide

For complete instructions on how developers create an App Clip for your app, see the Apple App Clip guide for developers.

For a simplified sample app that demonstrates the usage of App Clips and its integration with a full application, see the AppsFlyer App Clip guide.

• The SDK is required for AppsFlyer attribution of clicks, installs, in-app events, and App Clip-to-full app installs.
• OneLink redirects users independently of SDK integration.

To install the SDK and configure the full app SDK: 

Send the following links to your iOS developer and tell them to follow the instructions for:

• SDK integration in the App Clip
• Configuring App Clip-to-full app install attribution
• [Optional] Set up in-app events, if you don't yet have in-app events being measured for your full app, or want to use different in-app events for the App Clip.

Prerequisites:

• OneLink template for your full app with iOS Universal Links configured.
• OneLink link.
• Recommendation: The template and link invocation you use for the App Clip sends all users without your full app to the App Clip. Therefore, consider having a separate template and custom link for cases in which you want to send those users to the App Store, instead of the App Clip.

To configure the OneLink template for your App Clip:

1. In the AppsFlyer dashboard, go to Engage > OneLink Management.
2. Select the OneLink template you use to direct users to your full app. 
3. Make sure the OneLink template has Universal Links configured. (See instructions for adding Universal Links.)
4. Click Save.
   The AASA file is updated to support the App Clip.
5. In the AppsFlyer dashboard, go to Engage > OneLink Management.
6. Select the OneLink custom link based on the template you configured in steps 1-4 that you use to direct users to your App Clip.
7. Make sure you have a media source (pid) specified.
   The media source needs to be specified in the URL (for example: pid=chartboost_int) or contained inside the link.

To verify App Clips is enabled on AppsFlyer OneLink:

1. Create a URL to get your association file. The URL is created by taking the domain of your OneLink template and adding /.well-known/apple-app-site-association. 
   For example: coffee.onelink.me/.well-known/apple-app-site-association.
2. Go to the URL of your association file.
   The apple-app-site-association file is automatically downloaded.
3. Open the apple-app-site-association file with a text editor (for example, Notepad).
4. Make sure the file contains the word "appclips". and that the bundle ID ends with ".Clip". For example:
   

   "appclips": {
       "apps": [
         "ABCD1234.id.your.app.Clip",
         ...
       ]
   ...
   }

   If it does, then you have successfully set up App Clips on the AppsFlyer side, and the App Clip is implemented on any OneLink template with the same subdomain.

Prerequisites: Completion of OneLink template configuration for App Clips

To configure your App Clip to work with OneLink: 

1. In your app page in App Store Connect, go to Build > Domain Status.
2. Make sure your OneLink domain displays under Build domains and that Cache status and Debug status are both “validated”.
3. In the AppsFlyer dashboard, go to Engage > OneLink Management.
4. Hover over the Actions icon of the link you want to use and click Get URL. 
5. Record the short URL (or the prefix of the long URL). 
6. In your app page in App Store Connect, go to App Clip > Edit Advanced Experiences > +Add > Next.
7. In App Clip Experience URL, paste the OneLink custom URL you recorded in step 5.
   Note: You can append query parameters after the main custom URL, but you cannot change the path.
8. Click Next.
   Your App Clip is now configured to work with OneLink. Further instructions regarding App Store Connect settings are available in the Apple developer guide.

Prerequisites: A registered test device with iOS 14 without your full app installed.

To test your OneLink/App Clip integration:

1. In the AppsFlyer dashboard, go to Engage > OneLink Management.
2. Hover over the Actions icon of the link you want to test and click Get URL. 
3. Scan the QR code with your device.
   The App Clip Card displays on your device, indicating that your OneLink/App Clip integration is properly set up.