Ajouter le SDK Audience Network à votre application iOS

Réagissez maintenant aux modifications d’iOS 14.5

Tou·tes les éditeur·ices doivent utiliser le SDK Audience Network 6.2.1 ou une version ultérieure pour monétiser auprès des utilisateur·ices d’iOS 14.5. (Nous recommandons également le SDK Audience Network 6.2.1 pour les utilisateur·ices d’iOS 14.) Cette version comporte deux exigences :

Mise en œuvre de l’indicateur ‘setAdvertiserTrackingEnabled’ indépendamment de l’utilisation d’une médiation, pour nous informer de la possibilité d’utiliser les données pour diffuser des publicités personnalisées.
Ajout des ID SKAdNetwork suggérés au fichier Info.plist du projet Xcode afin que les annonceurs puissent mesurer le succès de leurs campagnes publicitaires.

Pour en savoir plus, consultez notre publication Meta for Developers.

Effectuez la mise à niveau vers la dernière version du SDK avant d’intégrer votre application pour la monétisation.

Ce guide explique comment ajouter le SDK Audience Network à votre application iOS afin d’appeler les API Audience Network. La méthode préconisée pour gérer les dépendances consiste à utiliser CocoaPods. Toutefois, les emplacements de téléchargement vous sont également fournis au cas où vous souhaiteriez procéder à l’intégration manuelle.

CocoaPods (méthode de téléchargement préférée)

Ajoutez la ligne suivante au Podfile de votre projet.

pod 'FBAudienceNetwork'

Exécutez la commande suivante.

pod install

Téléchargement manuel

Si vous ne pouvez pas utiliser CocoaPods, vous pouvez télécharger le SDK Audience Network à partir de l’un des emplacements répertoriés dans le tableau suivant.

Package	Date	Change Log
iOS Audience Network SDK 6.16.0	Oct 15, 2024	6.16.0 Change Log
iOS Audience Network SDK 6.15.2	Aug 15, 2024	6.15.2 Change Log

Après avoir téléchargé le SDK Audience Network, procédez comme suit pour effectuer l’intégration :

Ouvrez votre projet dans Xcode.
Faites glisser dans Xcode le fichier FBAudienceNetwork.xcframework du dossier Dynamic situé dans l’archive du SDK Audience Network pour iOS que vous avez téléchargée.
Dans l’onglet General (Général) des paramètres de la cible de votre application, sélectionnez Embed & Sign (Intégrer et signer) pour FBAudienceNetwork.xcframework.

Remarques

Vous pouvez également utiliser la variante statique du SDK Audience Network fournie dans le téléchargement. Pour ce faire, faites glisser le fichier FBAudienceNetwork.xcframework à partir du dossier Static.
Si vous souhaitez utiliser la variante Static, assurez-vous que votre projet utilise Swift. Si ce n’est pas le cas, ajoutez un fichier Swift vide à votre projet en sélectionnant File -> New -> Swift (Fichier -> Nouveau -> Swift) dans Xcode.
Si votre projet cible une version d’iOS antérieure à 12.4, veillez à définir le paramètre Always embed Swift standard libraries (Toujours intégrer les bibliothèques standards Swift) sur YES (OUI), sous l’onglet Build settings (Paramètres de version) de la cible de votre application dans Xcode.
Pour éviter tout ajout de modifications supplémentaires suite à l’installation manuelle, utilisez CocoaPods.

Résolution des problèmes relatifs aux versions 6.9.0 et ultérieures du SDK

À partir de la version 6.9.0, le SDK Audience Network pour iOS prend en charge le langage Swift. Examinez les différents points ci-dessous pour découvrir les problèmes les plus courants liés à l’installation du SDK et à son interopérabilité avec Swift :

Xcode génère les erreurs suivantes : « Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection » et « Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider ». Ces erreurs signifient que vous n’utilisez pas la dernière version de Xcode. Pour corriger ces erreurs, mettez Xcode à jour vers la version 13 ou une version ultérieure.
Xcode génère de nombreuses erreursUndefined symbol__swift_FORCE_LOAD_$_. Ces erreurs signifient que la prise en charge de Swift n’est pas activée pour votre projet. Le moyen le plus simple de résoudre ce problème consiste à ajouter un fichier Swift vide en sélectionnant File -> New -> Swift file (Fichier -> Nouveau -> Fichier Swift) dans Xcode.
Lorsque l’application s’exécute sur un appareil, elle plante juste après avoir démarré avec l’erreur suivante : « dyld: Library not loaded: @rpath/FBAudienceNetwork.framework ». Cette erreur signifie que vous n’avez pas intégré le SDK Audience Network à votre application. Accédez aux paramètres de votre cible et choisissez l’option Embed & Sign (Intégrer et signer) pour FBAudienceNetwork.xcframework dans l’onglet General (Général).
L’application plante juste après avoir démarré avec l’erreur suivante : « dyld: Library not loaded: @rpath/libswiftCore.dylib ». Cette erreur signifie que vous exécutez une application sur une version d’iOS postérieure à 12.4 et que vous n’avez pas défini l’option Always embed Swift standard libraries (Toujours intégrer les bibliothèques standards Swift) sur YES (OUI). Veillez à définir l’option Always embed Swift standard libraries (Toujours intégrer les bibliothèques standards Swift) sur YES (OUI) sous l’onglet Build settings (Paramètres de version) de la cible de votre application dans Xcode.