Inspektor reklam

Inspektor reklam to nakładka w aplikacji, która umożliwia autoryzowanym urządzeniom przeprowadzanie analizy żądań reklam testowych w czasie rzeczywistym bezpośrednio w aplikacji mobilnej. Jest ona dostępna w pakiecie SDK do reklam mobilnych Google w wersji 20.0.0 lub nowszej i może być włączona bez konieczności kodowania.

Korzystając z inspektora reklam w wersjach pakietu SDK do reklam mobilnych niższych niż 20.2.0, możesz:

• Sprawdzanie jednostek reklamowych
• Sprawdzanie adapterów zewnętrznych źródeł reklam
• sprawdzać, czy jednostki reklamowe są wypełniane zgodnie z oczekiwaniami;
• znajdować błędy i wyświetlać szczegółowe informacje o tym, jak rozwiązać problem;
• wyświetlać szczegóły zapośredniczenia dla każdej sieci reklamowej na żądanie;
• Testowanie poszczególnych zewnętrznych zapośredniczonych źródeł reklam
• Sprawdź, czy jednostki reklamowe zostały prawidłowo skonfigurowane pod kątem zapośredniczenia kaskadowego.
• testować integracje zdarzeń niestandardowych.

W pakiecie SDK do reklam mobilnych w wersji 20.2.0 lub nowszej możesz też:

• wyświetlać szczegóły określania stawek dla każdej sieci reklamowej na żądanie;
• wyświetlać szczegóły ustalania stawek i kaskady zapośredniczenia dotyczące poszczególnych sieci reklamowych na poziomie żądania;
• testować poszczególne zewnętrzne źródła reklam z ustalaniem stawek lub kaskadowym 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ć i korzystać z różnych funkcji w adinspektorze.

Wymagania wstępne

Aby użyć inspektora reklam:

• Utwórz konto AdMob i skonfiguruj aplikację.

• Przeczytaj Przewodnik dla początkujących.

• Użyj pakietu SDK do reklam mobilnych Google w wersji 20.0.0 lub nowszej.

• Dodaj urządzenie jako urządzenie testowe. Inspektor reklam działa tylko na urządzeniach testowych.

Uruchamianie inspektora reklam

Inspektora reklam można uruchomić z dowolnego miejsca w aplikacji w następujący sposób:

1. Podczas rejestrowania urządzenia testowego użyj gestu wybranego w interfejsie AdMob.
2. automatycznie za pomocą dostarczonego interfejsu API.
3. 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 po 15 minutach oczekiwania 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, wczytaj reklamę, uruchom ponownie aplikację i ponownie przetestuj gest.

Uruchamianie programowo

Inspektora reklam można też uruchomić automatycznie:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

Ten interfejs API działa na urządzeniach testowych zarejestrowanych programowo lub w interfejsie AdMob.

Wyświetlanie jednostek reklamowych i rozwiązywanie problemów z nimi związanych

Po uruchomieniu inspektora reklam otworzy się główny ekran, na którym znajdziesz listę wszystkich jednostek reklamowych w interfejsie AdMob powiązanych z identyfikatorem aplikacji AdMob, które mają konfiguracje określania stawek lub konfiguracje zapośredniczenia:

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żde żądanie można rozwinąć, aby wyświetlić wyniki kaskady zapośredniczenia dla tego żądania, a także wszelkie błędy i opóźnienia, które wystąpiły w tym 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

Wymagania wstępne: pakiet SDK do reklam mobilnych Google w wersji 20.2.0 lub nowszej

Jeśli dopiero zaczynasz określać stawki, przeczytaj artykuł Omówienie określania stawek.

W dzienniku żądań pakietu SDK możesz zobaczyć źródła reklam z ustalaniem stawek 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 ustalania stawek.

Wyniki określania stawki są sortowane w taki sposób, aby elementy, które można wykonać, znajdowały się wyżej na liście:

• 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 wykonać instrukcje rozwiązywania problemów.

• 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, które może nie mieć stawki ze względu na konfigurację lub proces decyzyjny. Aby uzyskać pomoc, możesz zapoznać się z przewodnikiem konfiguracji źródła reklam lub skontaktować się bezpośrednio ze źródłem reklam.

• Na dole listy znajdują się sieci reklamowe, które przegrały aukcję z określaniem stawek.

  

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 u góry łańcucha kaskadowego 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.

Uwaga: odpowiedzi reklam możesz eksportować dopiero po dodaniu urządzenia testowego w interfejsie AdMob.

