Реализация Time-delayed Popup на сайте

Реализация Time-delayed Popup на сайте

Time-delayed popup — самый простой вид попапа: показывается через N секунд после загрузки страницы. Основной риск — показать слишком рано, когда пользователь ещё не успел понять контекст страницы. Пять-семь секунд — минимальный разумный порог для большинства сценариев.

Базовая реализация

// time-popup.ts
interface TimePopupConfig {
  delayMs: number;
  cooldownKey: string;         // ключ в localStorage
  cooldownMs?: number;         // 0 = показать один раз навсегда
  onShow: () => void;
}

export function schedulePopup(config: TimePopupConfig): () => void {
  const { delayMs, cooldownKey, cooldownMs, onShow } = config;

  // Проверяем, нужно ли показывать
  const lastShown = localStorage.getItem(cooldownKey);
  if (lastShown) {
    if (!cooldownMs) return () => {}; // показали один раз, больше не надо
    if (Date.now() - Number(lastShown) < cooldownMs) return () => {};
  }

  const timer = setTimeout(() => {
    // Дополнительная проверка: пользователь всё ещё на странице
    if (document.hidden) return;

    localStorage.setItem(cooldownKey, String(Date.now()));
    onShow();
  }, delayMs);

  return () => clearTimeout(timer);
}

Попап с несколькими вариантами контента (A/B)

// DelayedPopup.tsx
import { useEffect, useRef, useState } from 'react';
import { schedulePopup } from './time-popup';

type PopupVariant = 'discount' | 'lead-magnet' | 'callback';

const VARIANTS: Record<PopupVariant, {
  headline: string;
  body: string;
  cta: string;
}> = {
  discount: {
    headline: 'Скидка 10% на первый заказ',
    body: 'Введите email — пришлём промокод немедленно.',
    cta: 'Получить скидку',
  },
  'lead-magnet': {
    headline: 'Бесплатный чеклист',
    body: '15 пунктов, которые мы проверяем на каждом проекте.',
    cta: 'Скачать PDF',
  },
  callback: {
    headline: 'Остались вопросы?',
    body: 'Оставьте номер — перезвоним в течение 15 минут.',
    cta: 'Жду звонка',
  },
};

// Простой детерминированный A/B: делим по последней цифре даты
function pickVariant(): PopupVariant {
  const bucket = new Date().getDate() % 3;
  return (['discount', 'lead-magnet', 'callback'] as PopupVariant[])[bucket];
}

export function DelayedPopup() {
  const [open, setOpen] = useState(false);
  const [variant] = useState<PopupVariant>(pickVariant);
  const [value, setValue] = useState('');
  const [submitted, setSubmitted] = useState(false);
  const dialogRef = useRef<HTMLDialogElement>(null);

  useEffect(() => {
    const cleanup = schedulePopup({
      delayMs: 7000,
      cooldownKey: 'delayed_popup_v2',
      cooldownMs: 3 * 24 * 60 * 60 * 1000, // раз в 3 дня
      onShow: () => {
        setOpen(true);
        // трекинг показа
        window.gtag?.('event', 'popup_shown', {
          popup_variant: variant,
          page_path: location.pathname,
        });
      },
    });
    return cleanup;
  }, [variant]);

  useEffect(() => {
    if (open) {
      dialogRef.current?.showModal();
    } else {
      dialogRef.current?.close();
    }
  }, [open]);

  async function handleSubmit() {
    if (!value.trim()) return;

    await fetch('/api/popup-lead', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        value,
        variant,
        source: 'time_delayed_popup',
        pageUrl: location.href,
      }),
    });

    window.gtag?.('event', 'popup_converted', { popup_variant: variant });
    setSubmitted(true);
    setTimeout(() => setOpen(false), 2500);
  }

  const content = VARIANTS[variant];
  const inputType = variant === 'callback' ? 'tel' : 'email';
  const placeholder = variant === 'callback' ? '+7 (999) 000-00-00' : '[email protected]';

  return (
    <dialog
      ref={dialogRef}
      onClose={() => setOpen(false)}
      className="max-w-sm w-full rounded-2xl p-0 shadow-2xl backdrop:bg-black/50 animate-in fade-in slide-in-from-bottom-4"
    >
      <div className="relative p-7">
        <button
          onClick={() => setOpen(false)}
          aria-label="Закрыть"
          className="absolute top-3 right-3 w-7 h-7 flex items-center justify-center rounded-full hover:bg-gray-100 text-gray-400"
        >
          ✕
        </button>

        {submitted ? (
          <div className="py-4 text-center">
            <div className="text-3xl mb-2">✅</div>
            <p className="font-semibold text-gray-800">Готово, ждите!</p>
          </div>
        ) : (
          <>
            <h2 className="text-xl font-bold text-gray-900 mb-1">{content.headline}</h2>
            <p className="text-sm text-gray-500 mb-5">{content.body}</p>

            <div className="flex gap-2">
              <input
                type={inputType}
                value={value}
                onChange={e => setValue(e.target.value)}
                onKeyDown={e => e.key === 'Enter' && handleSubmit()}
                placeholder={placeholder}
                autoFocus
                className="flex-1 border border-gray-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
              />
              <button
                onClick={handleSubmit}
                className="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium rounded-lg whitespace-nowrap"
              >
                {content.cta}
              </button>
            </div>

            <p className="mt-3 text-xs text-gray-400">
              Не будем беспокоить чаще одного раза в неделю
            </p>
          </>
        )}
      </div>
    </dialog>
  );
}

Ключевые детали

Проверка document.hidden перед показом важна: пользователь мог открыть вкладку и сразу переключиться на другую. Таймер отсчитается, но показывать попап неактивной вкладке бессмысленно.

Ключ cooldown в localStorage должен версионироваться. При изменении содержимого попапа меняйте ключ (delayed_popup_v2 → delayed_popup_v3), чтобы пользователи, уже видевшие старую версию, увидели новую.

<dialog> с нативным showModal() даёт автоматический focus trap и закрытие по Escape без дополнительного кода. Использовать div с ручным управлением фокусом — лишняя работа.

Сроки

Один день включая A/B-разметку, трекинг и localStorage-логику.