Integracja pakietu SDK do reklam mobilnych Google z aplikacją to pierwszy krok do wyświetlania reklam i zarabiania. Gdy to zrobisz, możesz zaimplementować co najmniej jeden z obsługiwanych formatów reklam.
Wymagania wstępne
- Używaj Xcode w wersji 16.0 lub nowszej.
- Docelowy system iOS 12.0 lub nowszy
Zaimportuj pakiet SDK do reklam mobilnych
Aby zaimportować pakiet SDK do reklam mobilnych Google, użyj jednej z tych metod.
Swift Package Manager
Aby dodać zależność pakietu do projektu, wykonaj te czynności:
W Xcode zainstaluj pakiet Swift reklam mobilnych Google, klikając File > Add Package Dependencies... (Plik > Dodaj zależności pakietu...).
W wyświetlonym oknie wyszukaj repozytorium pakietu Google Mobile Ads Swift Package w GitHubie:
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
Wybierz wersję pakietu Swift Google Mobile Ads, której chcesz używać. W przypadku nowych projektów zalecamy używanie opcji Do następnej wersji głównej.
CocoaPods
Zanim przejdziesz dalej, zapoznaj się z informacjami o tworzeniu i używaniu plików Podfile w artykule Korzystanie z CocoaPods.
Aby używać CocoaPods, wykonaj te czynności:
Otwórz plik Podfile projektu i dodaj ten wiersz do konfiguracji kompilacji
target
aplikacji:pod 'Google-Mobile-Ads-SDK'
W terminalu uruchom:
pod install --repo-update
Pobieranie ręczne
Pobierz pakiet SDK do reklam mobilnych Google i
Embed & Sign
te frameworki do projektu Xcode:GoogleMobileAds.xcframework
UserMessagingPlatform.xcframework
W ustawieniach kompilacji projektu:
- Dodaj ścieżkę
/usr/lib/swift
do Ścieżek wyszukiwania ścieżki wykonywania. - Dodaj flagę łączącą
-ObjC
do sekcji Inne flagi łączące.
- Dodaj ścieżkę
Zaktualizuj plik Info.plist
Zaktualizuj plik Info.plist
aplikacji, aby dodać 2 klucze:
Klucz
GADApplicationIdentifier
z wartością ciągu znaków, która jest identyfikatorem aplikacji Ad Managera znajdującym się w interfejsie Ad Managera i ma postaćca-app-pub-################~##########
.Klucz
SKAdNetworkItems
z wartościamiSKAdNetworkIdentifier
dla Google (cstr6suwn9.skadnetwork
) i wybranych kupujących zewnętrznych, którzy przekazali te wartości Google.
Pełny fragment
<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>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>
Zastąp SAMPLE_APP_ID identyfikatorem aplikacji w usłudze Ad Manager. Podczas testowania użyj przykładowego identyfikatora aplikacji pokazanego w poprzednim przykładzie.
Aby uzyskać optymalną wydajność inicjowania, ważne jest powiązanie grup zysku z konkretnymi aplikacjami, w których są one używane. Konfiguracje grup przychodów kierowane na iOS i niepowiązane z żadną konkretną aplikacją będą wysyłane do wszystkich aplikacji na iOS na Twoim koncie, co może wydłużyć czas potrzebny na inicjację.
Inicjowanie pakietu SDK do reklam mobilnych
Przed wczytaniem reklam wywołaj metodę start()
w obiekcie GADMobileAds.sharedInstance
, która inicjuje pakiet SDK i wywołuje zwrotnie procedurę obsługi po zakończeniu inicjowania (lub po 30 sekundach bezczynności). Zadzwoń do start()
jak najszybciej.
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];
Wybierz format reklamy
Pakiet SDK do reklam mobilnych został zaimportowany i zainicjowany. Możesz teraz wdrożyć reklamę. Ad Manager oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej pasuje do wrażeń użytkowników Twojej aplikacji.
Baner
W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układu aplikacji. Mogą one być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy zobaczą nowe reklamy w regularnych odstępach czasowych, nawet jeśli pozostaną na tym samym ekranie w aplikacji. Jest to format reklamy najprostszy do wdrożenia.
Pełnoekranowa
Jednostki reklam pełnoekranowych wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je w naturalnych przerwach między elementami strony lub podczas przejścia z jednego etapu do następnego w interfejsie aplikacji, np. po ukończeniu poziomu w grze mobilnej.
Wdrażanie reklam pełnoekranowych
Natywna
Reklamy natywne to reklamy, w których możesz dostosować sposób wyświetlania w aplikacjach zasobów takich jak nagłówki i wezwania do działania. Dzięki samodzielnemu stylowi reklamy możesz tworzyć naturalne, nienachalne prezentacje reklam, które mogą wzbogacać wrażenia użytkowników.
Google Ad Manager udostępnia 2 sposoby implementowania reklam natywnych: style natywne i standardowe reklamy natywne za pomocą renderowania niestandardowego.
Style natywne zostały zaprojektowane z myślą o uproszczeniu wdrażania reklam natywnych i są doskonałym wyborem, jeśli dopiero zaczynasz korzystać z tego formatu. Renderowanie niestandardowe zostało zaprojektowane tak, aby zapewnić Ci jak największą swobodę tworzenia prezentacji.
Wdrażanie stylów natywnych Wdrażanie reklam natywnych (renderowanie niestandardowe)
Z nagrodą
Jednostki reklamowe z nagrodą umożliwiają użytkownikom granie w gry, wypełnianie ankiet lub oglądanie filmów, aby zdobywać nagrody w aplikacji, takie jak monety, dodatkowe życia lub punkty. Możesz ustawić różne nagrody w różnych jednostkach reklamowych i określić wartości nagród oraz elementy, które otrzymał użytkownik.
Reklamy pełnoekranowe z nagrodą
Reklama pełnoekranowa z nagrodą to nowy format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji, takich jak monety lub dodatkowe życia. Reklamy tego typu wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji.
W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na wyświetlenie reklamy pełnoekranowej z nagrodą.
Zamiast prośby o zgodę stosowanej w reklamach z nagrodą reklamy pełnoekranowe z nagrodą na początku wyświetlają ekran z informacjami o nagrodzie za obejrzenie danej reklamy i dają użytkownikowi możliwość jej pominięcia.
Wdrażanie reklam pełnoekranowych z nagrodą
Reklama przy otwarciu aplikacji
Reklama wyświetlana przy otwarciu aplikacji to format reklamy, który wyświetla się, gdy użytkownicy otwierają Twoją aplikację lub do niej wracają. Reklama nakłada się na wczytywany ekran.
Wdrażanie reklam wyświetlanych przy otwarciu aplikacji