Za pomocą inspektora reklam możesz:
- Sprawdzanie jednostek reklamowych
- Sprawdzanie, czy reklamy są wypełniane zgodnie z oczekiwaniami
- znajdować błędy i wyświetlać szczegółowe informacje o tym, jak je naprawić;
- Wyświetlanie szczegółów każdej sieci reklamowej z Otwartym ustalaniem stawek w poszczególnych żądaniach
- Wyświetlanie szczegółów zapośredniczenia poszczególnych sieci reklamowych w żądaniach
- testować poszczególne zewnętrzne źródła reklam z Otwartym ustalaniem stawek lub kaskadowe źródła reklam z zapośredniczeniem;
- Sprawdź, czy poszczególne jednostki reklamowe są prawidłowo skonfigurowane pod kątem Otwartego ustalania stawek i zapośredniczenia kaskadowego.
Z tego przewodnika dowiesz się, jak uruchamiać różne funkcje narzędzia Ad Inspector i z nich korzystać.
Wymagania wstępne
Aby używać inspektora reklam, musisz:
- Wypełnij przewodnik dla początkujących.
- Użyj pakietu SDK do reklam mobilnych Google w wersji 8.10.0 lub nowszej.
- Włącz tryb testowy lub połącz urządzenie z Ad Managerem. Inspektor reklam uruchamia się tylko na urządzeniach testowych lub połączonych.
Uruchom inspektora reklam
Inspektora reklam można uruchomić z dowolnego miejsca w aplikacji na te sposoby:
- Użyj przycisku uruchamiania z menu debugowania.
- Użyj gestu wybranego w ustawieniach inspektora reklam.
- Automatycznie za pomocą udostępnionego interfejsu API.
Uruchamianie za pomocą menu debugowania
Aby uruchomić inspektora reklam za pomocą menu debugowania, nie musisz wprowadzać w aplikacji żadnych zmian. Wystarczy znaleźć reklamę wyświetlaną przez sieć Ad Managera, a potem dotknąć i przytrzymać ją 2 palcami, aby otworzyć menu debugowania. Następnie kliknij Otwórz inspektora reklam.
Jeśli nie połączono urządzenia, może pojawić się prośba o zalogowanie się na konto Ad Managera.
Możesz też w ustawieniach debugowania wybrać Ustawienia inspektora reklam i wybrać gest, który w przyszłości spowoduje otwarcie inspektora reklam bez konieczności korzystania z menu debugowania.
Uruchamiaj program 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 na urządzeniach testowych zarejestrowanych .
Sprawdź, czy kontroler widoku przekazany do tego interfejsu API jest już w pełni widoczny na ekranie (wywołano funkcję viewDidAppear:). Jeśli przekazywany kontroler widoku jest w trakcie wyświetlania, na przykład po wywołaniu interfejsu API w funkcji viewDidLoad tego kontrolera, prezentacja inspektora reklam się nie powiedzie.
Wyświetlanie jednostek reklamowych i rozwiązywanie problemów z nimi
Po uruchomieniu zobaczysz główny inspektor reklam z listą wszystkich jednostek reklamowych Urządzenie wysłało żądania reklamy od czasu włączenia inspektora reklam podczas tej sesji aplikacji. Lista zawiera też jednostki reklamowe z włączonym Otwartym ustalaniem stawek, uporządkowane chronologicznie od najnowszych zrealizowanych żądań i te bez ukończonych żądań reklamy (wyszarzone):
Przed użyciem inspektora reklam zalecamy zainicjowanie pakietu SDK do reklam mobilnych Google.
Wyświetlanie szczegółów kaskady zapośredniczenia dla jednostki reklamowej
Kliknij jednostkę reklamową, aby wyświetlić jej dziennik żądań pakietu SDK, który zawiera szczegółowe informacje o kaskadzie zapośredniczenia do momentu wypełnienia reklamy (lub do zakończenia kaskady bez wypełnienia) w przypadku ostatnich żądań reklamy.
Każde żądanie można rozwinąć za pomocą wskaźnika ujawnienia, aby pokazać wyniki kaskady zapośredniczenia odpowiadające danemu żądaniu wraz z wszelkimi błędami i czasem oczekiwania, które wystąpiły w przypadku tego żądania.
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 jednostki reklamowej
Jeśli dopiero zaczynasz korzystać z Otwartego ustalania stawek, przeczytaj wprowadzenie do Otwartego ustalania stawek.
W dzienniku żądań pakietu SDK widoczne są Open Bidding źródła reklam 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 Open Bidding aukcji.
Wyniki są posortowane w taki sposób, aby Open Bidding wyniki znalazły się bliżej początku listy:
U góry znajduje się sieć reklamowa, która wygrała aukcję.
Następne są sieci reklamowe, z którymi są problemy. Aby rozwiązać problemy, wykonaj te Instrukcje rozwiązywania problemów znajdziesz na końcu sekcji Open Bidding Najczęstsze pytania.
Istnieją sieci reklamowe, które nie zwróciły reklam lub nie ustalały stawek. Może to oznaczać wiele różnych problemów ze źródłem reklam, ponieważ mogło ono nie ustalić stawki z powodu jego konfiguracji lub decyzji. Możesz przejrzeć przewodnik po konfiguracji źródła reklam lub Najczęstsze pytania na temat Otwartego ustalania stawek, aby uzyskać dodatkową pomoc.
Na dole listy znajdują się sieci reklamowe, które przegrały aukcjęOpen Bidding .
Kaskada zapośredniczenia może umieścić źródło reklam, które wygrało aukcję, Open Bidding zgodnie z ich wartością eCPM.
Kaskada zapośredniczenia jest wynikiem tego, że wiele grup zysku konkurują o te same zasoby reklamowe. Do jednej grupy zysku możesz dodać maksymalnie 10 zewnętrznych partnerów zysku korzystających zarówno z Otwartego ustalania stawek, jak i z zapośredniczenia w przypadku partnerów zysku z aplikacji mobilnych.
Zaawansowane debugowanie jednostek reklamowych
Przy rozwiązywaniu problemów z jednostkami reklamowymi warto przyjrzeć się bliżej żądaniu reklamy i odpowiedziom, aby określić, gdzie jest problem, lub przekazać go zespołowi pomocy Google w celu ułatwienia debugowania. Aby wyeksportować pełne żądanie reklamy i odpowiedź, kliknij ikonę menu u góry łańcucha kaskady i wybierz Udostępnij żądanie reklamy i odpowiedź. Dzięki temu nie musisz uruchamiać śledzenia sieci we własnej 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 znaków żądania. Znajdziesz tam szczegółowe informacje o tym, z którymi zewnętrznymi parametrami ustalania stawek mogą występować problemy. Ułatwi Ci to debugowanie aplikacji lub sprawdzanie, czy sieć prawidłowo zbiera sygnały.
Wyświetl dostępne adaptery
Kliknij kartę Adaptery, aby wyświetlić listę wszystkich adapterów zewnętrznych powiązanych ze źródłami reklam w konfiguracjach określania stawek lub zapośredniczenia w Twojej aplikacji. Następnie rozwiń karty, aby zobaczyć stan ich inicjowania i wersje pakietu SDK. Oprócz obsługiwanych adapterów innych firm możesz też wyświetlać adaptery zdarzeń niestandardowych. Zdarzenia niestandardowe umożliwiają wydawcom korzystanie z sieci reklamowych, które Ad Managernie obsługują. Zdarzenia niestandardowe można odróżnić od standardowych adapterów zewnętrznych na liście adapterów unikalnymi nazwami klas. Oprócz podania nazwy klasy i informacji o stanie inspektor reklam wyświetla też w interfejsie internetowym etykiety przypisane do tych zdarzeń niestandardowych.Ad Manager
Jeśli nie można znaleźć adaptera lub nie można go zainicjować, przeczytaj sekcję: Sprawdzanie wyświetlania reklam w aplikacjach mobilnych , aby uzyskać więcej informacji.
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. Możesz też testować wiele jednostek reklamowych naraz, 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 z inspektora reklam to doskonałe narzędzie do sprawdzania widoczności reklam podstawowych oraz do sprawdzania konfiguracji zapośredniczenia w połączeniu z testowaniem pojedynczego źródła reklam.
Aby przetestować jednostkę reklamową, kliknij przycisk Wyślij żądanie reklamy testowej u góry ekranu inspektora reklam, aby uruchomić test reklam. Wyniki testu pojawią się w dzienniku żądań pakietu SDK pod nagłówkiem Requested z inspektora reklam.
Testowanie pojedynczego źródła reklam
Inspektor reklam ma funkcję, która ogranicza żądania reklam z aplikacji tak, aby wyświetlały reklamy tylko z jednego Open Bidding źródła reklam z zapośredniczeniem kaskadowym. Pozwoli Ci to sprawdzić, czy adapter innej firmy został poprawnie wdrożony i czy źródło reklam działa zgodnie z oczekiwaniami.
Aby włączyć tę funkcję, ustaw przełącznik Test pojedynczego źródła reklam u dołu ekranu. Wyświetli się to okno wyboru źródła reklam:
Zanim zaczniesz 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ę taki ekran:
Ustawienie testu pojedynczego źródła reklam dotyczy wszystkich przyszłych żądań reklamy, które zrobisz w tej samej sesji. Nie dotyczy to jednak żadnych reklam z pamięci podręcznej w tej sesji, które nie zostały jeszcze wyświetlone. W przypadku testu pojedynczego źródła reklam zalecamy wymuszenie ponownego uruchomienia aplikacji. Pozwoli to unieważnić reklamy z pamięci podręcznej, które mogłyby zostać wyświetlone zamiast wybranego źródła reklam otrzymującego żądanie.
Po ponownym uruchomieniu aplikacji wszystkie miejsca docelowe jednostek reklamowych będą próbowały wyświetlać reklamy tylko z wybranej sieci. Uruchomienie inspektora reklam przy aktywnym testze pojedynczego źródła reklam spowoduje, że widoczne będzie aktywne testowe źródło reklam:
W trybie testowania pojedynczego źródła reklam wszystkie żądania reklam próbują wypełnić wybrane źródło reklam, niezależnie od tego, czy źródło reklam zostało 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ą, 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 załaduje reklamy, pojawi się komunikat o błędzie z opisem błędu.
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, ustaw przełącznik w pozycji wyłączonej:
Na ekranie ponownego uruchamiania pojawi się komunikat z potwierdzeniem:
Po zatrzymaniu testu zalecamy wymuszenie ponownego uruchomienia aplikacji, aby w przypadku przetestowanego źródła reklam unieważnić reklamy przechowywane w pamięci podręcznej.
Skopiuj całe wyniki debugowania
Inspektor reklam obsługuje kopiowanie ciągu znaków JSON zawierającego wszystkie dane wyjściowe debugowania, w tym szczegóły aplikacjiAd Manager , stany inicjowania adaptera i wyniki testowania wszystkich jednostek reklamowych.
Aby to zrobić, kliknij ikonę aplikacji 7 razy, aż zobaczysz komunikat Skopiowano plik JSON inspektora reklam do schowka.