Guide d'intégration des clics d’app d’Apple

Pour des instructions complètes sur la façon dont les développeurs créent un clip d’app, voir le Guide des clips d’app Apple pour les développeurs.

Pour un exemple d'app simplifiée qui démontre l'utilisation des clips d’app et leur intégration dans une app complète, voir le Guide des clips d’app Apple.

• Le SDK est nécessaire pour l'attribution par AppsFlyer des clics, des installations, des événements in-app et des installations via le clip d’app par rapport aux installations complètes.
• OneLink redirige les utilisateurs indépendamment de l'intégration du SDK.

Pour installer le SDK et configurer le SDK d’app complet: 

Envoyez les liens suivants à votre développeur iOS et dites-lui de suivre les instructions pour les points suivants :

• Intégration du SDK aux clips d’app
• Configuration de l'attribution des installations à partir des clips d’app
• [Facultatif] Configurez les événements in-app, si vous n'avez pas encore d'événements in-app mesurés pour votre app complète, ou si vous souhaitez utiliser des événements in-app différents pour le clip d’app.

Conditions préalables :

• Modèle OneLink pour votre app complète avec les liens universels iOS configurés.
• Lien OneLink.
• Recommandation : Le modèle et le lien que vous utilisez pour le clip d'app envoient tous les utilisateurs qui n'ont pas votre app complète vers le clip d'app. Par conséquent, envisagez de disposer d'un modèle et d'un lien personnalisé distincts pour les cas où vous souhaitez envoyer ces utilisateurs vers l'App Store, au lieu du clip d’app.

Pour configurer le modèle OneLink pour votre clip d’app :

1. Dans le tableau de bord d'AppsFlyer, allez dans Engagement > Gestion OneLink.
2. Sélectionnez le modèle OneLink que vous utilisez pour diriger les utilisateurs vers votre app complète. 
3. Assurez-vous que les liens universels sont configurés dans le modèle OneLink. (Voir les instructions pour l'ajout de liens universels).
4. Cliquez sur Enregistrer.
   Le fichier AASA est mis à jour pour prendre en charge les clips d’app.
5. Dans le tableau de bord d'AppsFlyer, allez dans Engagement > Gestion OneLink.
6. Sélectionnez le lien personnalisé OneLink basé sur le modèle que vous avez configuré aux étapes 1 à 4 et que vous utilisez pour diriger les utilisateurs via votre clip d’app.
7. Assurez-vous d’avoir indiqué une source média (pid).
   La source média doit être spécifiée dans l'URL (par exemple : pid=chartboost_int) ou contenue dans le lien.

Pour vérifier que les clips d’app sont activés sur AppsFlyer OneLink :

1. Créez une URL pour obtenir votre fichier d'association. L'URL est créée en prenant le domaine de votre modèle OneLink et en ajoutant /.well-known/apple-app-site-association. 
   Exemple : coffee.onelink.me/.well-known/apple-app-site-association.
2. Allez à l'URL de votre fichier d'association.
   Le fichier apple-app-site-association est automatiquement téléchargé.
3. Ouvrez le fichier apple-app-site-association avec un éditeur de texte (par exemple, Notepad).
4. Assurez-vous que le fichier contient le mot "appclips" et que l'ID du bundle se termine par".Clip". Exemple :
   

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

   Si c'est le cas, vous avez réussi à mettre en place des clips d’app du côté d'AppsFlyer, et le clip d’app est mis en œuvre sur n'importe quel modèle OneLink avec le même sous-domaine.

Conditions préalables : Achèvement de la configuration du modèle OneLink pour les clips d'app

Pour configurer votre clip d’app afin qu'il fonctionne avec OneLink : 

1. Sur la page de votre app dans App Store Connect, allez dans Build > Statut de domaine.
2. Assurez-vous que votre domaine OneLink s'affiche sous Build domains et que les statuts Cache et Debug sont tous deux validés.
3. Dans le tableau de bord d'AppsFlyer, allez dans Engagement > Gestion OneLink.
4. Survolez l'icône Actions du lien que vous souhaitez utiliser et cliquez sur Obtenir l'URL. 
5. Enregistrez l'URL courte (ou le préfixe de l'URL longue). 
6. Sur la page de votre app dans App Store Connect, allez dans Clip d’app > Modifier les expériences avancées > +Ajouter > Suivant.
7. Dans URL expérience clip d’app, collez l'URL personnalisée OneLink que vous avez enregistrée à l'étape 5.
   Remarque : Vous pouvez ajouter des paramètres de requête après l'URL personnalisée principale, mais vous ne pouvez pas modifier le chemin d'accès.
8. Cliquez sur Suivant.
   Votre clip d’app est maintenant configuré pour fonctionner avec OneLink. Des instructions supplémentaires concernant les paramètres App Store Connect sont disponibles dans le guide du développeur Apple.

Conditions préalables : Un appareil de test enregistré avec iOS 14 sans votre app complète installée.

Pour tester votre intégration OneLink/clip d’app :

1. Dans le tableau de bord d'AppsFlyer, allez dans Engagement > Gestion OneLink.
2. Survolez l'icône Actions du lien que vous souhaitez tester et cliquez sur Obtenir l'URL. 
3. Scannez le QR code avec votre appareil.
   La carte clip d’app s'affiche sur votre appareil, indiquant que l'intégration OneLink/clip d’app est correctement configurée.