Skip to content

Latest commit

 

History

History
492 lines (492 loc) · 50.4 KB

Advert.md

File metadata and controls

492 lines (492 loc) · 50.4 KB

Список методов в категории Advert:

ShowRewardAdChartboost

Описание

Создает полноэкранную видеорекламу вознаграждения для получения дохода с помощью Chartboost. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetChartboostDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае оно попытается загрузить объявление при следующем вызове этой команды. Для Chartboost вы должны запустить процесс кэширования вручную с помощью CacheRewardAdChartboost, вам нужно только вызвать его один раз. После показа видеорекламы с вознаграждением новая видеореклама будет автоматически кэширована. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetRewardAdLoadedChartboost. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено. Проверьте GetRewardAdRewardedChartboost, чтобы узнать, завершил ли пользователь просмотр объявления о вознаграждении и должен ли он быть вознагражден. Он будет установлен в 0, когда вы вызовете эту команду, а затем установлен в 1, когда они закончат просмотр

Определение

void agk::ShowRewardAdChartboost()

Параметры

Пример кода


ShowRewardAdAdMob

Описание

Создает полноэкранную видеорекламу вознаграждения для получения дохода с помощью AdMob. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetAdMobRewardAdDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае оно попытается загрузить объявление при следующем вызове этой команды. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetRewardAdLoadedAdMob. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено. Проверьте GetRewardAdRewardedAdMob, чтобы узнать, завершил ли пользователь просмотр объявления о вознаграждении и должен ли он быть вознагражден. Он будет установлен в 0, когда вы вызовете эту команду, а затем установлен в 1, когда они закончат просмотр

Определение

void agk::ShowRewardAdAdMob()

Параметры

Пример кода


ShowFullscreenAdvertAmazon

Описание

Создает полноэкранную (интерстициальную) рекламу для получения дохода с помощью Amazon Ads. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetAmazonAdDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае оно попытается загрузить объявление при следующем вызове этой команды. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetFullscreenAdvertLoadedAmazon. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено.

Определение

void agk::ShowFullscreenAdvertAmazon()

Параметры

Пример кода


ShowFullscreenAdvertChartboost

Описание

Создает полноэкранную (интерстициальную) рекламу для получения дохода с помощью Chartboost. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetChartboostDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае оно попытается загрузить объявление при следующем вызове этой команды. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetFullscreenAdvertLoadedChartboost. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено.

Определение

void agk::ShowFullscreenAdvertChartboost()

Параметры

Пример кода


ShowFullscreenAdvertAdMob

Описание

Создает полноэкранную (интерстициальную) рекламу для получения дохода с помощью AdMob. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetAdMobDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае оно попытается загрузить объявление при следующем вызове этой команды. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetFullscreenAdvertLoadedAdMob. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено.

Определение

void agk::ShowFullscreenAdvertAdMob()

Параметры

Пример кода


SetInneractiveDetails

Описание

Устанавливает данные вашей учетной записи Inneractive для использования CreateAdvert. Не все платформы поддерживают всех поставщиков рекламы, поэтому установка как можно большего количества реквизитов учетной записи позволит AGK выбрать подходящее объявление для этой платформы. В настоящее время Inneractive поддерживается iOS, Android, Windows и Mac.

Определение

void agk::SetInneractiveDetails( const char* szCode )

Параметры

szCode - Код вашей учетной записи предоставлен компанией Inneractive.

Пример кода


SetChartboostDetails

Описание

Устанавливает данные вашей учетной записи Chartboost для использования в интерстициальной (полноэкранной) рекламе и видеорекламе вознаграждений. После вызова этой команды будет предпринята попытка кэшировать интерстициал, чтобы вы могли сразу же отобразить его позже. Вы можете проверить ход выполнения этой задачи с помощью GetFullscreenAdvertLoadedChartboost. Обратите внимание, что эта команда не будет автоматически кэшировать видеорекламу с вознаграждением, вы должны сделать это вручную с помощью CacheRewardAdChartboost. Реклама Chartboost в настоящее время поддерживается Android и iOS.

Определение

void agk::SetChartboostDetails ( const char* szKey1, const char* szKey2 )

Параметры

szKey1 - Идентификатор приложения
szKey2 - Подпись приложения

Пример кода


SetAmazonAdTesting

Описание

