Integracja PubMatic z zapośredniczeniem

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, w tym integracji z licytowaniem. 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 mediacji 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

Otwórz 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 mediacyjnej 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.

Powinna wyświetlić się karta jednostek reklamowych z wybranymi jednostkami:

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 ustalania 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.

Ważne: identyfikator wydawcy OpenWrap i identyfikator profilu OpenWrap muszą być powiązane z aplikacją docelową, tak jak w interfejsie pakietu PubMatic OpenWrap SDK.

Dodawanie PubMatic do listy partnerów reklamowych wymaganych przez RODO i przepisy stanowe w USA

Ważne: aby skonfigurować zgodę użytkowników z UE i RODO, przepisy stanowe w Stanach Zjednoczonych oraz platformę do obsługi wiadomości od użytkowników, musisz mieć uprawnienia do zarządzania kontem. Szczegółowe informacje znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Aby dodać PubMatic do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i przepisy stanowe w USA w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter PubMatic

Uwaga: brak integracji zgodnych wersji pakietów SDK do reklam mobilnych Google i PubMatic może powodować problemy z kompilacją.

CocoaPods (zalecane)

• Dodaj do pliku Podfile projektu ten wiersz:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• W wierszu poleceń uruchom:

  pod install --repo-update

Integracja ręczna

1. Pobierz najnowszą wersję pakietu PubMatic OpenWrap SDK na iOS i połącz wszystkie pliki i pakiety .xcframework w projekcie.

2. 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

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji.

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ą udzielenia dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Przekazywanie sygnałów o zgodności z RODO i zgody wymaganej przez RODO.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli prawo wycofać zgodę 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” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA o ochronie 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 mediacji. 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 zgody użytkownika na potrzeby GPP.

Krok 5. Dodaj wymagany kod

Integracja 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.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w przypadku pakietu SDK AdMob i PubMatic OpenWrap.

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 polaGADNativeAd:

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.8.1.1 (w toku)

• Obsługuje format reklamy pełnoekranowej w zapośredniczeniu kaskadowym.
• Obsługuje format reklamy z nagrodą w kaskadzie.
• Obsługuje format reklamy banerowej w kaskadzie.
• Obsługuje kaskadowy format reklam natywnych.
• Naprawia błąd polegający na tym, że delegat reklamy natywnej nie był prawidłowo ustawiony.
• Zawiera plik Info.plist w ramach.

Wersja 4.8.1.0

• Zweryfikowana zgodność z pakietem PubMatic OpenWrap SDK w wersji 4.8.1.

Zbudowano i przetestowano przy użyciu:

• Pakiet SDK do reklam mobilnych Google w wersji 12.9.0.
• PubMatic OpenWrap SDK w wersji 4.8.1.

Wersja 4.8.0.0

• Zweryfikowana zgodność z pakietem PubMatic OpenWrap SDK w wersji 4.8.0.

Zbudowano i przetestowano przy użyciu:

• Pakiet SDK do reklam mobilnych Google w wersji 12.8.0.
• PubMatic OpenWrap SDK w wersji 4.8.0.

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.

Zbudowano i przetestowano przy użyciu:

• SDK do reklam mobilnych Google w wersji 12.6.0.
• PubMatic OpenWrap SDK w wersji 4.7.0.