Google Mobile Ads SDK einrichten

Wenn Sie Anzeigen ausliefern und Einnahmen erzielen möchten, müssen Sie Google Mobile Ads SDK in Ihre iOS-App einbinden. Dazu importieren und initialisieren Sie Google Mobile Ads SDK, bevor Sie Anzeigen anfordern.

In dieser Anleitung wird beschrieben, wie Sie Google Mobile Ads SDK importieren und initialisieren und ein Anzeigenformat auswählen.

Vorbereitung

Bevor Sie fortfahren, prüfen Sie, ob Sie Folgendes haben:

  • Xcode 16.0 oder höher
  • iOS 13.0 oder höher

Google Mobile Ads SDK importieren

Führen Sie einen der folgenden Schritte aus, um Google Mobile Ads SDK zu importieren:

Swift Package Manager

So fügen Sie Ihrem Projekt eine Paketabhängigkeit hinzu:

  1. Öffnen Sie Xcode.
  2. Gehen Sie zu File > Add Package Dependencies... (Datei > Paketabhängigkeiten hinzufügen).
  3. Installieren Sie das Google Mobile Ads SDK Swift Package.

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

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Wählen Sie die Version des Google Mobile Ads SDK Swift Package aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir Up to Next Major Version (Bis zur nächsten Hauptversion).

CocoaPods

So verwenden Sie CocoaPods: Befolgen Sie diese Schritte:

  1. Öffnen Sie die Podfile-Datei Ihres Projekts und fügen Sie der Build-Konfiguration target Ihrer App diese Zeile hinzu:

    pod 'Google-Mobile-Ads-SDK'
  2. Führen Sie in einem Terminal folgenden Befehl aus:

    pod install --repo-update

Manueller Download

So laden Sie Google Mobile Ads SDK manuell herunter:

  1. Herunterladen Google Mobile Ads SDK.
  2. Entpacken Sie das Paket googlemobileadssdkios.zip.
  3. Fügen Sie Ihrem Xcode-Projekt die folgenden Frameworks hinzu:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. Gehen Sie in den General -Einstellungen (Allgemein) Ihres Ziels zu Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte).

  5. Prüfen Sie, ob Sie für GoogleMobileAds.xcframework und UserMessagingPlatform.xcframework die Option Embed & Sign (Einbetten und signieren) festgelegt haben.

  6. Führen Sie in den Build-Einstellungen Ihres Projekts folgende Schritte aus:

    • Fügen Sie den Pfad /usr/lib/swift zu Runpath Search Paths (Suchpfade für Ausführungspfad) hinzu.
    • Fügen Sie das Linker-Flag -ObjC zu Other Linker Flags (Andere Linker-Flags) hinzu.

Info.plist-Datei aktualisieren

Fügen Sie der Datei Info.plist Ihrer App die folgenden Schlüssel hinzu:

  • Einen GADApplicationIdentifier-Schlüssel mit einem Stringwert Ihrer Ad Manager-App-ID, die Sie in der Ad Manager-Benutzeroberfläche finden. Die ID hat das Format ca-app-pub-################~##########.

  • Einen SKAdNetworkItems-Schlüssel. Dieser Schlüssel enthält SKAdNetworkIdentifier Werte für Google cstr6suwn9.skadnetwork und ausgewählte Drittanbieter.

Vollständiges Beispiel

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</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>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.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>wg4vff78zm.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>mlmmfzh3r3.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>su67r6k2v3.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>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>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.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>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.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>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.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>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Ersetzen Sie SAMPLE_APP_ID durch Ihre Ad Manager-App-ID. Verwenden Sie beim Testen die im vorherigen Beispiel gezeigte Beispiel-App-ID.

Damit Ihre App schneller initialisiert wird, verknüpfen Sie Ihre Ertragsgruppen mit bestimmten Apps. Wenn eine Ertragsgruppe auf iOS ausgerichtet ist, aber nicht mit einer App verknüpft ist, sendet Google die Gruppe an alle iOS-Apps in Ihrem Konto. Dieser Ansatz kann die Leistung beeinträchtigen.

Google Mobile Ads SDK initialisieren

Bevor Sie Anzeigen laden, initialisieren Sie Google Mobile Ads SDK, indem Sie die Methode start() über die Eigenschaft GADMobileAds.sharedInstance aufrufen. Diese Methode ruft einen Completion-Handler auf, nachdem Google Mobile Ads SDK und Vermittlungsadapter die Verarbeitung abgeschlossen haben oder nach 30 Sekunden.

Im folgenden Beispiel wird Google Mobile Ads SDK initialisiert:

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];

Bei der Initialisierung lädt Google Mobile Ads SDK möglicherweise Anzeigen vor oder initialisiert Drittanbieter- SDKs, wenn die startWithCompletionHandler: Methode aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich oder in der Schweiz einholen müssen, legen Sie anfragespezifische Flags fest. Wenn Sie anfragespezifische Flags festlegen müssen, tun Sie das, bevor Sie initialisieren Google Mobile Ads SDK. Weitere Informationen finden Sie unter Targeting.

Anzeigenformat auswählen

Nachdem Sie Google Mobile Ads SDK importiert haben, können Sie ein Anzeigenformat auswählen, das Sie implementieren möchten.

In Ad Manager sind die folgenden Anzeigenformate verfügbar:

Anzeigenformat Beschreibung Dokumentation
Banner Rechteckige Anzeigen in einem Bereich des App-Layouts. Diese Anzeigen werden in festgelegten Intervallen automatisch aktualisiert. Nutzer sehen diese Anzeigen regelmäßig, wenn sie auf derselben Seite bleiben. Banneranzeigen einrichten
Interstitial Ganzseitige Anzeigen in Ihrer App. Platzieren Sie diese Anzeigen an natürlichen Unterbrechungs- oder Übergangspunkten in der App, etwa beim Abschluss eines Levels in einer Gaming-App. Interstitial-Anzeigen
Nativ Sie können Assets wie Anzeigentitel und Calls-to-Action in Ihren Apps anpassen. Wenn Sie die Anzeige anpassen, erstellen Sie Anzeigen, die zum visuellen Design Ihrer App passen. Native Anzeigen laden
Verfügbar Nutzer können In-App-Prämien wie Münzen oder Punkte erhalten, indem sie Spiele spielen, an Umfragen teilnehmen oder sich Videos ansehen. Sie können Prämien für Anzeigenblöcke festlegen und angeben, welche Prämienwerte oder -artikel die Nutzer erhalten. Anzeigen mit Prämie
Interstitial mit Prämie Sie können Prämien wie Münzen oder Extraleben für Anzeigen anbieten, die während App-Übergängen ausgeliefert werden. Interstitial-Anzeigen mit Prämie
App-Start Wird eingeblendet, wenn Nutzer Ihre App öffnen oder zu ihr zurückkehren. Die Anzeige wird als Overlay über dem Ladebildschirm eingeblendet. App-Start-Anzeigen