Z tego przewodnika dowiesz się, jak uruchamiać i używać różnych funkcji inspektora reklam.
Wymagania wstępne
Aby używać inspektora reklam:
- Zapoznaj się z przewodnikiem dla początkujących.
- Używaj pakietu SDK do reklam mobilnych Google w wersji 9.1.0 lub nowszej.
- Dodaj swoje urządzenie jako urządzenie testowe. Inspektor reklam uruchamia się tylko na urządzeniach testowych.
Uruchamianie inspektora reklam
Inspektora reklam można uruchomić z dowolnego miejsca w aplikacji na te sposoby:
- Użyj gestu wybranego w interfejsie AdMob podczas rejestrowania urządzenia testowego.
- Programowo za pomocą udostępnionego interfejsu API.
- Użyj przycisku uruchamiania w menu debugowania.
Uruchamianie za pomocą gestów
Aby uruchomić inspektora reklam za pomocą gestu, nie musisz wprowadzać żadnych zmian w aplikacji. Wystarczy wykonać gest (podwójne przesunięcie lub potrząśnięcie), który został skonfigurowany w AdMob na potrzeby tego urządzenia testowego. Więcej informacji
Po ustawieniu gestu w interfejsie AdMob (i odczekaniu 15 minut na jego propagację) aplikacja musi wysłać żądanie reklamy, aby pakiet SDK do reklam mobilnych Google mógł poznać ustawienie gestu. Jeśli określony gest nie działa, spróbuj wczytać reklamę, ponownie uruchomić aplikację i ponownie przetestować gest.
Uruchamianie programowe
Inspektora reklam można też uruchomić programowo:
Ten interfejs API działa w przypadku urządzeń testowych zarejestrowanych programowo lub w interfejsie AdMob.
Wyświetlanie jednostek reklamowych i rozwiązywanie związanych z nimi problemów
Po uruchomieniu inspektora reklam pojawi się jego główny ekran z listą wszystkich jednostek reklamowych w interfejsie AdMob powiązanych z identyfikatorem aplikacji AdMob, które mają konfiguracje określania stawek lub zapośredniczenia:
Przed skorzystaniem z inspektora reklam zalecamy zainicjowanie pakietu SDK do reklam mobilnych Google.
Wyświetlanie szczegółów kaskady zapośredniczenia w przypadku jednostki reklamowej
Kliknij jednostkę reklamową, aby wyświetlić jej dziennik żądań pakietu SDK. Zawiera on szczegółowe informacje o kaskadzie zapośredniczenia do czasu wypełnienia reklamy (lub zakończenia kaskady bez wypełnienia) w przypadku najnowszych żądań reklamy.
Każde żądanie można rozwinąć za pomocą wskaźnika ujawnienia, aby wyświetlić wyniki kaskady zapośredniczenia dla tego żądania, a także wszelkie błędy i opóźnienia, które miały zastosowanie do tego żądania.
W przypadku zewnętrznych źródeł reklam komunikaty o błędach są wysyłane bezpośrednio ze źródła reklam. Jeśli potrzebujesz więcej informacji, skontaktuj się z zewnętrznym źródłem reklam.
Wyświetlanie szczegółów określania stawek w przypadku jednostki reklamowej
Jeśli dopiero zaczynasz korzystać z określania stawek, przeczytaj ten artykuł.
W dzienniku żądań pakietu SDK możesz zobaczyć źródła reklam z ustalaniem stawek, które są wywoływane w żądaniu reklamy. Kliknij jednostkę reklamową w dzienniku żądań pakietu SDK, aby wyświetlić szczegóły każdego źródła reklam w aukcji z określaniem stawek.
Wyniki określania stawek są wyświetlane w takiej kolejności, aby elementy wymagające działania były bliżej początku listy:
Na początku znajduje się sieć reklamowa, która wygrała aukcję.
Następnie są sieci reklamowe, w których występują problemy. Możesz wykonać czynności wymagane do rozwiązania problemu .
Potem są sieci reklamowe, które nie zwróciły reklam lub nie ustalały stawek. Może to wskazywać na różne problemy ze źródłem reklam, ponieważ mogło ono nie ustalić stawki z powodu konfiguracji lub decyzji. Aby uzyskać pomoc, możesz zapoznać się z przewodnikiem konfiguracji źródła reklam lub skontaktować się bezpośrednio ze źródłem reklam w celu uzyskania pomocy.
Na końcu listy znajdują się sieci reklamowe, które przegrały aukcję z określaniem stawek.
Kaskada zapośredniczenia może umieścić źródło reklam, które wygrało aukcję z określaniem stawek, zgodnie z jego wartością eCPM.
Gdy źródło reklam jest wywoływane w kaskadzie zapośredniczenia, może wyświetlać reklamy. Więcej informacji o tym, jak działa określanie stawek w kaskadzie zapośredniczenia, znajdziesz w przykładzie 2 i przykładzie 3 w artykule Źródła reklam z ustalaniem stawek i kaskadowe źródła reklam w jednej grupie zapośredniczenia.
Zaawansowane debugowanie jednostek reklamowych
Podczas rozwiązywania problemów z jednostkami reklamowymi może być przydatne przeanalizowanie żądania reklamy i odpowiedzi, aby zidentyfikować, gdzie występuje problem, lub udostępnić te informacje zespołowi pomocy Google, aby pomóc w debugowaniu. Aby wyeksportować pełne żądanie i odpowiedź reklamy, kliknij ikonę menu u góry łańcucha kaskady i wybierz Udostępnij żądanie reklamy i odpowiedź. Dzięki temu nie musisz samodzielnie uruchamiać śledzenia sieci w swojej aplikacji.
Dodatkowo możesz wyświetlić zdekodowane parametry określania stawek przez źródło zewnętrzne, klikając opcję Parametr zewnętrznego źródła reklam z ustalaniem stawek w tym samym menu co ciąg znaków żądania. Dzięki temu możesz sprawdzić, które parametry określania stawek przez źródło zewnętrzne mogą powodować problemy, co ułatwia debugowanie aplikacji lub sprawdzenie, czy sieć prawidłowo zbiera sygnały.
Wyświetlanie dostępnych adapterów
Kliknij kartę Adaptery , aby wyświetlić listę wszystkich adapterów zewnętrznych źródeł reklam powiązanych ze źródłami reklam w konfiguracjach określania stawek lub zapośredniczenia w aplikacji. Następnie rozwiń karty, aby wyświetlić ich stany inicjowania i wersje pakietu SDK. Oprócz obsługiwanych adapterów zewnętrznych źródeł reklam możesz też wyświetlić adaptery zdarzeń niestandardowych.
Zdarzenia niestandardowe umożliwiają wydawcom korzystanie z sieci reklamowych, które nie są obsługiwane przez AdMob. Zdarzenia niestandardowe można odróżnić od standardowych adapterów zewnętrznych źródeł reklam na liście adapterów dzięki ich unikalnym nazwom klas. Oprócz nazwy klasy i informacji o stanie inspektor reklam wyświetla też etykiety przypisane do tych zdarzeń niestandardowych w interfejsie internetowym AdMob.
Jeśli adapter nie zostanie znaleziony lub nie uda się go zainicjować, więcej informacji znajdziesz w artykule Rozwiązywanie problemów wykrytych za pomocą inspektora reklam.
Testowanie jednostek reklamowych
Jeśli chcesz przetestować jednostkę reklamową bez konieczności przechodzenia do niej w interfejsie aplikacji, inspektor reklam obsługuje to bezpośrednio na ekranie szczegółów jednostki reklamowej. Dodatkowo możesz testować kilka jednostek reklamowych jednocześnie, asynchronicznie wczytywać i wyświetlać testowe żądania reklamy, a nawet przeprowadzać testy pojedynczego źródła reklam.
Testowanie reklam
Testy reklam w inspektorze reklam opisane w tej sekcji to doskonałe narzędzie do weryfikowania podstawowej jakości reklam i sprawdzania konfiguracji zapośredniczenia w przypadku testowania pojedynczego źródła reklam.
Gdy wszystko będzie gotowe do przetestowania jednostki reklamowej, kliknij przycisk Poproś o reklamę testową u góry ekranu inspektora reklam, aby uruchomić test reklamy w inspektorze reklam. Wyniki testu pojawią się w dzienniku żądań pakietu SDK pod nagłówkiem Żądanie z inspektora reklam.
Testowanie pojedynczych źródeł reklam
Inspektor reklam ma funkcję ograniczania żądań reklam w aplikacji do wyświetlania reklam tylko z jednego źródła reklam z ustalaniem stawek lub kaskadowego źródła reklam. Pozwoli to sprawdzić, czy zewnętrzny adapter został poprawnie wdrożony i czy źródło reklam działa prawidłowo.
Aby włączyć tę funkcję, kliknij przełącznik Test pojedynczego źródła reklam u dołu ekranu. Wyświetli się to okno wyboru źródła reklam:
Aby testować pojedyncze źródła reklam, musisz zainicjować pakiet SDK do reklam mobilnych Google.
Następnie możesz wybrać jedno źródło reklam do przetestowania. Po wybraniu źródła reklam pojawi się ten ekran:
Ustawienie testu pojedynczego źródła reklam dotyczy wszystkich przyszłych żądań reklam wysyłanych w tej samej sesji. Nie dotyczy jednak żadnych wcześniej buforowanych reklam w tej sesji, które nie zostały jeszcze wyświetlone. Podczas stosowania testu pojedynczego źródła reklam zalecamy wymuszenie ponownego uruchomienia aplikacji, aby unieważnić wszystkie buforowane reklamy, które mogłyby zostać wyświetlone zamiast reklamy z wybranego źródła.
Po ponownym uruchomieniu aplikacji wszystkie miejsca docelowe jednostek reklamowych będą próbowały wyświetlić reklamę tylko z wybranej sieci. Uruchomienie inspektora reklam, gdy aktywny jest test pojedynczego źródła reklam, spowoduje wyświetlenie aktywnego źródła reklam testowych:
W trybie testowania pojedynczego źródła reklam wszystkie żądania reklam będą próbowały wykorzystać wybrane źródło reklam, niezależnie od tego, czy jest ono skonfigurowane do określania stawek, czy do zapośredniczenia w przypadku żądanej jednostki reklamowej. Jeśli testowane źródło reklam nie znajduje się w kaskadzie zapośredniczenia dla danej jednostki reklamowej, pojawi się komunikat o błędzie „Niewypełniona”.
Jeśli testujesz pojedyncze źródło reklam, możesz kliknąć jednostkę reklamową, by wyświetlić jej dziennik żądań pakietu SDK. Dzięki temu możesz sprawdzić, czy źródło reklam wypełniło żądania reklamy przesłane po włączeniu testowania pojedynczego źródła reklam. Jeśli źródło reklam nie wczytało reklamy, pojawi się komunikat o błędzie.
Jeśli w kaskadzie zapośredniczenia masz dodane wiele wystąpień wybranego źródła reklam, każde wystąpienie wywołania z tego źródła będzie widoczne w kaskadzie aż do wyświetlenia reklamy lub do zakończenia kaskady bez wyświetlenia.
Zatrzymywanie testu pojedynczego źródła reklam
Aby zatrzymać test, wyłącz przełącznik:
Pojawi się komunikat z prośbą o potwierdzenie:
Po zatrzymaniu testu zalecamy wymuszenie ponownego uruchomienia aplikacji, aby unieważnić wszystkie buforowane reklamy z testowanego źródła reklam.
Debugowanie ustawień prywatności
Wymagania wstępne: pakiet SDK do reklam mobilnych Google w wersji 9.6.0 lub nowszej
Za pomocą inspektora reklam możesz wyświetlić te sygnały prywatności przekazywane w żądaniu reklamy w ramach integracji wydawcy z opracowanymi przez IAB Europe zasadami TCF:
- Obowiązuje RODO (
IABTCF_gdprApplies) - Ciąg tekstowy dotyczący udzielenia dodatkowej zgody (
IABTCF_AddtlConsent) - Ciąg tekstowy dotyczący przejrzystości i zgody na przetwarzanie danych (
IABTCF_TCString)
Po wczytaniu reklamy lub przeprowadzeniu testu reklamy w inspektorze reklam kliknij ikonę menu w żądaniu w sekcji Dziennik żądań pakietu SDK. Następnie wybierz opcję Sygnały prywatności.
Na ekranie Sygnały prywatności wyświetlają się sygnały prywatności przekazywane w żądaniu reklamy.
Więcej informacji o ciągu tekstowym dotyczącym udzielenia dodatkowej zgody znajdziesz w specyfikacji technicznej Google o nazwie „Udzielenie dodatkowej zgody”. Aby wyświetlić szczegółowe informacje o zgodzie w ciągu tekstowym dotyczącym przejrzystości i zgody na przetwarzanie danych, takie jak identyfikator CMP i lista identyfikatorów dostawców, na których przetwarzanie danych użytkownik wyraził zgodę, powiązanych z IAB, kliknij Dekoduj , aby otworzyć koder / dekoder GPP IAB.
Jeśli wystąpią jakiekolwiek błędy, wykonaj czynności opisane w artykule Rozwiązywanie problemów z prywatnością.
Kopiowanie wszystkich danych wyjściowych debugowania
Inspektor reklam umożliwia kopiowanie ciągu JSON zawierającego wszystkie dane wyjściowe debugowania z narzędzia, w tym szczegóły aplikacji w AdMob, stany inicjowania adaptera i wyniki testowania wszystkich jednostek reklamowych.
Aby to zrobić, kliknij ikonę aplikacji 7 razy, aż zobaczysz komunikat Kod JSON inspektora reklam został skopiowany do schowka.