Inspektor reklam

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 innych firm
• 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 poszczególnych sieci reklamowych 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
• testować integracje zdarzeń niestandardowych.

W przypadku pakietu 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 określania stawek i zapośredniczenia kaskadowego 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ć i korzystać z różnych funkcji w adinspektorze.

Wymagania wstępne

Aby używać inspektora reklam:

• Utwórz konto AdMob i skonfiguruj aplikację.

• Zapoznaj się z przewodnikiem 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 uruchamia się tylko na urządzeniach testowych.

Uruchom inspektora reklam

Inspektora reklam można uruchomić z dowolnego miejsca w aplikacji na te sposoby:

1. Podczas rejestrowania urządzenia testowego używaj gestu wybranego w interfejsie AdMob.
2. w sposób zautomatyzowany, przy użyciu udostępnionego interfejsu API.
3. 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, ż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 na jego rozpowszechnienie) aplikacja musi wysłać żądanie reklamy do pakietu SDK do reklam mobilnych Google, aby uzyskać informacje o ustawieniu gestów. 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:

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

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

Ten interfejs API działa w przypadku urządzeń testowych zarejestrowanych automatycznie 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 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 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. 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 w wersji 20.2.0 lub nowszej

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

Dziennik żądań pakietu SDK zawiera informacje o źródłach reklam z ustalaniem stawek, które są 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ę.

• Następne w kolejności są sieci reklamowe, w których występują problemy. Możesz skorzystać z procedury 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. Możesz zapoznać się z przewodnikiem konfiguracji źródła reklam lub skontaktować się bezpośrednio z nim, aby uzyskać pomoc.

• Na dole 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 na podstawie 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 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 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 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.

Możesz też wyświetlić zdekodowane parametry określania stawek przez firmę zewnętrzną, klikając opcję Parametr określania stawek przez firmę zewnętrzną 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świetl dostępne adaptery

Kliknij kartę Adaptery, aby zobaczyć listę wszystkich adapterów zewnętrznych powiązanych ze źródłami reklam w konfiguracjach określania stawek lub zapośredniczenia w aplikacji. Następnie rozwiń karty, by wyświetlić ich stan inicjowania i wersje pakietu SDK. Oprócz obsługiwanych adapterów zewnętrznych możesz też wyświetlać adaptery zdarzeń niestandardowych. Zdarzenia niestandardowe pozwalają wydawcom korzystać 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 zainicjuje się, 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 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.

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ę 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 wysyłanych w ramach 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. 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 jednostki reklamowej będą próbowały wyświetlać reklamę tylko z wybranej sieci. Uruchomienie inspektora reklam przy aktywnym teście pojedynczego źródła reklam pokazuje 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 zostało ono skonfigurowane na potrzeby 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 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 wczytać reklamy, pojawi się komunikat o błędzie z opisem błędu.

Jeśli dodasz wiele wystąpień wybranego źródła reklam do kaskady zapośredniczenia, każde wystąpienie wywołania z tego źródła będzie widoczne w kaskadzie aż do wypełnienia reklamy lub zakończenia kaskady bez wypełnienia.

Przerywanie testu pojedynczego źródła reklam

Aby zatrzymać test, ustaw przełącznik w pozycji wyłączonej:

Na następnym 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 pełne dane wyjściowe debugowania z narzędzia, w tym szczegóły aplikacji AdMob, stany inicjowania adaptera i wyniki testów wszystkich jednostek reklamowych.

Aby to zrobić, klikaj ikonę aplikacji 7 razy, aż pojawi się komunikat Plik JSON z inspektora reklam został skopiowany do schowka.