Инструменты предварительного просмотра и доставки креативных материалов, Инструменты предварительного просмотра и доставки креативных материалов

В этом руководстве показано, как отлаживать показ рекламы с помощью предварительного просмотра в приложении и инструментов доставки Ad Manager.

Функция предварительного просмотра внутри приложения позволяет проверить собственные креативы, отображаемые в вашем мобильном приложении. Этот предварительный просмотр особенно полезен, если у вас есть креативы, которые взаимодействуют с приложением, имеют уникальное поведение или зависят от приложения для некоторых операций рендеринга (включая нативные креативы и MRAID).

Инструменты управления показом рекламы предоставляют информацию о том, какие объявления были показаны; поэтому, если были показаны неожиданные объявления, используйте эти инструменты, чтобы выяснить причину.

Предварительные требования

  • Версия 10.2.0 или выше SDK Google Mobile Ads.

Подготовьте ваше приложение

Для отладки необходимо взаимодействовать с меню параметров отладки SDK. Рекомендуемый способ открыть меню — добавить в приложение следующую функцию и запускать её в зависимости от действия пользователя:

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");
  }
}

Котлин 

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")
  }
}

Для открытия меню параметров отладки достаточно любого действующего рекламного блока из вашего аккаунта Ad Manager.

Другой способ открыть меню — это долго удерживать два пальца на рекламном блоке, но это работает не для всех форматов рекламы, таких как нативная реклама, и нужно быть осторожным, чтобы не кликнуть по объявлению при попытке прокрутки. Вызов предыдущего метода гораздо надежнее.

После добавления возможности открывать меню параметров отладки запустите приложение и вызовите функцию. Откроется следующее меню:

Выберите «Предварительный просмотр креатива» , чтобы связать ваше устройство. Откроется браузер, который автоматически перенаправит вас на страницу входа в Ad Manager. После входа в систему назовите ваше устройство, чтобы зарегистрировать его в вашей учетной записи Ad Manager. Затем нажмите «Подтвердить» .

На этом этапе вы можете убедиться, что ваше устройство подключено к пользовательскому интерфейсу Ad Manager . Вы также можете разрешить другим пользователям доступ к вашим устройствам .

Предварительный просмотр в приложении

Выполните следующие шаги, чтобы отправить креатив на подключенное устройство . Убедитесь, что отправленный креатив является частью активной строки объявления, ориентированной на тот рекламный слот, где вы хотите разместить креатив.

После отправки креатива через пользовательский интерфейс снова откройте меню параметров отладки на своем устройстве и еще раз выберите «Предварительный просмотр креатива» . Этот шаг позволяет SDK проверить Ad Manager, чтобы убедиться в успешности привязки устройства и получить информацию о том, какой креатив вы отправили. Если привязка устройства прошла успешно, меню отладки немедленно закроется. Если она была неудачной, вам будет предложено снова привязать свою учетную запись.

Наконец, загрузите рекламу для выбранного вами предварительного просмотра, чтобы увидеть свой креатив.

Инструменты доставки

Чтобы устранить неполадки с показом рекламы, выполните действия, описанные в разделе «Проверка показа» в Ad Manager . Если вы успешно выполнили все шаги, запрос отобразится в пользовательском интерфейсе Ad Manager, и вы сможете просмотреть дополнительную информацию о показанной рекламе.