Ta strona została przetłumaczona przez Cloud Translation API.

Inspektor reklam (beta)

{10/3} –{10/2} {11/3}

Suite 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.2.0 lub nowszej i może być włączona bez konieczności kodowania.

Korzystając z inspektora reklam, możesz:

Sprawdzanie jednostek reklamowych
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 dotyczące każdej sieci reklamowej z ustalaniem stawek na żądanie;
wyświetlać szczegóły zapośredniczenia dla każdej sieci reklamowej na żądanie;
testować poszczególne zewnętrzne źródła reklam z ustalaniem stawek lub kaskadowym zapośredniczeniem;
Sprawdź, czy każda jednostka reklamowa jest prawidłowo skonfigurowana pod kątem określania stawek i zapośredniczenia kaskadowego.

Z tego przewodnika dowiesz się, jak uruchamiać różne funkcje inspektora reklam i korzystać z nich.

Wymagania wstępne

Aby korzystać z inspektora reklam:

Znajdź identyfikator aplikacji Ad Manager.

Przeczytaj Przewodnik dla początkujących.

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

Włącz tryb testowy lub połącz swoje urządzenie z Ad Managerem. Inspektor reklam uruchamia się tylko na urządzeniach testowych lub połączonych z nimi.

Uruchamianie inspektora reklam

Inspektora reklam można uruchomić w dowolnym miejscu w aplikacji w jeden z tych sposobów:

Użyj przycisku uruchamiania w menu debugowania.
Użyj gestu wybranego w ustawieniach inspektora reklam.
automatycznie za pomocą dostarczonego interfejsu API.

Uruchomienie za pomocą menu debugowania

Aby uruchomić inspektora reklam w menu debugowania, nie musisz wprowadzać żadnych zmian w aplikacji. Wystarczy, że znajdziesz reklamę wyświetlaną przez sieć Ad Managera i przytrzymasz ją 2 palcami, aby otworzyć menu debugowania. Następnie kliknij Otwórz inspektora reklam.

Jeśli urządzenie nie zostało połączone, możesz zobaczyć prośbę o zalogowanie się na konto Ad Managera.

W ustawieniach debugowania możesz też wybrać Ustawienia inspektora reklam i wybrać gest, który w przyszłości otworzy inspektora reklam bez konieczności otwierania menu debugowania.

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.

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

Po uruchomieniu wyświetli się główny ekran inspektora reklam z listą wszystkich jednostek reklamowych, do których urządzenie wysłało żądania reklamy, ponieważ inspektor reklam został włączony podczas tej sesji aplikacji. Lista zawiera też jednostki reklamowe z włączonym określaniem stawek, uporządkowane chronologicznie (najpierw te, których żądania zostały zrealizowane ostatnio), oraz te, których żądania nie zostały zrealizowane (przyciemnione):

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

Jeśli dopiero zaczynasz korzystać z określania stawek, przeczytaj wprowadzenie do Otwartego ustalania 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. Aby rozwiązać te problemy, wykonaj instrukcje rozwiązywania problemów podane na końcu artykułu z odpowiedziami na najczęstsze pytania dotyczące ustalania stawek.
Następnie są 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ż może ono nie mieć stawki z powodu jego konfiguracji lub decyzji. Więcej informacji znajdziesz w przewodniku konfiguracji źródła reklam lub w najczęstszych pytaniach dotyczących Otwartego ustalania stawek.
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.

Kaskada zapośredniczenia to wynik rywalizacji wielu grup zysku o te same zasoby reklamowe. Do jednej grupy zysku możesz dodać maksymalnie 10 zewnętrznych partnerów zysku korzystających zarówno z usług ustalania stawek, jak i zapośredniczenia w aplikacjach mobilnych.

Zaawansowane debugowanie jednostek reklamowych

Podczas rozwiązywania problemów z jednostkami reklamowymi warto przyjrzeć się żądaniu reklamy i odpowiedziom, aby zidentyfikować, gdzie coś działa, lub udostępnić zespołowi pomocy Google, aby pomóc w debugowaniu. Kliknij ikonę menu u góry łańcucha kaskady i wybierz Udostępnij żądanie reklamy i odpowiedź, aby wyeksportować całe żądanie reklamy i odpowiedź. Dzięki temu unikniesz konieczności uruchamiania śledzenia sieci we własnej aplikacji.

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ętrzne źródła reklam 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 zewnętrznych możesz też wyświetlać adaptery zdarzeń niestandardowych. Zdarzenia niestandardowe umożliwiają wydawcom korzystanie z sieci reklamowych, których Ad Manager 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 inspekcja reklamy wyświetla też etykiety przypisane do tych zdarzeń niestandardowych w interfejsie internetowym Ad Managera.

Jeśli adapter nie zostanie znaleziony lub nie uda się go zainicjować, więcej informacji znajdziesz w artykule Sprawdzanie wyświetlania reklam w aplikacji mobilnej.

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 naraz, 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 świetne narzędzie do weryfikowania podstawowego wyświetlania reklam i sprawdzania konfiguracji zapośredniczenia w przypadku testowania pojedynczego źródła reklam.

Gdy jednostka reklamowa będzie gotowa do przetestowania, u góry ekranu inspektora reklam kliknij przycisk Poproś o reklamę testową. Wyniki testu pojawią się w dzienniku żądań pakietu SDK pod nagłówkiem Wymagane przez inspekcję reklamy.

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. W ten sposób możesz sprawdzić, czy adapter zewnętrzny został prawidłowo wdrożony i czy źródło reklam działa zgodnie z oczekiwaniami.

Aby włączyć tę funkcję, przesuń przełącznik Test pojedynczego źródła reklam u dołu ekranu. Wyświetli się to okno wyboru źródła reklam:

Zanim przetestujesz pojedyncze źródło 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 testowania pojedynczego źródła reklam dotyczy wszystkich przyszłych żądań reklam, które wyślesz w tej samej sesji. Nie będzie jednak miało zastosowania do reklam zapisanych w pamięci podręcznej w ramach tej sesji, które nie zostały jeszcze wyświetlone. Wymuszanie ponownego uruchomienia aplikacji jest zalecane w przypadku testowania pojedynczego źródła reklam. W ten sposób unieważnimy wszystkie reklamy w pamięci podręcznej, które mogłyby 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 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:

Następnie na ekranie ponownego uruchamiania pojawi się komunikat z potwierdzeniem:

Po zatrzymaniu testu zalecamy wymuszenie ponownego uruchomienia aplikacji, aby unieważnić zapisane w pamięci podręcznej reklamy ze źródła reklam, które zostało przetestowane.

Kopiowanie wszystkich danych wyjściowych debugowania

Inspektor reklam obsługuje kopiowanie ciągu JSON zawierającego całe dane wyjściowe debugowania z narzędzia, w tym szczegóły aplikacji Ad Managera, stany inicjowania adaptera i wyniki testowania wszystkich jednostek reklamowych.

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