Używanie inspektora reklam w pakiecie SDK do reklam mobilnych w wersjach starszych niż 8.5.0możesz:
- Sprawdzanie jednostek reklamowych
- Sprawdzanie adapterów zewnętrznych źródeł reklam
- sprawdzać, czy jednostki reklamowe są wypełniane zgodnie z oczekiwaniami;
- Identyfikowanie błędów i wyświetlanie szczegółowych informacji o sposobach ich rozwiązywania
- wyświetlać szczegóły zapośredniczenia dla każdej sieci reklamowej na żądanie;
- Testowanie poszczególnych zewnętrznych zapośredniczonych źródeł reklam
- Sprawdzanie, czy każda jednostka reklamowa jest prawidłowo skonfigurowana pod kątem zapośredniczenia kaskadowego
- Testowanie integracji zdarzeń niestandardowych
W wersji pakietu SDK do reklam mobilnych 8.5.0 lub nowszej możesz też:
- wyświetlać szczegóły określania stawek dla każdej sieci reklamowej na żądanie;
- wyświetlać szczegóły dotyczące określania stawek i zapośredniczenia kaskadowego dla każdej reklamy; sieć na żądanie
- Testowanie poszczególnych zewnętrznych źródeł reklam z określaniem stawek lub kaskadowych źródeł reklam z zapośredniczeniem
Sprawdź, czy każda jednostka reklamowa została prawidłowo skonfigurowana pod kątem określania stawek i zapośredniczenia kaskadowego.
Z tego przewodnika dowiesz się, jak uruchamiać różne funkcje w reklamach i korzystać z nich i inspektor.
Wymagania wstępne
Aby użyć inspektora reklam:
- Przeczytaj Przewodnik dla początkujących.
- Korzystaj z Google Pakiet SDK do reklam mobilnych w wersji 7.68.0 lub nowszej.
- Dodaj urządzenie jako urządzenie testowe. Inspektor reklam działa tylko na urządzeniach testowych.
Uruchom inspektora reklam
Inspektora reklam można uruchomić z dowolnego miejsca w aplikacji na te sposoby:
- Podczas rejestrowania urządzenia testowego użyj gestu wybranego w interfejsie AdMob.
- automatycznie za pomocą dostarczonego interfejsu API.
- Użyj przycisku uruchamiania z menu debugowania.
Uruchamianie za pomocą gestów
Aby uruchomić inspektora reklam za pomocą gestu, nie musisz wprowadzać żadnych zmian w aplikacji. Wystarczy, że wykonasz gest (podwójne potrząśnięcie lub potrząśnięcie), który skonfigurowałeś/skonfigurowałaś w AdMob na tym urządzeniu testowym. Więcej informacji
Po ustawieniu gestu w interfejsie AdMob (i odczekaniu 15 minut, aż aplikacja musi wysłać żądanie reklamy na potrzeby reklam mobilnych Google. pakietu SDK, aby dowiedzieć się więcej o ustawieniach gestów. Jeśli określony gest nie działa, wczytaj reklamę, uruchom ponownie aplikację i ponownie przetestuj gest.
Uruchamiaj automatycznie
Inspektora reklam można też uruchomić automatycznie:
Swift
GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
// Error will be non-nil if there was an issue and the inspector was not displayed.
}
Objective-C
[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
completionHandler:^(NSError *error) {
// Error will be non-nil if there was an issue and the inspector was not displayed.
}];
Ten interfejs API działa z urządzeniami testowymi zarejestrowano automatycznie lub w interfejsie AdMob.
Sprawdź, czy kontroler widoku danych przekazywany do tego interfejsu API jest już w pełni widoczny w
ekranu (wywołano viewDidAppear:). Jeśli przekazany kontroler widoku jest w trakcie wyświetlania, np. gdy interfejs API jest wywoływany w funkcji viewDidLoad kontrolera widoku, prezentacja kontrolera inspekcji reklamy zakończy się niepowodzeniem.
Wyświetlanie jednostek reklamowych i rozwiązywanie problemów z nimi
Po uruchomieniu wyświetli się główny ekran inspektora reklam z listą wszystkich reklam jednostki w interfejsie AdMob powiązanym z identyfikatorem aplikacji AdMob, która korzysta z określania stawek lub zapośredniczenia. konfiguracje:
Przed użyciem 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, który zawiera 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żdą prośbę można rozwinąć, korzystając ze wskaźnika oświadczenia, aby wyświetlić wyniki. kaskady zapośredniczenia dla danego żądania, a także wszelkie błędy i czas oczekiwania która miała zastosowanie w przypadku tego wniosku.
W przypadku zewnętrznych źródeł reklam komunikaty o błędach są wysyłane bezpośrednio z ź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
Wymagania wstępne: pakiet SDK do reklam mobilnych Google 8.5.0 lub wyższy
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 żądania reklamy. Kliknij jednostkę reklamową w dzienniku żądań pakietu SDK, aby wyświetlić szczegóły każdego źródła reklam w aukcji ustalania stawek.
Wyniki ustalania stawek są sortowane w taki sposób, by zbliżać aktywne elementy do na początku listy:
U góry znajduje się sieć reklamowa, która wygrała aukcję.
Poniżej znajdziesz listę sieci reklamowych, w których występują problemy. Możesz śledzić procedurę rozwiązywania problemów.
Są też sieci reklamowe, które nie zwróciły żadnych reklam lub nie ustalały stawek. Ten może wskazywać na wiele różnych problemów ze źródłem reklam, może nie mieć stawki z powodu konfiguracji lub decyzji. Aby uzyskać pomoc, możesz zapoznać się z przewodnikiem konfiguracji źródła reklam lubskontaktować się bezpośrednio ze źródłem reklam.
Na końcu listy znajdują się sieci reklamowe, które przegrały stawki aukcji.
Kaskada zapośredniczenia może umieszczać źródło reklam, które wygrało aukcję z ustalaniem stawek, zgodnie z 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 kaskadowym modelu zapośredniczenia, znajdziesz w przykładzie 2 i przykładzie 3 źródeł reklam z ustalaniem stawek i kaskadowych źródeł reklam w grupie zapośredniczenia.
Zaawansowane debugowanie jednostek reklamowych
Podczas rozwiązywania problemów z jednostkami reklamowymi warto przyjrzeć się żądaniu reklamy i odpowiedzi, aby ustalić, gdzie występuje błąd. Możesz też przesłać te dane do zespołu pomocy Google, aby ułatwić debugowanie. Kliknij ikonę menu na górze wodospadu. łańcuch i wybierz Udostępnij żądanie reklamy i odpowiedź, aby wyeksportować całe żądanie reklamy. i reagowania. Pozwala to uniknąć konieczności uruchamiania śledzenia sieci na w Twojej aplikacji.
Możesz też zobaczyć zdekodowane parametry określania stawek przez inne firmy, klikając opcję Parametr określania stawek przez firmę zewnętrzną w tym samym menu co żądanie. ciągu znaków. Znajdziesz w nim szczegółowe informacje o tym, które parametry określania stawek przez firmę zewnętrzną w razie problemów, ułatwiając debugowanie aplikacji i sprawdzanie, czy sieć będzie zbierać sygnały.
Wyświetl dostępne adaptery
Kliknij kartę Adaptery, aby zobaczyć listę wszystkich powiązanych adapterów innych firm. ze źródłami reklam w konfiguracji określania stawek lub zapośredniczenia w aplikacji. Następnie rozwiń karty, aby wyświetlić ich stan inicjowania i wersje pakietu SDK. Oprócz obsługiwanych adapterów innych firm możesz też wyświetlać zdarzenia niestandardowe i ładowarki. Zdarzenia niestandardowe pozwalają wydawcy korzystają z sieci reklamowych, które AdMob Program nie jest obsługiwany. Zdarzenia niestandardowe można odróżnić od standardowych adapterów innych firm na liście adapterów po ich niepowtarzalnych nazwach klas. Oprócz podając nazwę klasy i informacje o stanie, inspektor reklam wyświetla etykiet przypisanych do tych zdarzeń niestandardowych w sekcji AdMob za pomocą interfejsu internetowego.
W przypadku, gdy adapter nie został znaleziony lub nie może się uruchomić, zapoznaj się z artykułem Rozwiązywanie problemów wykrytych za pomocą inspektora reklam .
Testowanie jednostek reklamowych
Jeśli chcesz przetestować jednostkę reklamową bez przechodzenia do niej w interfejsie aplikacji, możesz to zrobić bezpośrednio na ekranie z informacjami o jednostce reklamowej. Możesz też testować wiele jednostek reklamowych jednocześnie, asynchronicznie wczytywać i wyświetlać testowe żądania reklamy, a nawet przeprowadzać testy pojedynczego źródła reklam.
Testowanie reklam
Opisane w tej sekcji testy reklam za pomocą inspektora reklam to doskonałe narzędzie weryfikacji podstawowej jakości reklamy i zapośredniczenia w przypadku testowania pojedynczego źródła reklam.
Gdy będziesz gotowy do przetestowania jednostki reklamowej, kliknij przycisk Request test ad (Wyślij reklamę testową) u góry ekranu inspektora reklam, aby rozpocząć test reklamy. Testuj wyniki są następnie wyświetlane w dzienniku żądań pakietu SDK pod nagłówkiem Żądanie z inspektora reklam.
Testowanie pojedynczego źródła reklam
Inspektor reklam zawiera funkcję, która umożliwia ograniczenie żądań reklam w aplikacji tak, aby wyświetlała ona reklamy tylko z jednego źródła reklam z ustalaniem stawek lub kaskadowego źródła reklam zapośredniczonych. Pozwoli Ci to zweryfikować, czy masz prawidłowo zaimplementowany adapter innej firmy, a źródło reklam działa zgodnie z oczekiwaniami.
Aby włączyć tę funkcję, przełącz przełącznik Test pojedynczego źródła reklam na dole ekranu. Wyświetli się to okno wyboru źródła reklam:
Aby móc 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 będzie miało zastosowanie do wszystkich przyszłych żądań reklamy wysłanych w ramach tej samej sesji. Nie dotyczy to jednak reklam, które zostały wcześniej zapisane w pamięci podręcznej w ramach danej sesji, ale jeszcze nie zostały wyświetlone. Zalecane jest wymuszenie ponownego uruchomienia aplikacji w celu unieważnienia reklam przechowywanych w pamięci podręcznej, może zostać wyświetlone zamiast żądania przez wybrane źródło reklam.
Po ponownym uruchomieniu aplikacji wszystkie miejsca docelowe jednostek reklamowych będą wyświetlać reklamy tylko z wybranej sieci. Uruchomienie inspektora reklam, gdy aktywny jest test pojedynczego źródła reklam, powoduje wyświetlenie aktywnego testowanego źródła reklam:
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 dla żądanej jednostki reklamowej. Jeśli testowane źródło reklam nie znajduje się w hierarchii w kaskadzie zapośredniczenia dla jednostki reklamowej, pojawi się komunikat .
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 nie udało się wczytać reklamy przez źródło reklam, wyświetli się komunikat o błędzie z opisem błędu.
W przypadku dodania do zapośredniczenia wielu wystąpień wybranego źródła reklam w kaskadzie, zobaczysz każde wystąpienie wywołania do źródła reklam do momentu, gdy reklama zostanie wypełniona lub kaskada nie zakończy się bez wypełnienia.
Zatrzymywanie testu pojedynczego źródła reklam
Aby zatrzymać test, wyłącz przełącznik:
Na ekranie ponownego uruchamiania pojawi się komunikat z potwierdzeniem:
Po zatrzymaniu testu zalecamy wymuszenie ponownego uruchomienia aplikacji, aby: unieważni wszystkie reklamy w pamięci podręcznej w przypadku testowanego źródła reklam.
Kopiowanie wszystkich danych wyjściowych debugowania
Narzędzie Ad Inspector umożliwia kopiowanie ciągu JSON zawierającego wszystkie dane debugowania z narzędzia, w tym szczegóły aplikacjiAdMob , stany inicjowania adaptera i wyniki testów wszystkich jednostek reklamowych.
W tym celu 7 razy klikaj ikonę aplikacji, aż pojawi się komunikat Skopiowana reklama plik JSON inspektora do schowka.