Erste Schritte

Dieser Leitfaden richtet sich an Publisher, die eine iOS-App mit AdMob monetarisieren möchten und nicht Firebase. Wenn Sie Firebase in Ihre App einbinden möchten oder dies erwägen, lesen Sie stattdessen die Informationen zu AdMob mit Firebase in diesem Leitfaden.

Um Anzeigen zu schalten und Umsätze zu generieren, müssen Sie zuerst das Google Mobile Ads SDK in eine App einbinden. Nachdem Sie das SDK eingebunden haben, können Sie mit der Implementierung eines oder mehrerer der unterstützten Anzeigenformate fortfahren.

Voraussetzungen

• Verwenden Sie Xcode 14.1 oder höher.
• Ausrichtung auf iOS 11.0 oder höher

• Empfehlung: Erstellen Sie ein AdMob-Konto und registrieren Sie eine App.

Mobile Ads SDK importieren

CocoaPods (bevorzugt)

Die einfachste Möglichkeit, das SDK in ein iOS-Projekt zu importieren, ist die Verwendung von CocoaPods. Öffnen Sie die Podfile-Datei Ihres Projekts und fügen Sie dem Ziel Ihrer Anwendung diese Zeile hinzu:

pod 'Google-Mobile-Ads-SDK'

Führen Sie dann in der Befehlszeile folgenden Befehl aus:

pod install --repo-update

Wenn Sie CocoaPods noch nicht kennen, finden Sie in der offiziellen Dokumentation Informationen zum Erstellen und Verwenden von Podfiles.

Swift Package Manager

Wichtiger Hinweis :Vermittlungsadapterbibliotheken sind im Swift Package Manager noch nicht verfügbar. Wenn Sie eine Vermittlung verwenden, empfehlen wir eine Einbindung in CocoaPods.

Das Google Mobile Ads SDK unterstützt den Swift Package Manager ab Version 9.0.0. Führen Sie die folgenden Schritte aus, um das Swift-Paket zu importieren.

Hinweis: Wenn Sie von einem CocoaPods-basierten Projekt migrieren, führen Sie pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte Datei .xcworkspace kann anschließend sicher gelöscht werden. Wenn Sie das Google Mobile Ads SDK zum ersten Mal in ein Projekt aufnehmen, können Sie diesen Schritt ignorieren.

1. Installieren Sie in Xcode das Google Mobile Ads Swift Package. Gehen Sie dazu zu File > Add Packages....

2. Suchen Sie in der angezeigten Eingabeaufforderung nach dem GitHub-Repository für das Google Mobile Ads Swift Package:

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. Wählen Sie die gewünschte Version des Google Mobile Ads Swift Package aus. Für neue Projekte empfehlen wir die Verwendung der Option Bis zur nächsten Hauptversion.

Sobald Sie fertig sind, beginnt Xcode, die Paketabhängigkeiten aufzulösen und im Hintergrund herunterzuladen. Weitere Informationen zum Hinzufügen von Paketabhängigkeiten finden Sie im Apple-Artikel.

Manueller Download

1. Laden Sie das SDK-Framework direkt herunter, entpacken Sie es und importieren Sie die folgenden Frameworks in Ihr Xcode-Projekt:

   • GoogleAppMeasurement.xcframework
   • GoogleAppMeasurementIdentitySupport.xcframework
   • GoogleMobileAds.xcframework
   • GoogleUtilities.xcframework
   • nanopb.xcframework
   • PromisesObjC.xcframework
   • UserMessagingPlatform.xcframework

2. Fügen Sie das Linker-Flag -ObjC in den Build-Einstellungen Ihres Projekts unter Andere Verknüpfungs-Flags hinzu:

   

Info.plist-Datei aktualisieren

Aktualisieren Sie die Datei Info.plist Ihrer Anwendung, um zwei Schlüssel hinzuzufügen:

1. Einen GADApplicationIdentifier-Schlüssel mit einem Stringwert IhresAdMob app ID found in the AdMob UI.

2. Einen SKAdNetworkItems-Schlüssel mit SKAdNetworkIdentifier-Werten für Google (cstr6suwn9.skadnetwork) und ausgewählte Drittanbieterkäufer, die Google diese Werte bereitgestellt haben.

Vollständiges Snippet

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4pfyvq9l8r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>5a6flpkh64.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n6fk4nfna4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>eh6m2bh4zr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Wenn Sie noch kein AdMob-Konto und keine App registriert haben, sollten Sie dies jetzt nachholen.

Wichtiger Hinweis :In einer echten App ist es wichtig, dass du deine tatsächlicheAdMob App-ID verwendest, nicht die oben aufgeführte. Wenn Sie das SDK nur in einer Hello World-App testen möchten, können Sie die oben gezeigte Beispiel-App-ID verwenden.

Mobile Ads SDK initialisieren

Rufen Sie vor dem Laden von Anzeigen die Methode startWithCompletionHandler: für GADMobileAds.sharedInstance auf. Dadurch wird das SDK initialisiert und nach Abschluss der Initialisierung (oder nach einer Zeitüberschreitung von 30 Sekunden) wird ein Abschluss-Handler zurückgerufen. Dies muss nur einmal erfolgen, idealerweise beim Start der App. Rufen Sie startWithCompletionHandler: so früh wie möglich auf.

Warnung :Anzeigen können nach dem Aufruf von startWithCompletionHandler: vom Mobile Ads SDK oder von Vermittlungspartner-SDKs vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragespezifische Flags wie tagForChildDirectedTreatment oder tag_for_under_age_of_consent festlegen oder anderweitig vor dem Laden von Anzeigen Maßnahmen ergreifen müssen, müssen Sie dies vor der Initialisierung des Mobile Ads SDK tun.

Hier ein Beispiel dafür, wie die Methode startWithCompletionHandler: in AppDelegate aufgerufen wird:

Beispiel für AppDelegate.m (Auszug)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

Wenn Sie die Vermittlung verwenden, können Sie warten, bis der Abschluss-Handler aufgerufen wird, bevor Sie Anzeigen laden. So sorgen Sie dafür, dass alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

Das Mobile Ads SDK wurde importiert und initialisiert und Sie können eine Anzeige implementieren. AdMob Es stehen verschiedene Anzeigenformate zur Verfügung, sodass Sie dasjenige auswählen können, das am besten zur Nutzererfahrung in Ihrer App passt.

Banner

Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm erscheinen Banneranzeigen bleiben auf dem Bildschirm, während Nutzer mit der App interagieren, und können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch keine Erfahrung mit mobiler Werbung haben, sind sie ein guter Anfang.

Banner implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden. Sie werden am besten bei natürlichen Pausen während der Ausführung einer App eingesetzt, z. B. zwischen Levels eines Spiels oder kurz nach Abschluss einer Aufgabe.

Interstitial implementieren

Nativ

Anpassbare Anzeigen, die zum Design Ihrer App passen. Sie entscheiden, wie und wo sie platziert werden, sodass das Layout besser zum Design Ihrer App passt.

Implementieren Native Ads

Verfügbar

Das sind Anzeigen, in denen Nutzer belohnt werden, wenn sie sich kurze Videos ansehen und mit spielbaren Anzeigen und Umfragen interagieren. Eignet sich gut für die Monetarisierung von Nutzern, die kostenlos spielen.

Anzeigen mit Prämie implementieren

Anzeigen mit Prämie implementieren (neue APIs)