Narzędzia podglądu i wyświetlania kreacji

Z tego przewodnika dowiesz się, jak debugować wyświetlanie reklam za pomocą podglądu w aplikacji i narzędzi do wyświetlania w usłudze Ad Manager.

Podgląd w aplikacji umożliwia sprawdzenie własnych kreacji renderowanych w aplikacji mobilnej. Jest to szczególnie przydatne w przypadku kreacji, które wchodzą w interakcję z aplikacją, zachowują się niestandardowo lub wymagają poprawnego renderowania elementów przez aplikację (w tym kreacji natywnych i MRAID).

Narzędzia do wyświetlania w usłudze Ad Manager zawierają informacje o tym, które reklamy zostały wyświetlone. Jeśli wyświetlają się nieoczekiwane reklamy, za ich pomocą możesz sprawdzić, dlaczego tak się dzieje.

Wymagania wstępne

  • SDK do reklam mobilnych Google w wersji 10.2.0 lub nowszej.

Przygotowanie aplikacji

Debugowanie wymaga interakcji z menu opcji debugowania SDK. Zalecany sposób otwierania menu to dodanie do aplikacji tej funkcji i wywołanie jej na podstawie działania użytkownika:

Java

public class MainActivity extends AppCompatActivity {

  ...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this)
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

Aby otworzyć menu opcji debugowania, wystarczy dowolna prawidłowa jednostka reklamowa z konta Ad Managera.

Innym sposobem otwarcia menu jest długie naciśnięcie kreacji 2 palcami, ale nie działa to w przypadku wszystkich formatów reklam, np. reklam natywnych. Musisz też uważać, aby podczas próby przesunięcia nie kliknąć reklamy. Wywołanie poprzedniej metody jest znacznie bardziej niezawodne.

Po dodaniu możliwości otwierania menu opcji debugowania uruchom aplikację i wywołaj funkcję. Otworzy się to menu:

Aby połączyć urządzenie, kliknij Creative Preview. Otworzy się przeglądarka i automatycznie przekieruje Cię do strony logowania w usłudze Ad Manager. Po zalogowaniu się nadaj urządzeniu nazwę, aby zarejestrować je na koncie Ad Managera. Następnie kliknij Zweryfikuj.

W tym momencie możesz sprawdzić, czy urządzenie zostało połączone w interfejsie Ad Managera. Możesz też zezwolić innym osobom na dostęp do swoich urządzeń.

Podgląd w aplikacji

Wykonaj te czynności, aby przesłać kreację na połączone urządzenie. Upewnij się, że przesłana kreacja jest częścią aktywnego elementu zamówienia kierowanego na boks reklamowy, w którym chcesz wyświetlać kreację.

Po przesłaniu kreacji z interfejsu ponownie wywołaj menu opcji debugowania na urządzeniu i jeszcze raz kliknij Creative Preview. Ten krok umożliwia SDK sprawdzenie w usłudze Ad Manager, czy połączenie urządzenia zostało nawiązane, oraz uzyskanie informacji o przesłanej kreacji. Jeśli połączenie urządzenia zostało wcześniej nawiązane, menu debugowania zostanie natychmiast zamknięte. Jeśli połączenie się nie powiodło, pojawi się prośba o ponowne połączenie konta.

Na koniec wczytaj reklamę w miejscu docelowym, którego podgląd chcesz wyświetlić, aby zobaczyć kreację.

Narzędzia do wyświetlania

Aby rozwiązać problemy z wyświetlaniem reklam, wykonaj czynności opisane w artykule Sprawdzanie wyświetlania w usłudze Ad Manager. Jeśli wykonasz te czynności, żądanie pojawi się w interfejsie Ad Managera i będziesz mieć dostęp do dodatkowych informacji o wyświetlonej reklamie.