Integracja PubMatic z zapośredniczeniem AdMob

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK for React Native do wczytywania i wyświetlania reklam z PubMatic za pomocą Zapośredniczenia AdMob, w tym integracji z określaniem stawek. Dowiesz się, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter PubMatic z aplikacją natywną React Native.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do PubMatic ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa  1
Z nagrodą  1
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik  1

1 Ten format jest w wersji beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Krok 1. Skonfiguruj ustawienia w interfejsie PubMatic OpenWrap SDK

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

Dodawanie nowej aplikacji

Przejdź do karty Aplikacje i kliknij przycisk Dodaj aplikację.

Panel aplikacji

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

Android

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

Formularz nowej aplikacji

iOS

W sekcji Ścieżka integracji wybierz React Native, a jako Ścieżkę podintegracji 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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, skonfiguruj go pod kątem swojej aplikacji.

Przed sfinalizowaniem aplikacji zobaczysz odpowiednie wpisy, które należy dodać do pliku app-ads.txt.

app-aps.txt

Więcej informacji o implementowaniu pliku app-ads.txt w przypadku PubMatic znajdziesz w artykule Jak wdrożyć plik app-ads.txt (w języku angielskim).

Identyfikator profilu

Po utworzeniu aplikacji 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ą.

Utwórz jednostkę reklamową

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 Statystyk. Najedź kursorem na ikonę profilu i zapisz swój identyfikator.

Identyfikator wydawcy

Krok 2. Skonfiguruj oferty reklamowe PubMatic OpenWrap SDK w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dla iOS.

Dodawanie PubMatic do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA, aby dodać PubMatic do listy partnerów reklamowych w interfejsie AdMob, którzy przestrzegają rozporządzeń europejskich i przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK PubMatic OpenWrap SDK i odpowiedni adapter

W katalogu głównym projektu zainstaluj Google Mobile Ads SDK for React Native adapter zapośredniczenia PubMatic OpenWrap SDK. Wykonaj te czynności:

  1. Skopiuj plik tar adaptera Google Mobile Ads SDK for React Native z katalogu gma-sdk-react-native/adapters/pubmatic/ do katalogu local_packages/ projektu. Jeśli nie masz folderu adapters, zapoznaj się z sekcją Wymagania wstępne.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/pubmatic/gma-mediation-pubmatic-0.1.0.tgz local_packages/

    Zastąp EXTRACT_DIR ścieżką do katalogu, w którym zostało wyodrębnione archiwum.

  2. Zainstaluj pakiet adaptera za pomocą preferowanego systemu zarządzania pakietami:

    npm

    npm install ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

    włóczka

    yarn add ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

  3. Jeśli tworzysz aplikację na Androida, dodaj to repozytorium do pliku build.gradle w katalogu android projektu:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
}

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

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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 zapośredniczenia.

Adapter PubMatic OpenWrap SDK React Native w wersji 0.1.0 i nowszych obsługuje przekazywanie sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF), do pakietu PubMatic OpenWrap SDK. Więcej informacji znajdziesz w artykule Przekazywanie informacji o RODO i zgodzie 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 rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „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 ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

PubMatic automatycznie odczytuje zgodę CCPA 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 Ustawianie ciągu tekstowego CCPA.

Krok 5. Dodaj wymagany kod

Android

Integracja z PubMatic nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

Sprawdzanie reklam testowych

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

Kody błędów

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

Android

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

iOS

GADMediationAdapterPubMatic

Oto kody i powiązane z nimi komunikaty, które adapter PubMatic wyświetla, 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 Format reklamy nie jest obsługiwany przez PubMatic lub brakuje go w danych sygnału RTB.
103 com.google.ads.mediation.pubmatic Nie udało się wyświetlić reklamy, ponieważ nie była gotowa.
104 com.google.ads.mediation.pubmatic Brak identyfikatora profilu lub jest on nieprawidłowy.
105 com.google.ads.mediation.pubmatic Brak identyfikatora jednostki reklamowej lub jest on pusty.
106 com.google.ads.mediation.pubmatic Zwrócona reklama z nagrodą ma wartość null.
107 com.google.ads.mediation.pubmatic Nieprawidłowy rozmiar banera reklamowego.
1001-5002 Wysłane przez PubMatic SDK PubMatic SDK 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 zebrania sygnałów do określania stawek nie powiodło się, ponieważ w parametrach żądania określono wiele formatów, nie określono żadnego formatu lub określono nieobsługiwany format.
103 com.google.ads.mediation.pubmatic Nieprawidłowa konfiguracja reklamy do wczytania.
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ł obrazu reklamy natywnej.
107 com.google.ads.mediation.pubmatic W konfiguracji reklamy brakuje identyfikatora wydawcy.
108 com.google.ads.mediation.pubmatic W konfiguracji reklamy brakuje identyfikatora profilu.
109 com.google.ads.mediation.pubmatic Konfiguracja reklamy zawiera identyfikator profilu, który nie jest liczbą.
110 com.google.ads.mediation.pubmatic W konfiguracji reklamy brakuje identyfikatora jednostki reklamowej.
111 com.google.ads.mediation.pubmatic Pakietowi PubMatic OpenWrap SDK nie udało się utworzyć instancji rozmiaru reklamy.
1001-5002 Wysłane przez PubMatic SDK PubMatic SDK zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic.

Wersja 0.1.0

  • Pierwsza wersja.