Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z PubMatic przy użyciu mediacji AdMob, a także jak przeprowadzać integracje oparte na licytowaniu. Wyjaśnia, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej i jak zintegrować PubMatic i adapter z aplikacją na iOS.
Obsługiwane integracje i formaty reklam
Adapter do mediacji w PubMatic ma te funkcje:
| Integracja | |
|---|---|
| Określanie stawek | |
| Wodospad | |
| Formaty | |
| Reklama przy otwarciu aplikacji | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Reklama pełnoekranowa z nagrodą | |
| Natywna | |
Wymagania
- iOS w wersji 12.0 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.
Krok 1. Skonfiguruj ustawienia w interfejsie PubMatic
Zaloguj się na konto PubMatic i wybierz kartę OpenWrap SDK.
Dodawanie nowej aplikacji
Przejdź na kartę Aplikacje i kliknij przycisk Dodaj aplikację.
Wybierz platformę, a także adres URL sklepu z aplikacjami i nazwę aplikacji.
W sekcji Ścieżka integracji wybierz iOS (Objective-C / Swift) i jako Ścieżkę integracji podrzędnej wybierz AdMob – określanie stawek przez pakiet SDK. Następnie kliknij przycisk Dodaj aplikację.
Aktualizowanie pliku app-ads.txt
Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt.
Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.
Zanim aplikacja zostanie ukończona, wyświetlimy odpowiednie wpisy, które możesz dodać do app-ads.txt.
Więcej informacji o wdrażaniu app-ads.txt w przypadku PubMatic znajdziesz w artykule Jak wdrożyć plik app-ads.txt.
Identyfikator profilu
Po utworzeniu aplikacji otwórz kartę Aplikacje i zanotuj identyfikator profilu nowo utworzonej aplikacji.
Utwórz jednostkę reklamową
Na karcie Jednostki reklamowe wybierz aplikację utworzoną w poprzedniej sekcji i kliknij przycisk Utwórz jednostkę reklamową.
Wypełnij formularz, wpisując szczegóły jednostki reklamowej, i kliknij Zapisz.
Zapisz nowo utworzony identyfikator jednostki reklamowej OpenWrap.
Uzyskiwanie identyfikatora wydawcy
Otwórz panel informacyjny Analytics. Najedź kursorem na ikonę profilu i zanotuj swój identyfikator.
Krok 2. Skonfiguruj popyt PubMatic w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać pakiet SDK PubMatic OpenWrap do konfiguracji zapośredniczenia w przypadku jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie pakietu PubMatic OpenWrap SDK jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.
Wpisz format reklamy i platformę, a potem kliknij Dalej.
Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy mediacji na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.
Na karcie Jednostki reklamowe powinny się teraz wyświetlać wybrane przez Ciebie jednostki reklamowe:
Dodawanie pakietu PubMatic OpenWrap SDK jako źródła reklam
Na karcie Ustalanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz PubMatic OpenWrap SDK.Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek za pomocą pakietu PubMatic OpenWrap SDK.
Kliknij Potwierdzam i wyrażam zgodę, a potem Dalej.
Jeśli masz już mapowanie pakietu PubMatic OpenWrap SDK, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz identyfikator jednostki reklamowej OpenWrap uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.
Dodawanie PubMatic do listy partnerów reklamowych w przypadku RODO i przepisów stanowych w USA
Aby dodać PubMatic do listy partnerów reklamowych, którzy przestrzegają rozporządzeń europejskich i amerykańskich przepisów stanowych, w interfejsie AdMob wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.
Krok 3. Zaimportuj pakiet SDK i adapter PubMatic
CocoaPods (zalecane)
Dodaj do pliku Podfile projektu ten wiersz:
pod 'GoogleMobileAdsMediationPubMatic'W wierszu poleceń uruchom:
pod install --repo-update
Integracja ręczna
Pobierz najnowszą wersję pakietu PubMatic OpenWrap SDK na iOS i połącz wszystkie pliki i pakiety
.xcframeworkw projekcie.Pobierz najnowszą wersję adaptera PubMatic z linku do pobierania w dzienniku zmian i połącz go z projektem.
PubMaticAdapter.xcframework
Krok 4. Wdróż ustawienia prywatności w pakiecie PubMatic SDK
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymywali określone informacje i wyrażali zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Gdy prosisz użytkowników o zgodę, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może zbierać, otrzymywać lub wykorzystywać dane osobowe, oraz podać informacje o sposobie wykorzystywania danych przez każdą z tych sieci. Google nie może obecnie automatycznie przekazywać do takich sieci informacji o wyborze użytkownika dotyczącego zgody.
PubMatic automatycznie odczytuje zgodę na przetwarzanie danych zgodnie z GDPR ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielania dodatkowej zgody, w tym pakiet UMP SDK. Więcej informacji znajdziesz w artykule Przekazywanie informacji o zgodzie użytkowników z UE zgodnie z RODO.
amerykańskie przepisy stanowe o ochronie prywatności,
Przepisy dotyczące prywatności w amerykańskich stanach wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w Twoim łańcuchu zapośredniczenia. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.
PubMatic automatycznie odczytuje sygnał zgody GPP ustawiony przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google o nazwie „Udzielenie dodatkowej zgody”, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Przekazywanie sygnału o zgodzie użytkownika w ramach GPP.
Krok 5. Dodaj wymagany kod
Integracja z SKAdNetwork
Postępuj zgodnie z dokumentacją PubMatic, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.
Krok 6. Przetestuj implementację
Włączanie reklam testowych
Upewnij się, że zarejestrowano urządzenie testowe w AdMob.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK PubMatic OpenWrap, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam PubMatic (ustalanie stawek).
Kroki opcjonalne
Reklamy natywne
Renderowanie reklam
Adapter PubMatic zwraca reklamy natywne jako obiekty.GADNativeAd Wypełnia te pola w przypadku GADNativeAd:
| Pole | Zasoby zawsze uwzględniane przez adapter PubMatic |
|---|---|
| Nagłówek | |
| Obraz | |
| Treść | |
| Ikona | |
| Wezwanie do działania | |
| Ocena w gwiazdkach | |
| Sklep | |
| Cena | |
| Reklamodawca |
Kody błędów
Jeśli adapter nie otrzyma reklamy z PubMatic, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:
GADMediationAdapterPubMatic
Oto kody i komunikaty wyświetlane przez adapter PubMatic, gdy nie uda się wczytać reklamy:
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy. |
| 102 | com.google.ads.mediation.pubmatic | Żądanie zbierania sygnałów ustalania stawek nie zostało zrealizowane, ponieważ w parametrach żądania określono wiele formatów, brak formatu lub nieobsługiwany format. |
| 103 | com.google.ads.mediation.pubmatic | Nieprawidłowa konfiguracja reklamy do wczytania reklamy. |
| 104 | com.google.ads.mediation.pubmatic | Nie udało się wyświetlić reklamy pełnoekranowej, ponieważ nie była gotowa. |
| 105 | com.google.ads.mediation.pubmatic | Nie udało się wyświetlić reklamy z nagrodą, ponieważ nie była ona gotowa. |
| 106 | com.google.ads.mediation.pubmatic | Nie udało się wczytać jednego ze źródeł obrazu reklamy natywnej. |
| 1001-5002 | Wysłane przez pakiet SDK PubMatic | Pakiet SDK PubMatic zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic. |
Dziennik zmian adaptera mediacji PubMatic na iOS
Wersja 4.7.0.0
- Pierwsza wersja.
- Obsługuje określanie stawek w przypadku formatów reklam banerowych, pełnoekranowych, z nagrodą i natywnych.
- Zweryfikowana zgodność z pakietem PubMatic OpenWrap SDK w wersji 4.7.0.
Zaprojektowano i przetestowano z użyciem:
- SDK do reklam mobilnych Google w wersji 12.6.0.
- PubMatic OpenWrap SDK w wersji 4.7.0.