Определяет, будут ли объявления Amazon тестовыми или платными. Это должно быть вызвано перед SetAmazonAdDetails, чтобы убедиться, что все объявления являются тестовыми. По умолчанию будет показываться платная реклама.

Определение

void agk::SetAmazonAdTesting ( int mode )

Параметры

mode - 0=показывать платную рекламу, 1=показывать тестовую рекламу

Пример кода


SetAmazonAdDetails

Описание

Устанавливает данные учетной записи Amazon Ads для использования в интерстициальной (полноэкранной) рекламе. После вызова этой команды будет предпринята попытка кэшировать интерстициал, чтобы вы могли сразу же отобразить его позже. Вы можете проверить ход этого процесса с помощью GetFullscreenAdvertLoadedAmazon. В настоящее время Amazon ads поддерживается iOS и Android.

Определение

void agk::SetAmazonAdDetails ( const char* szKey )

Параметры

szKey - Идентификатор рекламного блока, предоставленный Amazon.

Пример кода


SetAdvertVisible

Описание

Установите видимость любого объявления.

Определение

void agk::SetAdvertVisible ( int iVisible )

Параметры

iVisible - 1 покажет рекламу, а 0 скроет ее.

Пример кода


SetAdvertPosition

Описание

Размещает рекламу, созданную с помощью CreateAdvert, где-то на экране и пытается масштабировать ее до определенной ширины. Поскольку реклама будет иметь свое собственное соотношение сторон, высота будет рассчитываться исходя из ширины. Это не гарантирует работу со всеми поставщиками рекламы, в настоящее время только Inneractive может масштабировать и перемещать рекламу в абсолютное положение.

Определение

void agk::SetAdvertPosition( float x, float y, float width )

Параметры

x - Положение x в верхнем левом углу объявления
y - Положение y в верхнем левом углу объявления
width - Желаемая ширина объявления, она будет масштабирована до этой ширины

Пример кода


SetAdvertLocation

Описание

Размещает рекламу, созданную с помощью CreateAdvert, где-то на экране и пытается масштабировать ее до определенной ширины. Поскольку реклама будет иметь свое собственное соотношение сторон, высота будет рассчитываться исходя из ширины. Это обеспечивает грубое позиционирование, позволяя вам выбирать между левым, центрированным или правым выравниванием для горизонтального и вертикального положений. Это не гарантирует работу со всеми поставщиками рекламы, в настоящее время только Inneractive может масштабировать рекламу до определенной ширины.

Определение

void agk::SetAdvertLocation( int horz, int vert, float width )

Параметры

horz - Горизонтальное положение объявления, 0=слева, 1=в центре, 2=справа
vert - Вертикальное положение объявления, 0=верх, 1=центр, 2=низ
width - Желаемая ширина объявления, она будет масштабирована до этой ширины

Пример кода


SetAdMobRewardAdDetails

Описание

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

Определение

void agk::SetAdMobRewardAdDetails ( const char* szID )

Параметры

szID - Идентификатор рекламного блока, предоставленный AdMob (не идентификатор приложения).

Пример кода


SetAdvertLocationEx

Описание

Размещает рекламу, созданную с помощью CreateAdvert, где-то на экране и пытается масштабировать ее до определенной ширины. Поскольку реклама будет иметь свое собственное соотношение сторон, высота будет рассчитываться исходя из ширины. Это обеспечивает грубое позиционирование, позволяя вам выбирать между левым, центрированным или правым выравниванием для горизонтального и вертикального положений. Это не гарантирует работу со всеми поставщиками рекламы, в настоящее время только Inneractive может масштабировать рекламу до определенной ширины.

Определение

void agk::SetAdvertLocationEx( int horz, int vert, float offsetx, float offsety, float width )

Параметры

horz - Горизонтальное положение объявления: 0=слева, 1=в центре, 2=справа
vert - Вертикальное положение объявления, 0=верх, 1=центр, 2=низ
offsetx - когда horz равен 0 или 2 это значение смещает объявление от указанного края
offsety - когда vert равен 0 или 2 это значение смещает объявление от указанного края
width - Желаемая ширина объявления, она будет масштабирована до этой ширины

Пример кода


SetAdMobTesting

Описание

Определяет, будут ли объявления AdMob тестовыми или платными. Это должно быть вызвано перед SetAdMobDetails, чтобы убедиться, что все объявления являются тестовыми. По умолчанию будет показываться платная реклама. Обратите внимание, что если вы показываете платные объявления во время тестирования, вы не должны нажимать на них, иначе ваша учетная запись AdMob может быть приостановлена.

