Korzystając z inspektora reklam, możesz:
- Sprawdzanie jednostek reklamowych
- sprawdzać, czy jednostki reklamowe są wypełniane zgodnie z oczekiwaniami;
- znajdować błędy i wyświetlać szczegółowe informacje o tym, jak je rozwiązać;
- 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 została prawidłowo skonfigurowana pod kątem określania stawek i zapośredniczenia kaskadowego.
W tym przewodniku pokazujemy, jak uruchamiać i korzystać z różnych funkcji w adinspector.
Wymagania wstępne
Aby używać inspektora reklam:
- Zapoznaj się z przewodnikiem 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 działa tylko na urządzeniach testowych lub połączonych.
Uruchamianie inspektora reklam
Inspektora reklam można uruchomić w dowolnym miejscu w aplikacji w jeden z tych sposobów:
- Użyj przycisku uruchamiania z 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 Ad Inspector.
Jeśli nie połączysz urządzenia, możesz zostać poproszony(-a) 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 będzie otwierać inspektora reklam bez konieczności uruchamiania menu debugowania.
Uruchamianie programowo
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 automatycznie.
Upewnij się, że kontroler widoku przekazany do tego interfejsu API jest już w pełni widoczny na ekranie (wywołanie viewDidAppear: zostało już wykonane). Jeśli przekazany kontroler widoku jest w trakcie wyświetlania, np. gdy wywołuje się interfejs API w funkcji viewDidLoad kontrolera widoku, prezentacja kontrolera reklamy zakończy się niepowodzeniem.
Wyświetlanie jednostek reklamowych i rozwiązywanie problemów z nimi związanych
Po uruchomieniu inspektora reklam wyświetli się główny ekran inspektora reklam z listą wszystkich jednostek reklamowych, dla których urządzenie wysłało żądania reklamy od momentu włączenia inspektora reklam 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 dotyczące 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 ustalanie stawek jest dla Ciebie nowością, 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 odpowiedzi na najczęstsze pytania dotyczące ustalania stawek.
Następnie są sieci reklamowe, które nie zwróciły żadnych reklam lub nie ustalił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. Więcej informacji znajdziesz w przewodniku po konfigurowaniu źródła reklam lub w najczęstszych pytaniach dotyczących Otwartego ustalania stawek.
U dołu 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 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.
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. Pomoże Ci to w debugowaniu aplikacji lub sprawdzeniu, 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 nie uda się znaleźć adaptera 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 jednocześnie, 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 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 Request test ad (Wyślij reklamę testową) 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.
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 pojedynczym systemem ustalania stawek lub kaskadowego zapośredniczenia. Pozwoli 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 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 reklamy wyświetli się ten ekran:
Ustawienie testu pojedynczego źródła reklam będzie stosowane do wszystkich przyszłych żądań reklam 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. Zalecamy wymuszenie ponownego uruchomienia aplikacji podczas stosowania testu pojedynczego źródła reklam, aby unieważnić reklamy w pamięci podręcznej, które mogłyby 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 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 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ą, 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:
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.
Debugowanie ustawień prywatności
Wymagania wstępne: pakiet SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej
Za pomocą inspektora reklam możesz wyświetlić te sygnały dotyczące prywatności przekazywane w prośbie o reklamę w ramach integracji wydawcy z zasadami TCF IAB Europe:
- RODO obowiązuje (
IABTCF_gdprApplies) - Ciąg tekstowy dotyczący udzielenia dodatkowej zgody (
IABTCF_AddtlConsent) - Ciąg tekstowy dotyczący przejrzystości i zgody (
IABTCF_TCString)
Po załadowaniu reklamy lub przeprowadzeniu testu reklamy w inspektorze reklam kliknij ikonę menu żądania w sekcji Dziennik żądań pakietu SDK. Następnie wybierz opcję Sygnały dotyczące prywatności.
Na ekranie Sygnały dotyczące prywatności wyświetlają się sygnały dotyczące prywatności przekazane w żądaniu reklamy.
Więcej informacji o ciągu tekstowym AC znajdziesz w specyfikacji technicznej Google o nazwie „Udzielenie dodatkowej zgody”. Aby wyświetlić szczegółowe informacje o zgodzie w ciągu tekstowym dotyczącym przejrzystości i zgody, np. identyfikator CMP i listę identyfikatorów dostawców powiązanych z IAB, na których użytkownik udzielił zgody, kliknij Odkoduj, aby otworzyć koder / dekoder GPP IAB.
Jeśli pojawią się błędy, wykonaj czynności opisane w artykule o problemach z prywatnością.
Kopiowanie wszystkich danych wyjściowych debugowania
Inspektor reklam umożliwia kopiowanie ciągu JSON zawierającego wszystkie dane wyjściowe narzędzia do debugowania, w tym szczegóły dotyczące aplikacji Ad Managera, 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.