Web (JS/TS)

Version 1.2.6

1. Install npm package

npm i taddy-sdk-web

or include Taddy as script

<!-- latest V1 version -->
<script src="https://cdn.taddy.pro/taddy-sdk-web@1/dist/taddy.min.js"></script>

<!-- specified version -->
<script src="https://cdn.taddy.pro/taddy-sdk-web@1.2.6/dist/taddy.min.js"></script>

1. Import taddy

import { TaddyWeb } from 'taddy-sdk-web'

1. Initialize taddy

const taddy = new TaddyWeb('miniapp-xxxxxxxxxxxx');

// or
const taddy = new window.TaddyWeb('miniapp-xxxxxxxxxxxx');

1. Send "ready" event when app is loaded

taddy.ready()

Exchange

1. Get exchange service

const exchange = taddy.exchange();

1. Fetch exchange feed

exchange.feed({
    limit: 8,              // default: 4
    imageFormat: 'png',    // default: webp
    autoImpressions: true, // impressions event will be called
}).then((items) => {
    // render(items)
});

1. Send impressions (manual)

exchange.impressions(items);

1. Open item via Telegram (item click handler)

exchange.open(item).then(() => {
    // exchange completed! 
    // reward user, remove task from list, etc...
}).catch(() => {
    // exchange is not completed! 
});

1. Send custom event ...

Ads

1. Получаем рекламный сервис Taddy

const ads = taddy.ads();

// или можем обращаться напрямую без создания переменной
taddy.ads()

1. Выполняем загрузку и показ рекламного объявления interstitial

ads.interstitial({
    // можем добавить обработчик закрытия объявления
    onClosed: () => console.log('Объявление закрыто'),
    onViewThrough: (id: string) => console.log('Объявление просмотрено', id);
}).then((success: boolean) => {
    // success содержит признак того, что объявление было показано
};

// Минимальный код
ads.interstitial();
// или
taddy.ads().interstitial();