Определение

void agk::SetAdMobTesting ( int mode )

Параметры

mode - 0 = показывать платные объявления, 1 = показывать тестовые объявления

Пример кода


SetAdMobDetails

Описание

Устанавливает данные учетной записи AdMob для использования в баннерной рекламе и интерстициальной (полноэкранной) рекламе. Обратите внимание, что это поддерживает только одно или другое, вы можете установить либо ИДЕНТИФИКАТОР рекламного блока баннера, либо идентификатор интерстициального рекламного блока, но не оба одновременно. После вызова этой команды будет предпринята попытка кэшировать интерстициал, чтобы вы могли сразу же отобразить его позже. Вы можете проверить ход выполнения этой задачи с помощью GetFullscreenAdvertLoadedAdMob. Реклама AdMob в настоящее время поддерживается iOS и Android.

Определение

void agk::SetAdMobDetails ( const char* szID )

Параметры

szID - Идентификатор рекламного блока, предоставленный AdMob.

Пример кода


SetAdMobChildRating

Описание

Устанавливает рейтинг контента для рекламы AdMob, если ваше приложение ориентировано на детей. Это должно быть вызвано перед SetAdMobDetails

Определение

void agk::SetAdMobChildRating ( int rating )

Параметры

rating - 0 = нормальная реклама, 1 = безопасная для детей реклама

Пример кода


ResetRewardAdMob

Описание

Устанавливает значение вознаграждения AdMob равным 0. Вы можете использовать это после обнаружения события вознаграждения и действовать так, чтобы не вознаграждать пользователя более одного раза.

Определение

void agk::ResetRewardAdMob()

Параметры

Пример кода


ResetRewardChartboost

Описание

Устанавливает значение вознаграждения Chartboost равным 0. Вы можете использовать это после обнаружения события вознаграждения и действовать так, чтобы не вознаграждать пользователя более одного раза.

Определение

void agk::ResetRewardChartboost()

Параметры

Пример кода


RequestConsentAdMob

Описание

Отображает всплывающее диалоговое окно с запросом согласия пользователя на показ персонализированной рекламы. Ответ пользователя будет автоматически использован для изменения настроек AdMob таким образом, чтобы реклама отображалась в соответствии с предпочтениями пользователя. Статус согласия также будет сохранен на сервере AdMob, чтобы будущий вызов LoadConsentStatusAdMob мог получить это значение. Вы можете вызвать эту команду в любое время в вашем приложении, чтобы пользователь мог изменить свои предпочтения, пользователь должен иметь возможность сделать это где-то внутри вашего приложения. Это согласие не распространяется на Chartboost или Amazon, оно запрашивает только согласие на показ персонализированной рекламы от AdMob. Вам понадобится свой собственный метод запроса согласия для Chartboost и Amazon.

Определение

void agk::RequestConsentAdMob()

Параметры

Пример кода


RequestAdvertRefresh

Описание

Вызовите эту команду, чтобы запросить новое объявление. Обычно реклама предоставляется автоматически. Вы можете сделать это только при переключении на новые экраны в вашем приложении

Определение

void agk::RequestAdvertRefresh()

Параметры

Пример кода


OverrideConsentChartboost

Описание

Заставляет Chartboost использовать данное значение согласия при показе рекламы, по умолчанию AGK показывает неперсонализированные объявления из Chartboost. Эта команда может быть использована, если у вас есть собственный метод получения согласия пользователя на показ персонализированной рекламы. Обратите внимание, что GDPR требует от вас по закону получить согласие пользователей ЕС, прежде чем показывать им персонализированную рекламу.

Определение

void agk::OverrideConsentChartboost( int consent )

Параметры

consent - Значение согласия на использование, 1=неперсонализированное, 2=персонализированное

Пример кода


OverrideConsentAdMob

Описание

Если AdMob использует заданное значение согласия при показе рекламы, оно не сохраняется на сервере AdMob и переопределяет обычный процесс получения согласия. Это используется, если у вас есть собственный метод получения согласия пользователя на показ персонализированной рекламы. Обратите внимание, что GDPR требует от вас по закону получить согласие пользователей ЕС, прежде чем показывать им персонализированную рекламу.

Определение

void agk::OverrideConsentAdMob( int consent )

Параметры

consent - Значение согласия на использование, 1=неперсонализированное, 2=персонализированное

