Integrowanie PubMatic OpenWrap (beta) z zapośredniczeniem

Wybierz platformę: Android (beta) Nowość Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Unity Plugin do wczytywania i wyświetlania reklam z PubMatic za pomocą zapośredniczenia AdMob, w tym integracji z określeniem stawek. Wyjaśniamy w nim, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter PubMatic z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla PubMatic ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa  1
Z nagrodą  1
Reklama pełnoekranowa z nagrodą

1 Ten format jest w wersji beta. Zamów dostęp do niego u menedżera konta.

Wymagania

  • Najnowsze Google Mobile Ads Unity Plugin
  • Unity 2019.4 lub nowsze
  • Aby wdrożyć aplikację na Androidzie:
    • Android API w wersji 23 lub nowszej
  • Aby wdrożyć aplikację na iOS:
    • iOS w wersji 13.0 lub nowszej
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Skonfiguruj zapośredniczenie AdMob

Krok 1. Skonfiguruj ustawienia w interfejsie PubMatic

Zarejestruj się lub zaloguj się na swoje konto PubMatic i kliknij kartę OpenWrap SDK.

Dodawanie nowej aplikacji

Otwórz kartę Aplikacje i kliknij przycisk Dodaj aplikację.

Panel aplikacji

Wybierz Platformę, a także Adres URL w sklepie z aplikacjami i Nazwę aplikacji dla swojej aplikacji.

Android

W sekcji Ścieżka integracji wybierz Unity, a jako Ścieżkę integracji podrzędnej wybierz AdMob – określanie stawek przez pakiet SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

iOS

W sekcji Ścieżka integracji wybierz Unity, a jako Ścieżkę integracji podrzędnej wybierz AdMob – określanie stawek przez pakiet SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli 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, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, skonfiguruj plik app-ads.txt dla swojej aplikacji.

Zanim aplikacja zostanie ukończona, zobaczysz odpowiednie wpisy, które należy dodać do pliku app-ads.txt.

app-aps.txt

Więcej informacji o tym, jak wdrożyć app-ads.txt w przypadku PubMatic, znajdziesz w artykule Jak wdrożyć plik app-ads.txt.

Identyfikator profilu

Gdy utworzysz aplikację, otwórz kartę Aplikacje i zapisz Identyfikator profilu nowo utworzonej aplikacji.

Identyfikator profilu aplikacji

Utwórz jednostkę reklamową

Na karcie Jednostki reklamowe wybierz aplikację utworzoną w poprzedniej sekcji i kliknij przycisk Utwórz jednostkę reklamową.

Tworzenie jednostki reklamowej

Wypełnij formularz szczegółami jednostki reklamowej i kliknij Zapisz.

Formularz tworzenia jednostki reklamowej

Zapisz nowo utworzony Identyfikator jednostki reklamowej OpenWrap.

Identyfikator jednostki reklamowej w aplikacji

Uzyskaj identyfikator wydawcy

Otwórz panel informacyjny Analytics. Najedź kursorem na ikonę profilu i zapisz swój identyfikator.

Identyfikator wydawcy

Krok 2. Skonfiguruj popyt PubMatic w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodaj PubMatic do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Aby dodać PubMatic do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter PubMatic

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI , możesz zainstalować wtyczkę zapośredniczenia Google Mobile Ads PubMatic OpenWrap SDK dla środowiska Unity w swoim projekcie, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.pubmatic

OpenUPM

W edytorze projektu Unity otwórz ustawienia Menedżera pakietów Unity, klikając kolejno Edytuj > Ustawienia projektu > Menedżer pakietów.

Na karcie Rejestry o określonym zakresie dodaj OpenUPM jako rejestr o określonym zakresie, podając te informacje:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakresy: com.google

Szczegóły OpenUPM

Następnie otwórz Menedżera pakietów Unity, klikając kolejno Okno > Menedżer pakietów, i w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads PubMatic Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla pakietu SDK PubMatic OpenWrap, korzystając z linku do pobrania w dzienniku zmian , i wyodrębnij GoogleMobileAdsPubMaticMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity kliknij kolejno Zasoby > Importuj pakiet > Własny pakiet i znajdź pobrany plik GoogleMobileAdsPubMaticMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie kliknij kolejno Zasoby > Menedżer zależności zewnętrznych > Rozwiązywanie problemów z Androidem > Wymuś rozwiązanie. Biblioteka Menedżera zależności zewnętrznych od nowa rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK PubMatic

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

PubMatic automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification, including the UMP SDK. Więcej informacji znajdziesz w artykule Przekazywanie zgody na wykorzystanie danych zgodnie z RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (zgodnie z definicjami tych terminów w przepisach). 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 „sprzedającego”. Przewodnik po zgodności z amerykańskimi przepisami stanowymi 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 łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z instrukcjami każdej z tych sieci, aby zapewnić zgodność.

PubMatic automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z CCPA ustawioną przez platformy zarządzania zgodą, które obsługują specyfikację dodatkowej zgody Google, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Ustawianie ciągu CCPA.

Krok 5. Dodaj wymagany kod

Android

W przypadku integracji z PubMatic nie jest wymagany żaden dodatkowy kod.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją PubMatic's.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w AdMob.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK PubMatic OpenWrap, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła lub źródeł reklam PubMatic OpenWrap.

Kody błędów

Jeśli adapter nie otrzyma reklamy z PubMatic, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

Oto kody i towarzyszące im komunikaty zwracane przez adapter PubMatic, gdy nie uda się wczytać reklamy:

Android

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.pubmatic W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy.
102 com.google.ads.mediation.pubmatic Nieprawidłowa konfiguracja reklamy na potrzeby wczytywania reklamy.
103 com.google.ads.mediation.pubmatic Nie udało się wyświetlić reklamy, ponieważ nie była gotowa.
1001-5002 Wysłany przez pakiet SDK PubMatic Pakiet SDK PubMatic zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic.

iOS

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.pubmatic W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy.
102 com.google.ads.mediation.pubmatic Nie udało się zebrać sygnałów określania stawek, ponieważ w parametrach żądania określono wiele formatów, brak formatu lub format nieobsługiwany.
103 com.google.ads.mediation.pubmatic Nieprawidłowa konfiguracja reklamy na potrzeby wczytywania 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 gotowa.
106 com.google.ads.mediation.pubmatic Nie udało się wczytać jednego ze źródeł obrazów reklamy natywnej.
1001-5002 Wysłany przez pakiet SDK PubMatic Pakiet SDK PubMatic zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic.

Dziennik zmian wtyczki zapośredniczenia PubMatic dla środowiska Unity

Następna wersja

  • Zaktualizowano wtyczkę, aby zawierała dynamiczną platformę OpenWrapSDK dla wszystkich celów iOS.

Wersja 2.0.0

Wersja 1.5.0

Wersja 1.4.1

Wersja 1.4.0

Wersja 1.3.1

Wersja 1.3.0

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0