Установка и настройка аддона

Руководство по Интеграции.

Версия релиза 1.1.0 | Дата релиза 07.07.2025

Минимальные требования:

Используйте Construct r368.2 и выше.
Используйте Android API level 22 (Android OS 5.1) и выше.
Используйте iOS 13.0 и выше.
Используйте Xсode 13 и выше.

Демо-приложение

Используйте наше демо-приложение в качестве примера.

GitHub - YabbiSDKTeam/yabbi-construct3-demoGitHub

Установка

Общее описание процесса установки

Для установки Construct3 Addon вам потребуется:

Ознакомиться с демо-приложением.
Скачать и импортировать в проект последнюю версию аддона.
Проверить корректность установки с помощью инициализации SDK с включенным режимом отладки.
(необязательно) Если вы используете медиацию (работу с другими рекламными сетями через рекламную Yabbi), вам потребуется скачать и импортировать последнюю версию аддона для подключения медиации. Установка и настройка аддона для медиации описана в соответствующем разделе.

Скачайте аддон

Скачайте последнюю версию аддона по ссылке.
Откройте Menu -> View -> Addon manager.

В открывшемся меню нажмите кнопку Install new addon..., выберите аддон Yabbi, который вы скачали в пункте 1.

Нажмите Install.

Перезагрузите редактор Construct3. Если Yabbi SDK установился корректно - он появится в Addon Manager.

Перейдите в ваш проект.
Нажмите на макете ПКМ, в открывшемся меню выберите Insert new object.

Выберите из списка Yabbi, нажмите кнопку Insert.

Сохраните проект.

Проверка установки

Чтобы убедиться, что SDK установлена корректно, потребуется включить режим отладки, и инициализировать SDK.

Режим отладки

В режиме отладки SDK логирует ошибки и события. По умолчанию выключен.

Для включения режима отладки используйте действие EnableDebug.

Инициализация

Откройте список событий, нажмите кнопку Add event.

Выберите System -> On start of layout.

Нажмите Add Action -> Выберите Yabbi -> Initialize.

Введите в кавычках ваш publisher_id. Ваш publisher_id вы сможете скопировать в разделе "Настройки" в личном кабинете Yabbi.

Запустите приложение в редакторе Construct3 и откройте консоль браузера (открывается на F12).

Если SDK установлена корректно, то вы увидите в консоли браузера следующее сообщение.

Call Initialize. Launch app in any platform to see result

Сообщениие сигнализирует что SDK установлено правильно, но показ рекламы возможен только после сборки приложения под Android/iOS.

Вы можете дополнительно отслеживать статус инициалиазции аддона, для этого установите события OnInitializedSuccess и OnInitializedFailed.

Готово! SDK установлена, можем переходить к настройке рекламы.

Рекомендуем вам не отключать режим отладки до завершения работы с рекламой.

Если SDK устанавливается некорректно

В случае возникновения ошибок рекомендуем очистить кеш браузера.

Если это не помогло, попробуйте установить SDK в чистый проект. Если SDK установилась корректно, попробуйте отладить ошибки в вашем проекте.

Также рекомендуем взглянуть на установку и инициализацию в демо-приложении.

Если у вас не получается корректно установить SDK, и действия выше не привели к успешной инициализации — обратитесь в поддержку.

Установка и настройка аддона для медиации

Если вы используете медиацию (работу с другими рекламными сетями через рекламную Yabbi), вам потребуется скачать и импортировать последнюю версию аддона для подключения медиации. Установка и настройка аддона для медиации описана в соответствующем разделе.

Пожалуйста, сделайте это до внедрения рекламы в логику вашего приложения.

Дополнительные действия для повышения дохода

Установка Apple ID

Для более эффективного работы таргетированной рекламы и повышения дохода Yabbi SDK собирает и передаёт с данными о пользователе App ID - уникальный числовой идентификатор приложения из Apple AppStore.

Он определяется автоматически, но в некоторых случаях Yabbi SDK не может его определить.

Если Yabbi SDK не определил ваш App ID, то вы увидите в консоли следующее сообщение.

AppStore ID is nil. You must set AppStore ID manually.

В таком случае вам необходимо установить ID вручную.

Для установки Apple ID используйте действие SetCustomParams

Установите в Key значение appStoreAppID.

Установите в Value ваш App ID из кабинета разработчика AppStore. Вы можете найти его на странице приложения в кабинете разработчика.

Рекламный идентификато Apple (IDFA)

Вам понадобится экспортировать приложение в проект на Cordova. Подробнее вы можете прочитать по этой ссылке.

Для более эффективного работы таргетированной рекламы и повышения дохода вы можете собирать рекламный идентификатор пользователя устройств Apple и передавать их в Yabbi SDK.

Чтобы включить сбор IDFA, вставьте следующий код в файл config.xml вашего приложения:

<?xml version='1.0' encoding='utf-8'?>
<widget id="your.app.id" version="1.0.0" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
   <!-- ... other settings -->
   
    <platform name="ios">
        <config-file target="*-Info.plist" parent="NSUserTrackingUsageDescription">
            <string>We need this permission for better ad targetting</string>
        </config-file>
    </platform>
</widget>

Сбор данных о геолокации

Вам понадобится экспортировать приложение в проект на Cordova. Подробнее вы можете прочитать по этой ссылке.

Для более эффективного работы таргетированной рекламы и повышения дохода вы можете собирать в приложении данные о точной и/или примерной геолокации пользователя, и передавать их в Yabbi SDK.

По умолчанию разрешения на геолокацию включены в Android SDK.

Если вы не хотите предоставлять данные о геолокации, вставьте следующий код в файл config.xml вашего приложения:

<?xml version='1.0' encoding='utf-8'?>
<widget id="your.app.id" version="1.0.0" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
   <!-- ... other settings -->
   
    <platform name="android">
    
        <!-- ... other settings -->
        
        <!-- Нужно обязательно добавить эту строку -->
        <edit-config file="app/src/main/AndroidManifest.xml" target="/manifest" mode="merge">
            <manifest xmlns:tools="http://schemas.android.com/tools" />
        </edit-config>
        
        <!-- Разрешение для сбора приблизительной геолокации пользователя -->
        <config-file target="app/src/main/AndroidManifest.xml" parent="/*">
            <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" tools:node="remove" />
        </config-file>
        
        <!-- Разрешение для сбора приблизительной геолокации пользователя -->
        <config-file target="app/src/main/AndroidManifest.xml" parent="/*">
            <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" tools:node="remove" />
        </config-file>
    </platform>
</widget>

Чтобы включить сбор данных о геолокации на iOS, вставьте следующий код в файл config.xml вашего приложения:

<?xml version='1.0' encoding='utf-8'?>
<widget id="your.app.id" version="1.0.0" xmlns:tools="http://schemas.android.com/tools" xmlns:android="http://schemas.android.com/apk/res/android" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
   <!-- ... other settings -->
   
    <platform name="ios">
        <config-file target="*-Info.plist" parent="NSLocationWhenInUseUsageDescription">
            <string>We need this permission for better ad targetting</string>
        </config-file>
    </platform>
</widget>

PreviousConstruct3 Addon NextРабота с рекламой

Last updated 2 days ago

Was this helpful?