Пример кода


LoadConsentStatusAdMob

Описание

Загружает текущий статус согласия пользователя с сервера AdMob, это необходимо сделать перед вызовом RequestConsentAdMob. Вы должны дождаться, пока GetConsentStatusAdMob вернет неотрицательное значение, прежде чем использовать другие команды согласия AdMob.

Определение

void agk::LoadConsentStatusAdMob( const char* szPubID, const char* privacyPolicy )

Параметры

szPubID - Идентификатор издателя для вашей учетной записи AdMob
privacyPolicy - URL - адрес вашей политики конфиденциальности будет показан пользователю в виде ссылки в диалоговом окне согласия

Пример кода


GetRewardAdValueAdMob

Описание

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

Определение

int agk::GetRewardAdValueAdMob()

Параметры

Пример кода


GetRewardAdRewardedChartboost

Описание

Возвращает 1, если ранее показанное объявление о вознаграждении привело к вознаграждению, которое должно быть дано пользователю, например, некоторые внутриигровые монеты. При вызове ShowRewardAdAdMob это значение устанавливается равным 0 и устанавливается равным 1 только в том случае, если пользователь завершил бонусное видео, в противном случае оно останется равным 0. После того как вы дали пользователю вознаграждение, вы можете установить его обратно в 0 с помощью ResetRewardAdMob.

Определение

int agk::GetRewardAdRewardedChartboost()

Параметры

Пример кода


GetRewardAdLoadedChartboost

Описание

Возвращает 1, если есть предварительно загруженное и готовое к показу объявление Chartboost reward, в противном случае 0. Если это так, вы можете отобразить его с помощью ShowRewardAdChartboost. Объявления предварительно загружаются после вызова CacheRewardAdChartboost и после того, как каждое объявление о вознаграждении отклоняется пользователем. Если эта команда продолжает возвращать 0, то загрузка рекламы может быть неудачной из-за того, что у провайдера закончились объявления, и AGK прекратит попытки их загрузить. В этом случае вам следует обратиться к другим поставщикам рекламы. Если вы обнаружите, что все ваши поставщики рекламы возвращают 0, вы можете попробовать снова позвонить в CacheRewardAdChartboost, чтобы перезапустить процесс загрузки и посмотреть, стали ли доступны новые объявления.

Определение

int agk::GetRewardAdLoadedChartboost()

Параметры

Пример кода


GetRewardAdLoadedAdMob

Описание

Возвращает 1, если объявление AdMob reward предварительно загружено и готово к показу, в противном случае 0. Если это так, вы можете отобразить его с помощью ShowRewardAdAdMob. Объявления предварительно загружаются, как только вы устанавливаете свои данные о вознаграждении AdMob, и после того, как каждое объявление о вознаграждении отклоняется пользователем. Если эта команда продолжает возвращать 0, то загрузка рекламы может быть неудачной из-за того, что у провайдера закончились объявления, и AGK прекратит попытки их загрузить. В этом случае вам следует обратиться к другим поставщикам рекламы. Если вы обнаружите, что все ваши поставщики рекламы возвращают 0, то вы можете попробовать вызвать ShowRewardAdAdMob в любом случае, он ничего не покажет, так как ничего не загружено, но он перезапустит процесс загрузки, чтобы увидеть, стали ли доступны какие-либо новые объявления.

Определение

int agk::GetRewardAdLoadedAdMob()

Параметры

Пример кода


GetRewardAdRewardedAdMob

Описание

Возвращает 1, если ранее показанное объявление о вознаграждении привело к вознаграждению, которое должно быть дано пользователю, например, некоторые внутриигровые монеты. При вызове ShowRewardAdAdMob это значение устанавливается равным 0 и устанавливается равным 1 только в том случае, если пользователь завершил бонусное видео, в противном случае оно останется равным 0. После того как вы дали пользователю вознаграждение, вы можете установить его обратно в 0 с помощью ResetRewardAdMob.

Определение

int agk::GetRewardAdRewardedAdMob()

Параметры

Пример кода


GetFullscreenAdvertLoadedChartboost

Описание

