Wypróbuj

Ten przewodnik jest przeznaczony dla wydawców, którzy w AdMob chcą zarabiać na aplikacji na iOS i nie używają Firebase. Jeśli chcesz uwzględnić w swojej aplikacji Firebase (lub rozważasz jej wykorzystanie), zapoznaj się z przewodnikiem w wersji AdMob z Firebase .

Integracja pakietu SDK do reklam mobilnych Google z aplikacją to pierwszy krok w kierunku wyświetlania reklam i generowania przychodów. Po zintegrowaniu pakietu SDK możesz zaimplementować co najmniej jeden obsługiwany format reklam.

Wymagania wstępne

• Użyj Xcode w wersji 13.2.1 lub nowszej
• Kieruj na urządzenia z systemem iOS 10.0 lub nowszym

• Zalecane: utwórz konto AdMob i zarejestruj aplikację.

Importowanie pakietu SDK do reklam mobilnych

CocoaPods (preferowane)

Najprostszym sposobem zaimportowania pakietu SDK do projektu iOS jest użycie CocoaPods. Otwórz plik Podfile projektu i dodaj ten wiersz do lokalizacji docelowej aplikacji:

pod 'Google-Mobile-Ads-SDK'

Następnie z poziomu wiersza poleceń:

pod install --repo-update

Jeśli dopiero zaczynasz korzystać z CocoaPods, zapoznaj się z ich oficjalną dokumentacją, aby dowiedzieć się, jak tworzyć i używać podPodów.

Menedżer pakietów Swift

Ważne: biblioteki adapterów zapośredniczenia nie są jeszcze dostępne w Menedżerze pakietów Swift. Jeśli używasz zapośredniczenia, zalecamy integrację z CocoaPods.

Pakiet SDK do reklam mobilnych Google obsługuje Menedżera pakietów Swift od wersji 9.0.0. Aby zaimportować pakiet Swift, wykonaj poniższe czynności.

Uwaga: jeśli przeprowadzasz migrację z projektu opartego na CocoaPods, uruchom pod deintegrate, aby usunąć CocoaPods z projektu Xcode. Plik .xcworkspace wygenerowany przez CocoaPods można bezpiecznie usunąć później. Jeśli dodajesz pakiet SDK do reklam mobilnych Google do projektu po raz pierwszy, ten krok można zignorować.

1. W Xcode zainstaluj pakiet Swift reklam mobilnych Google, klikając Plik > Dodaj pakiety....

2. W wyświetlonym oknie wyszukaj pakiet Swift pakietu reklam mobilnych Google GitHub:

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

3. Wybierz wersję pakietu Google Mobile Ads Swift, której chcesz użyć. W przypadku nowych projektów zalecamy korzystanie z najwyższej wersji głównej.

Gdy skończysz, Xcode zacznie usuwać zależności pakietu i pobierać je w tle. Więcej informacji o dodawaniu zależności pakietów znajdziesz w artykule Apple.

Pobieranie ręczne

1. bezpośrednio pobrać i rozpakować ramkę SDK, a potem zaimportować do projektu Xcode te platformy:

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

2. Dodaj flagę łączącą -ObjC do Innych flag łączących w ustawieniach kompilacji projektu:

   

Zaktualizuj plik Info.plist

Zaktualizuj plik Info.plist aplikacji, aby dodać 2 klucze:

1. Klucz GADApplicationIdentifier z wartością ciągu znakówAdMob app ID found in the AdMob UI.

2. Klucz SKAdNetworkItems z wartościami SKAdNetworkIdentifier dla Google (cstr6suwn9.skadnetwork) i zewnętrznymi kupującymi, którzy podali je Google.

Pełny fragment

<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>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>3sh42y64q3.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>prcb7njmu6.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>9rd848q2bz.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>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>av6w8kgt66.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>424m5254lk.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>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>gta9lk7p23.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>

Jeśli nie masz jeszcze konta AdMob ani jego rejestracji, to dobry moment, aby to zrobić.

Ważne: w przypadku prawdziwej aplikacji należy użyć rzeczywistegoAdMob identyfikatora aplikacji, a nie tego, który został wymieniony powyżej. Jeśli jednak chcesz tylko poeksperymentować z pakietem SDK w aplikacji Hello World, możesz użyć przykładowego identyfikatora aplikacji podanego powyżej.

Zainicjuj pakiet SDK do reklam mobilnych

Przed wczytaniem reklam wywołaj metodę startWithCompletionHandler: na urządzeniu GADMobileAds.sharedInstance, która inicjuje pakiet SDK i wywołuje moduł obsługi po zakończeniu inicjowania (lub gdy upłynie 30 sekund). Wystarczy to zrobić tylko raz, najlepiej przy uruchamianiu aplikacji. Zadzwoń do startWithCompletionHandler: jak najszybciej.

Ostrzeżenie: reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych lub pakiety SDK partnerów zapośredniczenia podczas wywoływania usługi startWithCompletionHandler:. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), ustaw odpowiednie flagi (np. tagForChildDirectedTreatment lub tag_for_under_age_of_consent) lub w inny sposób wykonaj jakieś czynności przed załadowaniem reklam, zanim to zrobisz, zainicjuj pakiet SDK do reklam mobilnych.

Oto przykład wywołania metody startWithCompletionHandler: w elemencie AppDelegate:

Przykładowy plik AppDelegate.m (fragment)

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

Jeśli korzystasz z zapośredniczenia, przed wczytaniem reklam warto zaczekać na wywołanie modułu obsługi zakończonego, ponieważ dzięki temu zainicjujesz wszystkie adaptery zapośredniczenia.

Wybierz format reklamy

Pakiet SDK do reklam mobilnych został zaimportowany i zainicjowany. Możesz teraz wdrożyć reklamę. AdMob Oferuje różne formaty reklam, dzięki czemu możesz wybrać taką, która najlepiej odpowiada użytkownikom aplikacji.

Baner

Prostokątne reklamy, które wyświetlają się u góry lub u dołu ekranu urządzenia. Banery reklamowe pozostają na ekranie, gdy użytkownicy używają aplikacji, i po określonym czasie mogą się automatycznie odświeżać. Jeśli dopiero zaczynasz korzystać z reklam mobilnych,

Baner reklamowy

Pełnoekranowa

Reklamy pełnoekranowe zasłaniające interfejs aplikacji, dopóki użytkownik ich nie zamknie. Najlepiej sprawdza się w naturalnych przerwach w korzystaniu z aplikacji, np. między poziomami gry lub zaraz po ukończeniu zadania.

Stosowanie reklamy pełnoekranowej

Natywny

Reklamy dostosowywane do wyglądu i stylu Twojej aplikacji. Ty decydujesz, jak i gdzie się wyświetlają, więc ich układ jest bardziej spójny z aplikacją.

Wdrożenie Native Ads

Otrzymano

Reklamy z nagrodą dla użytkowników, którzy oglądają krótkie filmy oraz wchodzą w interakcje z reklamami i ankietami. To dobry sposób, by zarabiać na bezpłatnych grach.

Wdrażanie reklam z nagrodą

Wdrażanie reklam z nagrodą (nowe interfejsy API)