AdsGram

Русский

English
中文

Русский

English
中文

Appearance

Как интегрировать AdsGram? ​

Требования ​

Вставка скрипта ​

Чтобы подключить ваше Mini App к рекламной сети AdsGram, вставьте скрипт sad.min.js в тег <head> вашего HTML:

html
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>

Инициализация AdsGram SDK ​

Инициализируйте SDK, используя ваш blockId:

js
const AdController = window.Adsgram.init({ blockId: "your-block-id" });

Более подробная информация о методе init находится в разделе API Reference.

your-block-id — вы получите его в вашем аккаунте на  https://partner.adsgram.ai
Подробная инструкция о получении BlockId находится в разделе Получить blockId

Отображение рекламы ​

На данный момент доступны два формата:

Информация:

Ниже представлен пример кода для Rewarded формата. Этот пример также подходит для Interstitial формата. Единственное отличие: промис AdController.show() резолвится как для полностью просмотренных объявлений, так и для пропущенных. Простой пример кода вы можете найти здесь

В большинстве случаев код используется внутри обработчика события клика.
Для примеров на vanilla JS, React, Unity см. раздел Примеры кода.

js
AdController.show().then((result) => {
    // Пользователь просмотрел рекламу до конца или пропустил её в Interstitial формате
    // Ваш код для награждения пользователя
}).catch((result) => {
    // Произошла ошибка при показе рекламы
    // Ничего не делайте или обработайте ошибку
})
ts
AdController.show().then((result: ShowPromiseResult) => {
    // Пользователь просмотрел рекламу до конца или пропустил её в Interstitial формате
    // Ваш код для награждения пользователя
}).catch((result: ShowPromiseResult) => {
    // Произошла ошибка при показе рекламы
    // Ничего не делайте или обработайте ошибку
})

Типы результата result:

ts
interface ShowPromiseResult {
    done: boolean; // true, если пользователь досмотрел до конца или пропустил (Interstitial формат)
    description: string;  // описание события
    state: 'load' | 'render' | 'playing' | 'destroy'; // состояние баннера
    error: boolean; // true, если событие связано с ошибкой, иначе false
}

Информация:

Промис showPromise резолвится, если пользователь досмотрел рекламу до конца или пропустил её в Interstitial формате. В остальных случаях промис реджектится.

Совет:

Используйте finally, чтобы добавить дополнительные действия после завершения показа рекламы, её пропуска или возникновения ошибки.

Поздравляем! Вы только что показали свою первую рекламу, используя AdsGram.

Дополнительная информация ​