Z tego przewodnika dowiesz się, jak uruchamiać i używać różnych funkcji w inspektorze reklam.
Wymagania wstępne
Aby użyć 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 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:
- Podczas rejestrowania urządzenia testowego używaj gestu wybranego w interfejsie AdMob.
- automatycznie 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 szybkie poruszenie lub potrząśnięcie) skonfigurowany w AdMob dla tego urządzenia testowego. Więcej informacji
Po ustawieniu gestu w interfejsie AdMob (i odczekaniu 15 minut, aż zmiana zostanie zastosowana) aplikacja musi wysłać żądanie reklamy, aby pakiet SDK do reklam mobilnych Google mógł się dowiedzieć o ustawieniu gestu. Jeśli określony gest nie działa, spróbuj wczytać reklamę, ponownie uruchomić aplikację i ponownie przetestować gest.
Uruchamianie automatyczne
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 problemów z nimi
Po uruchomieniu pojawi się główny ekran inspektora reklam, który zawiera 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óły kaskady zapośredniczenia do momentu wypełnienia reklamy (lub do momentu zakończenia kaskady bez wypełnienia) na podstawie ostatnich żądań reklamy.
Każde żądanie można rozwinąć za pomocą wskaźnika ujawniania, aby wyświetlić wyniki kaskadowego zapośredniczenia dla tego żądania, a także wszelkie błędy i opóźnienia, które miały zastosowanie w jego przypadku.
W przypadku zewnętrznych źródeł reklam komunikaty o błędach są wysyłane bezpośrednio ze źródła reklam. Więcej informacji uzyskasz od zewnętrznego źródła reklam.
Wyświetlanie szczegółów określania stawek w przypadku jednostki reklamowej
Jeśli dopiero zaczynasz korzystać z ustalania stawek, przeczytaj omówienie.
W dzienniku żądań pakietu SDK możesz zobaczyć źródła reklam z ustalaniem stawek, które są wywoływane w żądaniu reklamy. W dzienniku żądań pakietu SDK kliknij jednostkę reklamową, aby wyświetlić szczegóły każdego źródła reklam w aukcji z ustalaniem stawek.
Wyniki określania stawek są sortowane w taki sposób, aby elementy wymagające podjęcia działań były bliżej góry listy:
U góry znajduje się sieć reklamowa, która wygrała aukcję.
Następnie wyświetlają się sieci reklamowe, w których występują problemy. Możesz wykonać czynności, które pomogą rozwiązać problemy.
Następnie 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 ze względu na konfigurację lub proces decyzyjny. Możesz zapoznać się z przewodnikiem konfiguracji źródła reklam lub skontaktować się bezpośrednio ze źródłem reklam, aby uzyskać pomoc.
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 zostanie wywołane w kaskadzie zapośredniczenia, może wyświetlać reklamy. Więcej informacji o tym, jak działa określanie stawek w przypadku kaskady zapośredniczenia, znajdziesz w przykładzie 2 i przykładzie 3 źródeł reklam z ustalaniem stawek i kaskadowych źródeł reklam w jednej grupie zapośredniczenia.
Zaawansowane debugowanie jednostek reklamowych
Podczas rozwiązywania problemów z jednostkami reklamowymi warto przeanalizować żądanie reklamy i odpowiedź, aby zidentyfikować miejsce, w którym występuje błąd. Możesz też udostępnić te informacje zespołowi pomocy Google, aby ułatwić debugowanie. Kliknij ikonę menu u góry sekwencji i wybierz Udostępnij żądanie reklamy i odpowiedź, aby wyeksportować pełne żądanie reklamy i odpowiedź. Dzięki temu nie musisz uruchamiać śledzenia sieci w swojej aplikacji.
Możesz też 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 żądania. Zawiera on szczegółowe informacje o tym, które parametry określania stawek przez firmy zewnętrzne mogą powodować problemy. Pomaga to w debugowaniu aplikacji lub weryfikowaniu, 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 ustalania stawek lub zapośredniczenia w Twojej aplikacji. Następnie rozwiń karty, aby wyświetlić stany inicjowania i wersje pakietów SDK. Oprócz obsługiwanych adapterów zewnętrznych źródeł reklam możesz też wyświetlać adaptery zdarzeń niestandardowych.
Zdarzenia niestandardowe umożliwiają wydawcom korzystanie z sieci reklamowych, które nie są obsługiwane przez AdMob. Zdarzenia niestandardowe odróżniają się od standardowych adapterów zewnętrznych na liście adapterów dzięki 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, możesz to zrobić bezpośrednio na ekranie szczegółów jednostki reklamowej w inspektorze reklam. Możesz też testować wiele jednostek reklamowych jednocześnie, asynchronicznie wczytywać i wyświetlać żądania reklam testowych, 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 połączeniu z testowaniem pojedynczego źródła reklam.
Gdy zechcesz przetestować jednostkę reklamową, kliknij przycisk Wyślij żądanie reklamy testowej 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 pojedynczego źródła reklam
Inspektor reklam ma funkcję ograniczania żądań reklam w aplikacji, aby wyświetlać tylko reklamy z pojedynczego źródła reklam ustalającego stawki lub kaskadowego źródła reklam zapośredniczenia. 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ę okno wyboru źródła reklamy:
Aby móc testować pojedyncze źródła reklam, musisz zainicjować pakiet SDK do reklam mobilnych Google.
Następnie możesz wybrać pojedyncze źródło reklam do przetestowania. Po wybraniu źródła reklam pojawi się ten ekran:
Ustawienie testu pojedynczego źródła reklam będzie stosowane do wszystkich przyszłych żądań reklam w ramach tej samej sesji. Nie dotyczy to jednak żadnych reklam zapisanych wcześniej w pamięci podręcznej w tej sesji, które nie zostały jeszcze wyświetlone. Wymuszenie ponownego uruchomienia aplikacji jest zalecane podczas przeprowadzania testu pojedynczego źródła reklam, aby unieważnić wszelkie reklamy w pamięci podręcznej, które mogłyby być wyświetlane zamiast wybranego źródła reklam otrzymującego żądanie.
Po ponownym uruchomieniu aplikacji wszystkie miejsca docelowe jednostek reklamowych będą próbować wyświetlać reklamy 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 zostało ono skonfigurowane do określania stawek czy 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ą, aby 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 zdołało wczytać reklamy, pojawi się komunikat o błędzie z opisem problemu.
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:
Następnie na ekranie ponownego uruchamiania pojawi się komunikat z prośbą o potwierdzenie:
Po zakończeniu testu zalecamy wymuszenie ponownego uruchomienia aplikacji, aby unieważnić wszystkie reklamy w pamięci podręcznej dla testowanego źródła reklam.
Debugowanie ustawień prywatności
Wymagania wstępne: SDK do reklam mobilnych Google w wersji 9.6.0 lub nowszej
W inspektorze reklam możesz wyświetlić te sygnały dotyczące 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 (
IABTCF_TCString)
Po wczytaniu reklamy lub przeprowadzeniu testowania reklam w inspektorze reklam kliknij ikonę menu w żądaniu w sekcji Dziennik żądań pakietu SDK. Następnie wybierz opcję Sygnały dotyczące prywatności.
Na ekranie Sygnały dotyczące prywatności wyświetlają się sygnały dotyczące 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 platformy CMP i lista identyfikatorów dostawców, którzy uzyskali zgodę użytkownika i są powiązani z IAB, kliknij Decode (Dekoduj), aby otworzyć enkoder / dekoder GPP IAB.
Jeśli napotkasz jakieś 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 testów wszystkich jednostek reklamowych.
Aby to zrobić, kliknij ikonę aplikacji 7 razy, aż zobaczysz komunikat Kod JSON inspektora reklam został skopiowany do schowka.