Интеграция с AnyAds — это простой процесс. Следуйте этой инструкции, чтобы подготовить вашу площадку к монетизации. Весь процесс займет не более 5-10 минут.
Сначала вам нужно создать аккаунт и добавить вашу площадку (бота) в систему.
@username вашего бота.API_KEY. Он будет выглядеть как anyads_....Выберите ваш язык и установите соответствующий пакет. Этот код является общим для обоих типов монетизации.
Установите пакет с поддержкой aiogram:
pip install "anyads[aiogram]"
В главном файле вашего бота добавьте базовую инициализацию:
import asyncio
import os
import logging
from aiogram import Bot, Dispatcher
# 1. Импортируем AnyAds и хелперы для aiogram
import anyads
from anyads.integrations import aiogram_handlers
# --- Конфигурация ---
ANYADS_API_KEY = os.getenv("ANYADS_API_KEY")
TELEGRAM_BOT_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
logging.basicConfig(level=logging.INFO)
# --- Инициализация ---
dp = Dispatcher()
bot = Bot(TELEGRAM_BOT_TOKEN)
# 2. Инициализируем SDK
sdk = anyads.init(api_key=ANYADS_API_KEY)
# 3. Регистрируем обработчик для верификации (обязательно!)
aiogram_handlers.register(dp)
Установите пакет из npm:
pnpm add @anyads/sdk telegraf
В главном файле вашего бота добавьте базовую инициализацию:
import { Telegraf } from 'telegraf';
import * as anyads from '@anyads/sdk';
import * as dotenv from 'dotenv';
dotenv.config();
// --- 1. Конфигурация ---
const ANYADS_API_KEY = process.env.ANYADS_API_KEY!;
const TELEGRAM_BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN!;
// --- 2. Инициализация ---
const bot = new Telegraf(TELEGRAM_BOT_TOKEN);
const sdk = anyads.init({ apiKey: ANYADS_API_KEY });
// --- 3. Регистрация обработчиков для верификации (обязательно!) ---
anyads.integrations.telegraf.registerAnyAdsHandlers(bot);
Теперь выберите, как именно вы хотите зарабатывать. Вы можете использовать оба способа одновременно.
Этот модуль работает в фоновом режиме. Вы просто регистрируете обработчик, и SDK будет вызывать его, когда появится задача на рассылку.
Добавьте этот код в ваш проект:
# Пример на Python
# Настраиваем интервал опроса (например, раз в 15 минут)
sdk.posts.configure(interval_seconds=900)
@sdk.posts.on_broadcast_received
async def handle_newsletter_task(task_data: dict):
logging.info(f"Получена задача на рассылку: {task_data}")
# ... здесь ваша логика рассылки по базе пользователей ...
Этот модуль позволяет вознаграждать пользователей за подписку на Telegram-каналы. Вы получаете оплату за каждого нового, уникального подписчика.
Выберите тип вашей площадки, чтобы увидеть инструкцию.
Наш SDK предоставляет готовый UI-хелпер, который автоматически показывает "стену подписок" пользователям при старте и обрабатывает проверку.
Добавьте этот код в ваш проект:
# Пример на Python (Aiogram)
from aiogram.filters import CommandStart
from anyads.integrations import aiogram_ui
# Что делать, если для пользователя нет заданий
async def show_welcome_message(message: types.Message):
await message.answer("Добро пожаловать!")
# Что делать после успешной подписки
async def show_main_menu(query: types.CallbackQuery):
await query.message.answer("Спасибо! Доступ предоставлен.")
# Регистрируем UI-обработчики, передавая наши функции-коллбэки
aiogram_ui.register_ui_handlers(dp, bot, on_success=show_main_menu)
@dp.message(CommandStart())
async def handle_start(message: types.Message, bot: Bot):
# Эта функция сделает всю работу по показу и проверке заданий
await aiogram_ui.handle_start_with_task(
message,
bot,
fallback_handler=show_welcome_message
)
Для более подробной информации обратитесь к полной документации по Python SDK или JS/TS SDK.
Вы можете интегрировать "стену офферов" в ваш Web App, используя наше простое REST API.
Отправьте GET запрос с вашего бэкенда, чтобы получить список доступных заданий для пользователя.
GET /v1/webapp/tasks?user_tid=<TELEGRAM_ID>curl -X GET 'https://api.anyads.online/v1/webapp/tasks?user_tid=12345' \
-H "Authorization: Bearer <ВАШ_API_KEY>"
Когда пользователь сообщает, что подписался, отправьте POST запрос для инициации проверки.
POST /v1/webapp/tasks/check{
"user_tid": 12345,
"channel_id": 1,
"campaign_id": 5
}
{ "success": true }
Для более подробной информации обратитесь к нашему API Reference.
Если ваша площадка — это Telegram Web App или веб-сайт, вы можете монетизировать ее с помощью баннерной рекламы.
Вставьте этот код в <head> вашего сайта, заменив ВАШ_API_KEY.
<!-- AnyAds Display Network Script -->
<script>
window.anyads = new AnyAdsClient('ВАШ_API_KEY');
</script>
<script async src="https://cdn.anyads.online/scripts/anyads.js"></script>
В том месте на странице, где вы хотите показать баннер, вставьте <div> с id нужного формата и вызовите метод anyads.show().
Доступные форматы: 300x250, 728x90, 320x50.
<!-- Пример для баннера 728x90 -->
<div id="anyads-728x90"></div>
<script>
anyads.show('anyads-728x90');
</script>
Для более подробной информации и примеров интеграции с React/Next.js, пожалуйста, обратитесь к полной документации по баннерной рекламе.
# Пример на Python
async def main():
await sdk.start()
await dp.start_polling(bot)
await sdk.stop()
После активации ваша интеграция полностью готова