Возвращает 1, если есть предварительно загруженное и готовое к показу интерстициальное объявление Chartboost, в противном случае 0. Если это так, вы можете отобразить его с помощью ShowFullscreenAdvertChartboost. Реклама предварительно загружается, как только вы устанавливаете свои данные Chartboost, и после того, как каждая полноэкранная реклама отклоняется пользователем. Если эта команда продолжает возвращать 0, то загрузка рекламы может быть неудачной из-за того, что у провайдера закончились объявления, и AGK прекратит попытки их загрузить. В этом случае вам следует обратиться к другим поставщикам рекламы. Если вы обнаружите, что все ваши поставщики рекламы возвращают 0, то вы можете попробовать вызвать ShowFullscreenAdvertChartboost в любом случае, он ничего не покажет, так как ничего не загружено, но он перезапустит процесс загрузки, чтобы увидеть, стали ли доступны какие-либо новые объявления.

Определение

int agk::GetFullscreenAdvertLoadedChartboost()

Параметры

Пример кода


GetFullscreenAdvertLoadedAmazon

Описание

Возвращает 1, если есть предварительно загруженная и готовая к показу реклама Amazon interstitial, в противном случае 0. Если это так, вы можете отобразить его с помощью ShowFullscreenAdvertAmazon. Реклама предварительно загружается, как только вы устанавливаете свои данные Amazon, и после того, как каждая полноэкранная реклама отклоняется пользователем. Если эта команда продолжает возвращать 0, то загрузка рекламы может быть неудачной из-за того, что у провайдера закончились объявления, и AGK прекратит попытки их загрузить. В этом случае вам следует обратиться к другим поставщикам рекламы. Если вы обнаружите, что все ваши поставщики рекламы возвращают 0, то вы можете попробовать вызвать ShowFullscreenAdvertAmazon в любом случае, он ничего не покажет, так как ничего не загружено, но он перезапустит процесс загрузки, чтобы увидеть, стали ли доступны какие-либо новые объявления.

Определение

int agk::GetFullscreenAdvertLoadedAmazon()

Параметры

Пример кода


GetFullscreenAdvertLoadedAdMob

Описание

Возвращает 1, если есть предварительно загруженное и готовое к показу интерстициальное объявление AdMob, в противном случае 0. Если это так, вы можете отобразить его с помощью ShowFullscreenAdvertAdMob. Объявления предварительно загружаются, как только вы устанавливаете свои данные AdMob, и после того, как каждая полноэкранная реклама отклоняется пользователем. Если эта команда продолжает возвращать 0, то загрузка рекламы может быть неудачной из-за того, что у провайдера закончились объявления, и AGK прекратит попытки их загрузить. В этом случае вам следует обратиться к другим поставщикам рекламы. Если вы обнаружите, что все ваши поставщики рекламы возвращают 0, то вы можете попробовать вызвать ShowFullscreenAdvertAdMob в любом случае, он ничего не покажет, так как ничего не загружено, но он перезапустит процесс загрузки, чтобы увидеть, стали ли доступны какие-либо новые объявления.

Определение

int agk::GetFullscreenAdvertLoadedAdMob()

Параметры

Пример кода


GetConsentStatusAdMob

Описание

Возвращает текущий статус согласия пользователя, он возвращает одно из следующих значений: -2 = LoadConsentStatusAdMob еще не был вызван, вы должны вызвать его, прежде чем продолжить -1 = LoadConsentStatusAdMob находится в процессе загрузки статуса согласия пользователя, пожалуйста, подождите 0 = Пользователь еще не был спрошен, AdMob ads по умолчанию не будет использовать личную информацию, вызовите RequestConsentAdMob, чтобы запросить согласие пользователя 1 = Пользователь отказался от согласия, любые показанные объявления AdMob не будут использовать личную информацию 2 = Пользователь дал согласие, любые показанные объявления AdMob будут использовать личную информацию

Определение

int agk::GetConsentStatusAdMob()

Параметры

Пример кода


DeleteAdvert

Описание

Очищает ранее показанное объявление.

Определение

void agk::DeleteAdvert()

Параметры

Пример кода


CreateFullscreenAdvert

Описание

Эта команда устарела, вместо нее следует использовать ShowFullscreenAdvertAdMob, ShowFullscreenAdvertChartboost или ShowFullscreenAdvertAmazon. Создает полноэкранную (интерстициальную) рекламу для получения дохода. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью одной из других команд, таких как SetAdMobDetails, SetChartboostDetails или SetAmazonAdDetails Не все платформы поддерживают всех поставщиков рекламы, поэтому установка как можно большего количества данных учетной записи позволит AGK выбрать подходящее объявление для этой платформы. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление было загружено при вызове этой команды, то оно будет отображаться немедленно, в противном случае эта команда ничего не сделает. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа для конкретного поставщика с помощью GetFullscreenAdvertLoadedAdMob, GetFullscreenAdvertLoadedChartboost или GetFullscreenAdvertLoadedAmazon. Ваше приложение будет приостановлено, когда появится объявление, и возобновится, когда оно будет отклонено.