Dekodowane parametry określania stawek przez źródło zewnętrzne możesz też wyświetlić, klikając opcję Parametr zewnętrznego źródła reklam z ustalaniem stawek w tym samym menu co ciąg znaków żądania. Znajdziesz tu szczegółowe informacje o tym, które parametry określania stawek przez zewnętrznych dostawców mogą mieć problemy, co ułatwi Ci 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 innych firm powiązanych ze źródłami reklam w konfiguracjach ustalania stawek lub zapośredniczenia w aplikacji. Następnie rozwiń karty, aby wyświetlić stany inicjowania i wersje pakietów 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órych AdMob nie obsługuje. Zdarzenia niestandardowe można odróżnić od standardowych adapterów innych firm na liście adapterów po ich niepowtarzalnych nazwach 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ć, zapoznaj się z artykułem Rozwiązywanie problemów wykrytych za pomocą inspektora reklam, aby uzyskać więcej informacji.

Uwaga: wcześniejsze implementacje zdarzeń niestandardowych, które powstały przed wersją interfejsu API 20.0.0, w ramach podklasy interfejsów API wycofanych nie obsługują inicjalizacji i wyświetlają się w inspektorze reklamy jako Znaleziono problem. Jeśli w inspektorze reklam widzisz to ostrzeżenie, mimo że integracja z niestandardowym zdarzeniem wydaje się działać, sprawdź, czy Twoja aplikacja nie używa interfejsów wycofanych, takich jak CustomEventBanner, i zastąp je nową klasą Adapter.

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.

Ważne: gdy przeprowadzasz jeden z tych testów w inspektorze reklam, Twoje żądania nie zawierają niektórych parametrów, które byłyby dostępne, gdyby zostały wywołane w interfejsie aplikacji, w tym konfiguracji traktowania treści jako skierowanych do dzieci, ustawienia kierowania niestandardowego, dodatkowych opcji sieci, różnych rozmiarów itp. Ze względu na ograniczony charakter tych żądań zalecamy przetestowanie interfejsu aplikacji, jeśli to możliwe.

Testowanie reklam

Testy reklam w Inspektorze reklam opisane w tej sekcji to przydatne narzędzie do weryfikowania podstawowego wyświetlania reklam i sprawdzania konfiguracji zapośredniczenia w przypadku testowania pojedynczego źródła reklam.

Gdy będziesz gotowy/gotowa do przetestowania jednostki reklamowej, kliknij przycisk Wyślij żądanie reklamy testowej u góry ekranu inspektora reklam, aby uruchomić test reklamy. Wyniki testu pojawią się w dzienniku żądań pakietu SDK pod nagłówkiem Wymagane przez inspekcję reklamy.

Uwaga: aby korzystać z funkcji Request test ad, zainicjuj pakiet SDK do reklam mobilnych Google z kontekstem Activity.

Dowiedz się, jak używać inspektora reklam w aplikacji

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. Pozwoli Ci to sprawdzić, czy zewnętrzny adapter został poprawnie wdrożony i czy ź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ę 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ć pojedyncze źródło reklam, które chcesz przetestować. 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 tej sesji, ale jeszcze nie zostały wyświetlone. Zalecamy wymuszenie ponownego uruchomienia aplikacji podczas stosowania testu pojedynczego źródła reklam, aby unieważnić reklamy z pamięci podręcznej, które mogą zostać wyświetlone zamiast reklam wybranego źródła reklam.

Po ponownym uruchomieniu aplikacji wszystkie miejsca docelowe jednostek reklamowych będą wyświetlać reklamy tylko z wybranej sieci. Uruchomienie inspektora reklam, gdy test pojedynczego źródła reklam jest aktywny, 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 zostało 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 kaskadzie zapośredniczenia 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 może załadować reklamy, pojawi się komunikat o błędzie opisujący błąd.

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:

Na ekranie ponownego uruchamiania pojawi się komunikat z potwierdzeniem:

Zalecamy wymuszenie ponownego uruchomienia aplikacji po zakończeniu testu, aby unieważnić wszystkie reklamy z poziomu pamięci podręcznej dla 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ółowe informacje o aplikacji AdMob, stany inicjowania adaptera i wyniki testów wszystkich jednostek reklamowych.

Aby to zrobić, kliknij ikonę aplikacji 7 razy, aż zobaczysz komunikat Skopiowano adinspector.json do schowka.