Advertisement — различия между версиями

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск
(новые)
(Параметры)
Строка 17: Строка 17:
 
*'''события''' (''events'') - Количество событий, после которого показывается реклама
 
*'''события''' (''events'') - Количество событий, после которого показывается реклама
  
*'''таймаут''' (''timeout'') -  
+
*'''таймаут''' (''timeout'') - Время в мс. Если за указанное время не будет получен ответ от провайдера рекламы - появится сообщение об ошибке
  
 
*'''место в опциях''' - Имя группы параметров которой содержатся параметры объекта
 
*'''место в опциях''' - Имя группы параметров которой содержатся параметры объекта

Версия 13:32, 24 июля 2014

Объект ad позволяет отображать банеры банерных систем. Объект должен находиться на экране на котором необходимо показать банер, объект-провайдер рекламы может находиться на другом экране, но в области видимости объекта.

Параметры

новые

  • тип экрана (scrType) - тип банера, more games или ad. MoreGames=0,Ad=1
  • дни (days) - Количество дней с первого запуска
  • запуски (launches) - Количество запусков
  • время сессии (sesTm) - Время сессии (мс). 0 - показывать мгновенно, -1 - не показывать по времени сессии.
  • часы (hours) - Время между показами
  • события (events) - Количество событий, после которого показывается реклама
  • таймаут (timeout) - Время в мс. Если за указанное время не будет получен ответ от провайдера рекламы - появится сообщение об ошибке
  • место в опциях - Имя группы параметров которой содержатся параметры объекта
  • тестовый режим - значения параметров дни, время сессии, часы будут отсчитываться в минутах, то есть например вместо 10 дней - 10 минут

группа дополнительные данные

  • тип рекламы - полноэкранный, банер сверху, банер снизу. fullscreen=0,banner top=1, banner bottom=2
  • имя рекламы - ключ банера рекламы (ad)
  • имя more games - ключ банера more games

группа провайдер рекламы

  • объект - Объект, обладающий рекламной функциональностью.

Если добавлено несколько объектов обладающих рекламной функциональностью будет выбираться один из них равновероятностно.

Объект сам показывает рекламу если выполняются условия(текущее значение больше либо равно заданному). Условия дни, запуски, время сессии, часы проверяются через логическое "и", то есть все 4 должны выполняться одновременно. события и временные условия проверяются через логическое "или". То есть банер покажется когда или выполняются временные условия, или когда количество событий совпадает с заданным значением или больше. После показа банера при совпадении количества событий - счётчик событий сбрасывается.

Показ рекламы можно включать и отключать через параметр ad в объекте типа Options

старые

  • тип(adtype) - тип банерной системы(flurry, amazon, chartboost)
  • space(adspace) - имя рекламной кампании для flurry. Это имя будет отображаться в списке рекламных кампаний на портале flurry.
  • size(adsize) - размер и положение банера(top - 1, bottom - 2, fullscreen - 3)

Состояния

  • show - показать рекламу
  • hide - спрятать рекламу
  • event - увеличить счётчик событий на 1

Настройки для flurry

Должны быть указаны тип, space, size.

Также в app.icf или viewer.xml должен быть указан flurry id приложения, согласно ему идет работа банерной системы.

Кроме этого в итоговый AndroidManifest.xml должны быть добавлены следующие строки:


<activity android:name="com.flurry.android.FlurryFullscreenTakeoverActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode" 
    android:hardwareAccelerated="true" >
</activity>

Также должно быть следующее разрешение:


<uses-permission android:name="android.permission.INTERNET"/>

Настройки Amazon

Для работы рекламы от Amazon должен быть указан соответствующий тип рекламы, а также указаны следующие настройки в app.icf:


[s3eAmazonAds]
app_key="sample-app-v1_pub-2"
logging=1
testing=1

app_key - ключ для рекламы

logging - вести логи показа, полезно для отладки

testing - режим тестирования

По умолчанию logging и testing равны 1, поэтому при релизе значение обоих параметров необходимо принудительно устанавливать в 0.

В итоговый AndroidManifest.xml должны быть добавлены следующие строки:


<activity android:name="com.amazon.device.ads.MraidBrowser" android:configChanges="keyboardHidden|orientation"/>
<activity android:name="com.amazon.device.ads.VideoActionHandler" android:configChanges="keyboardHidden|orientation|screenSize"/>

(с вьювера версии от 10.07.2014 должны быть следующие строки:

<activity android:name="com.amazon.device.ads.AdActivity" android:configChanges="keyboardHidden|orientation|screenSize"/>

)

Также должны быть следующие разрешения:


<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

более подробно про рекламу от amazon: https://developer.amazon.com/sdk/mobileads/quick-start.html

Настройки ChartBoost

Для работы Chartboost на ios необходима версия ос не ниже 6-й

настройки в app.icf:

[ISCHARTBOOST]
DisableChartboost = 0
AndroidAppID = ""
AndroidAppSecret = ""
IOSAppID  = ""
IOSAppSecret = ""

DisableChartboost = 0 - использовать, 1 - не использовать, должно стоять по умолчанию.


Дополнительные сведения

  • AndroidManifest.xml находится обычно в каталоге %s3e_dir%\deploy\plugins\android
  • Также можно вместо AndroidManifest.xml вносить соответствующие настройки в android-extra-application-manifest.xml и android-extra-manifest.xml, которые находятся в каталоге

%каталог_редактора%\system\marmalade\conf\%марект%(к примеру android)

  • Объект при загрузке экрана не переводится автоматически в состояние show, в это состояние его надо переводить машиной или другим объектом.
  • Если выбран режим банера fullscreen, то при показе банера все действия в приложении "ставятся на паузу", возврат в игру возможен только при закрытии банера, если выбран другой режим отображения - приложение во время показа "на паузу" не ставится, то есть все действия продолжают выполняться.
  • Для работы Chartboost на ios необходима версия ос не ниже 6-й