Делегированные методы — Android

Последнее обновление:

Делегированные методы Chartboost SDK предлагают больше гибкости в контроле над интеграцией. Пользуйтесь ими, чтобы ваша реклама воспринималась именно так, как вы хотите!


Содержание


Обзор

Делегированные методы Chartboost SDK предлагают больше гибкости в контроле над интеграцией. Например, вы можете:

  • Регистрировать отладочные сообщения, когда ваша игра пытается загрузить рекламную вставку
  • Не отображать рекламу, когда пользователь играет в вашу игру впервые
  • Определять, нажал пользователь на рекламе или просто закрыл ее, и реагировать соответствующим образом
  • Не отображать рекламу или страницу «Другие приложения» там и в то время, где и когда это может помешать игре

Доступные методы Chartboost Android SDK можно найти среди документации в папке doc, которая входит в загружаемый пакет SDK. На практике многие эти методы реализованы в примере проекта, который входит в пакет.


Методы конфигурации SDK

Эти методы позволяют влиять на функциональность и настройки Chartboost SDK:

// Проверяет, кэширована ли рекламная вставка в данной локации.
public static boolean hasInterstitial(String location)

// Проверяет, кэширована ли страница «Другие приложения» в данной локации.
public static boolean hasMoreApps(String location)

// Проверяет, кэшировано ли вознаграждаемое видео в данной локации.
public static boolean hasRewardedVideo(String location) 

// Проверяет, отображаются ли какие-нибудь экраны
public static boolean isAnyViewVisible()

// Включает или отключает функцию автоматического кэширования (по умолчанию: включена).*
public static void setAutoCacheAds(boolean autoCacheAds)

// Получает текущее поведение автоматического кэширования (по умолчанию: true).*
public static boolean getAutoCacheAds()

// Задает настраиваемый идентификатор для передачи в теле POST во всех запросах к серверу Chartboost API.
public static void setCustomId(String customID)

// Получает текущий настраиваемый идентификатор, который передается в теле POST для всех запросов к серверу Chartboost API.
public static String getCustomID()

// Определяет, следует ли Chartboost SDK отображать рекламную вставку при первом сеансе.
public static void setShouldRequestInterstitialsInFirstSession(boolean shouldRequest)

//  Определяет, должен ли Chartboost SDK показывать экран загрузки при подготовке к отображению UI страницы «Другие приложения».
public static void setShouldDisplayLoadingViewForMoreApps(boolean shouldDisplay)

// Определяет, следует ли Chartboost SDK пытаться извлечь видео с серверов Chartboost API.
public static void setShouldPrefetchVideoContent(boolean shouldPrefetch)

Подробнее о настройках AutoCacheAds и, в целом, о кэшировании рекламы можно узнать здесь.


Настройка делегатов SDK

Перед использованием делегированных функций задайте делегат Chartboost в методе onCreate() своей активности:

Chartboost.setDelegate(YourDelegateObject);

После этого создайте экземпляр делегированного объекта и объявите делегированные методы следующим образом:

private ChartboostDelegate YourDelegateObject = new ChartboostDelegate() {
// Объявите делегированные методы здесь (примеры см. в проекте CBSample)
};

Делегированные методы для статичных вставок и видеовставок

// Вызывается до запроса рекламной вставки через сервер Chartboost API.
public boolean shouldRequestInterstitial(String location)

// Вызывается до того, как вставка отображается на экране.
public boolean shouldDisplayInterstitial(String location)

// Вызывается после того, как вставка отображается на экране.
public void didDisplayInterstitial(String location)

// Вызывается после того, как вставка загружена с серверов Chartboost API
// и сохранена в локальный кэш.
public void didCacheInterstitial(String location)

// Вызывается после неудачной попытки загрузить вставку
// с серверов Chartboost API.
public void didFailToLoadInterstitial(String location, CBImpressionError error)

// Вызывается после того, как вставка была прекращена.
public void didDismissInterstitial(String location)

// Вызывается после того, как вставка была закрыта.
public void didCloseInterstitial(String location)

// Вызывается после того, как вставка была нажата.
public void didClickInterstitial(String location)

Делегированные методы для страницы «Другие приложения»

// Вызывается до того, как страница «Другие приложения» отображается на экране.
public boolean shouldDisplayMoreApps(String location)

// Вызывается после того, как страница «Другие приложения» отображается на экране.
public void didDisplayMoreApps(String location)

// Вызывается после того, как страница «Другие приложения» загружена с серверов Chartboost API
// и сохранена в локальный кэш.
public void didCacheMoreApps(String location)

// Вызывается после того, как страница «Другие приложения» была прекращена.
public void didDismissMoreApps(String location)

// Вызывается после того, как страница «Другие приложения» была закрыта.
public void didCloseMoreApps(String location)

// Вызывается после того, как страница «Другие приложения» была нажата.
public void didClickMoreApps(String location)

// Вызывается после неудачной попытки загрузить страницу «Другие приложения»
// с серверов Chartboost API.
public void didFailToLoadMoreApps(String location, CBImpressionError error)

Делегированные методы для видео с вознаграждением за просмотр

(подробнее о Chartboost Video см. эту страницу)

// Вызывается до того, как вознаграждаемое видео отображается на экране.
public boolean shouldDisplayRewardedVideo(String location)

// Вызывается после того, как вознаграждаемое видео отображается на экране.
public void didDisplayRewardedVideo(String location)

// Вызывается после того, как вознаграждаемое видео загружено с серверов Chartboost API
// и сохранено в локальный кэш.
public void didCacheRewardedVideo(String location)

// Вызывается после неудачной попытки загрузить вознаграждаемое видео
// с серверов Chartboost API.
public void didFailToLoadRewardedVideo(String location, CBImpressionError error)

// Вызывается после того, как вознаграждаемое видео было прекращено.
public void didDismissRewardedVideo(String location)

// Вызывается после того, как вознаграждаемое видео было закрыто.
public void didCloseRewardedVideo(String location)

// Вызывается после того, как вознаграждаемое видео было нажато.
public void didClickRewardedVideo(String location)

// Вызывается после полного просмотра вознаграждаемого видео – то есть, когда пользователь получил право на вознаграждение.
public void didCompleteRewardedVideo(String location, int reward)

// Реализуется для уведомления о том, что видео будет отображаться на экране для 
// данного CBLocation. После этого можно, например, отключать эффекты или звуки.
public void willDisplayVideo(String location)

Делегированные методы Встроенной рекламы

// Вызывается после того, как объект Встроенной рекламы загружен с серверов Chartboost API
// и сохранен в локальный кэш.
public void didCacheInPlay(String location)

// Вызывается после неудачной попытки Встроенной рекламы загрузить данные
// с серверов Chartboost API.
public void didFailToLoadInPlay(String location, CBImpressionError error)

Другие делегированные методы

// Вызывается, если приложение регистрирует клик, но пользователь не перенаправлен в App Store.
public void didFailToRecordClick(String uri, CBClickError error)

// Вызывается после того, как успешно инициализирован SDK и завершено предварительное извлечение видео.
public void didInitialize()
{ Log.i("Chartboost, DID INITIALIZE! ")); }

Методы возрастной проверки

Методы проверки возраста для Android уже стали устаревшими.