Das Audience Network-SDK zu deiner iOS-App hinzufügen

Jetzt auf Änderungen in iOS 14.5 reagieren

Alle Publisher müssen das Audience Network-SDK 6.2.1 oder höher verwenden, um mit Nutzer*innen von iOS 14.5 Geld zu verdienen. (Wir empfehlen das Audience Network-SDK 6.2.1 außerdem für Nutzer*innen von iOS 14.) Innerhalb dieser Version gibt es zwei Anforderungen:

Implementieren des Flags setAdvertiserTrackingEnabled unabhängig von der Verwendung von Mediation, um uns darüber zu informieren, ob die Daten zur Auslieferung personalisierter Werbeanzeigen verwendet werden sollen
Hinzufügen der vorgeschlagenen SKAdNetwork-IDs zur Info.plist des Xcode-Projekts, damit Werbetreibende den Erfolg von Werbekampagnen messen können.

Weitere Informationen findest du in unserem Beitrag Meta for Developers.

Führe ein Upgrade auf die neueste Version des SDK durch, bevor du deine App für die Monetarisierung freischaltest.

In diesem Leitfaden wird erläutert, wie du das Audience Network-SDK in deine iOS-App einbindest, um Audience Network APIs aufrufen zu können. Die bevorzugte Methode besteht darin, CocoaPods zum Verwalten von Abhängigkeiten zu verwenden. Es werden jedoch auch Download-Speicherorte für die manuelle Integration bereitgestellt.

CocoaPods (bevorzugte Download-Methode)

Füge dem Podfile deines Projekts die folgende Zeile hinzu.

pod 'FBAudienceNetwork'

Führe den folgenden Befehl aus.

pod install

Anleitung herunterladen

Wenn die Verwendung von CocoaPods keine Option ist, kannst du das Audience Network-SDK über einen der Links in der folgenden Tabelle herunterladen.

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

Nachdem du das Audience Network-SDK heruntergeladen hast, führe die Integration wie folgt durch:

Öffne dein Projekt in XCode.
Ziehe die Datei FBAudienceNetwork.xcframework aus dem Ordner Dynamic in dein heruntergeladenes Archiv des Audience Network-SDK für iOS in XCode.
Wähle im Tab General in den Zieleinstellungen deiner Anwendung die Option Embed & Sign für FBAudienceNetwork.xcframework aus.

Hinweise

Du kannst auch eine statische Variante des Audience Network-SDK verwenden, die im Download bereitgestellt wird. Verwende hierzu die Datei FBAudienceNetwork.xcframework aus dem Ordner Static.
Wenn du die statische Variante verwenden möchtest, stelle sicher, dass dein Projekt Swift verwendet. Falls dein Projekt nicht Swift verwendet, füge eine leere Swift-Datei zu deinem Projekt hinzu (File -> New -> Swift in XCode).
Wenn dein Projekt auf eine ältere Version als iOS 12.4 ausgerichtet ist, stelle sicher, dass im Ziel deiner Anwendung in XCode unter Build settings für die Einstellung Always embed Swift standard libraries die Option YES ausgewählt ist.
Verwende CocoaPods, um zusätzlich notwendige Anpassungen nach der manuellen Installation zu vermeiden.

Fehlerbehebung für SDK-Version 6.9.0 und höher

Ab Version 6.9.0 ist Swift im Audience Network-SDK für iOS aktiviert. Nachfolgend findest du einige Punkte zur Behebung der häufigsten Probleme bei der Installation des SDK und der Interoperabilität mit Swift:

XCode gibt die folgenden Fehler zurück: „Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection“ und „Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider“. Diese Fehler weisen darauf hin, dass du nicht die neueste Version von XCode verwendest. Führe ein Update auf XCode 13 oder eine neuere Version durch, um diese Fehler zu beheben.
XCode gibt mehrere Fehler vom Typ „Undefined symbol__swift_FORCE_LOAD_$_“ zurück. Diese Fehler bedeuten, dass die Unterstützung von Swift in deinem Projekt nicht aktiviert ist. Die einfachste Möglichkeit, diesen Fehler zu beheben, besteht darin, eine leere Swift-Datei hinzuzufügen („File“ -> „New“ -> „Swift file“ in XCode).
Bei der Ausführung auf einem Gerät stürzt die App direkt nach dem Start ab und gibt den Fehler „dyld: Library not loaded: @rpath/FBAudienceNetwork.framework“ zurück. Dieser Fehler bedeutet, dass du das Audience Network-SDK nicht in deine App eingebettet hast. Gehe zu deinen Zieleinstellungen und wähle „Embed & Sign“ für „FBAudienceNetwork.xcframework“ auf dem Tab „General“ aus.
Die Anwendung stürzt direkt nach dem Start ab und gibt den Fehler „dyld: Library not loaded: @rpath/FBAudienceNetwork.framework“ zurück. Dieser Fehler weist darauf hin, dass du eine App auf einer iOS-Version ausführst, die älter ist als iOS 12.4, und für die Einstellung „Always embed Swift standard libraries“ nicht „YES“ ausgewählt hast. Stelle sicher, dass für die Einstellung „Always embed Swift standard libraries“ unter „Build settings“ im Ziel deiner Anwendung in XCode „YES“ ausgewählt ist.