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, a także jak przeprowadzać integracje oparte na licytowaniu. Wyjaśniamy w nim, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter PubMatic z aplikacją w Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla PubMatic ma te funkcje:

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

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity w wersji 2019.4 lub nowszej
  • Wdrażanie na Androidzie
    • Android API na poziomie 23 lub wyższym
  • Wdrażanie na iOS
    • iOS w wersji 12.0 lub nowszej
  • Działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • 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ę.

Panel aplikacji

Wybierz platformę, a także adres URL sklepu z aplikacjami i nazwę aplikacji.

Android

W sekcji Ścieżka integracji wybierz Unity, a jako Ścieżkę integracji podrzędnej wybierz AdMob – określanie stawek za pomocą pakietu 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 za pomocą pakietu SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

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.

app-aps.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.

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, wpisując szczegóły jednostki reklamowej, i kliknij Zapisz.

Formularz tworzenia jednostki reklamowej

Zapisz nowo utworzony identyfikator jednostki reklamowej OpenWrap.

Identyfikator jednostki reklamowej w aplikacji

Uzyskiwanie identyfikatora wydawcy

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

Identyfikator wydawcy

Krok 2. Skonfiguruj popyt PubMatic w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

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

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

OpenUPM-CLI

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

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

OpenUPM

W edytorze projektu Unity wybierz Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Ustawienia menedżera pakietów Unity.

Na karcie Scoped Registries (Rejestry o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

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

Szczegóły OpenUPM

Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Menedżera pakietów Unity, i w menu kliknij My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads PubMatic Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki do mediacji w reklamach mobilnych Google dla pakietu SDK PubMatic OpenWrap, korzystając z linku do pobierania w dzienniku zmian, a następnie wyodrębnij plik GoogleMobileAdsPubMaticMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet) i znajdź pobrany plik GoogleMobileAdsPubMaticMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie zależności w Androidzie) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager 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 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. Google nie może automatycznie przekazywać do takich sieci wyboru 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 o nazwie „Udzielenie dodatkowej zgody”, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Przekazywanie sygnałów o zgodzie użytkowników z UE na wykorzystanie danych zgodnie z 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ły zgody użytkowników w ramach CCPA ustawione przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielania dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Ustawianie ciągu znaków CCPA.

Krok 5. Dodaj wymagany kod

Android

Integracja z PubMatic nie wymaga dodatkowego kodu.

iOS

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.

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z PubMatic, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo w tych klasach:

Android

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

iOS

GADMediationAdapterPubMatic

Oto kody i komunikaty wyświetlane 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 do wczytania reklamy.
103 com.google.ads.mediation.pubmatic Nie udało się wyświetlić reklamy, ponieważ nie była gotowa.
1001-5002 Wysłane 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 Żą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.

Historia zmian wtyczki PubMatic Unity Mediation

Wersja 1.1.0

Wersja 1.0.0