Определение

void agk::CreateFullscreenAdvert()

Параметры

Пример кода


CreateAdvertEx

Описание

Создает рекламу для получения дохода. Перед вызовом этой функции вы должны задать данные своего рекламного аккаунта с помощью одной из других команд, таких как SetAdMobDetails. Не все платформы поддерживают всех поставщиков рекламы, поэтому установка как можно большего количества реквизитов учетной записи позволит AGK выбрать подходящее объявление для этой платформы. Эта реклама обычно представляет собой баннер размером 320х50, отображаемый где-то на краю вашего приложения. Создание объявления, когда оно уже существует, заменит существующее объявление. Это расширенная версия команды CreateAdvert, которая принимает необязательные значения смещения для позиционирования объявления. Параметр type можно использовать для выбора размера баннера: 0=Banner(320x50), 1=LargeBanner, 2=MediumRectangle, 3=FullBanner, 4=Leaderboard, 5=SmartBanner, 6=FluidBanner

Определение

void agk::CreateAdvertEx( int type, int horz, int vert, int test, float offsetx, float offsety )

Параметры

type - Размер создаваемого баннера
horz - Горизонтальное положение объявления: 0=слева, 1=в центре, 2=справа
vert - Вертикальное положение объявления, 0=верх, 1=центр, 2=низ
test - Установите значение 1, чтобы получить неоплачиваемое тестовое объявление, и 0, чтобы получить реальное объявление.
offsetx - когда horz равен 0 или 2 это значение смещает объявление от указанного края
offsety - когда vert равен 0 или 2 это значение смещает объявление от указанного края

Пример кода


CreateAdvert

Описание

Создает рекламу для получения дохода. Перед вызовом этой функции вы должны задать данные своего рекламного аккаунта с помощью одной из других команд, таких как SetAdMobDetails. Не все платформы поддерживают всех поставщиков рекламы, поэтому установка как можно большего количества реквизитов учетной записи позволит AGK выбрать подходящее объявление для этой платформы. Эта реклама обычно представляет собой баннер размером 320х50, отображаемый где-то на краю вашего приложения. Создание объявления, когда оно уже существует, заменит существующее объявление. Параметр type можно использовать для выбора размера баннера: 0=Banner(320x50), 1=LargeBanner, 2=MediumRectangle, 3=FullBanner, 4=Leaderboard, 5=SmartBanner, 6=FluidBanner

Определение

void agk::CreateAdvert( int type, int horz, int vert, int test )

Параметры

type - Размер создаваемого баннера
horz - Горизонтальное положение объявления, 0=слева, 1=в центре, 2=справа
vert - Вертикальное положение объявления, 0=верх, 1=центр, 2=низ
test - Установите значение 1, чтобы получить неоплачиваемое тестовое объявление, и 0, чтобы получить реальное объявление.

Пример кода


CacheRewardAdChartboost

Описание

Кэширует полноэкранную видеорекламу награды для последующего отображения с помощью Chartboost. Перед вызовом этой функции вы должны установить данные своего рекламного аккаунта с помощью SetChartboostDetails. И iOS, и Android используют кэширование для предварительной загрузки рекламы перед ее отображением. Если объявление уже было кэшировано, то это ничего не даст. В отличие от AdMob, reward videos не будет автоматически запускать кэширование с помощью Chartboost, если вы не вызовете эту команду. Это связано с тем, что Chartboost использует одни и те же детали как для интерстициальных, так и для наградных видео, поэтому AGK не может заранее знать, какие именно вы используете. Поскольку видеореклама может использовать много мобильных данных, процесс их кэширования не будет запущен автоматически. Вам нужно сделать это только один раз, после того как видеореклама с вознаграждением будет показана, новая будет автоматически кэширована. Сбой в загрузке объявления может быть вызван тем, что у рекламодателя закончились объявления для показа пользователям в определенной стране. Вы можете проверить, ждет ли объявление показа с помощью GetRewardAdLoadedChartboost.

Определение

void agk::CacheRewardAdChartboost()

Параметры

Пример кода