{"id":478273,"date":"2026-05-02T03:58:04","date_gmt":"2026-05-02T03:58:04","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=478273"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=478273","title":{"rendered":"\u041e\u0442\u043a\u0443\u0434\u0430 \u043f\u0440\u0438\u0448\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438: first-touch attribution \u0434\u043b\u044f NestJS + React + Telegram Mini App \u0432 100 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430"},"content":{"rendered":"
\n

\u0411\u0435\u0437 \u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0445 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a, \u043e\u0434\u043d\u043e\u0439 \u043a\u043e\u043b\u043e\u043d\u043a\u043e\u0439 \u0432 \u0411\u0414, \u0434\u043b\u044f \u0441\u043e\u043b\u043e-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u043a\u043e\u0442\u043e\u0440\u043e\u043c\u0443 \u043d\u0430\u0434\u043e \u0443\u0437\u043d\u0430\u0442\u044c \u0447\u0442\u043e \u0443 \u043d\u0435\u0433\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442.<\/h2>\n

\u042f \u0434\u0435\u043b\u0430\u044e \u0433\u043e\u043b\u043e\u0441\u043e\u0432\u043e\u0439 AI-\u0440\u0435\u043f\u0435\u0442\u0438\u0442\u043e\u0440 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0433\u043e. \u041f\u0440\u043e\u0434\u0443\u043a\u0442 \u0436\u0438\u0432\u0451\u0442 \u0432 \u0442\u0440\u0451\u0445 \u043c\u0435\u0441\u0442\u0430\u0445:
\u0432\u0435\u0431-\u0441\u0430\u0439\u0442 speakwithai.pro<\/a>, Telegram Mini App \u0438 Android-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0432 RuStore. \u0423 \u043c\u0435\u043d\u044f \u043e\u0434\u043d\u0430 \u0438 \u0442\u0430 \u0436\u0435 \u0431\u0430\u0437\u0430 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u043d\u0430 NestJS + Postgres, \u0438 \u043c\u043d\u0435 \u043e\u0447\u0435\u043d\u044c \u043d\u0443\u0436\u0435\u043d \u043e\u0442\u0432\u0435\u0442 \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441: \u043e\u0442\u043a\u0443\u0434\u0430 \u0432\u043e\u043e\u0431\u0449\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u044f\u0442 \u043b\u044e\u0434\u0438?<\/p>\n

Yandex.Metrika \u0438 Google Analytics \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u044e\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u0430\u0439\u0442. Telegram Mini App \u0434\u043b\u044f \u043d\u0438\u0445 \u2014 \u0447\u0451\u0440\u043d\u044b\u0439 \u044f\u0449\u0438\u043a. Android-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0447\u0435\u0440\u0435\u0437 WebView \u2014 \u0442\u043e\u0436\u0435. \u0418\u0437 6000
\u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u043e\u0432 \u0441\u0442\u0430\u0442\u044c\u0438 \u043d\u0430 Habr \u044f \u043d\u0435 \u043c\u043e\u0433 \u0441\u043a\u0430\u0437\u0430\u0442\u044c, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043e\u0442\u0442\u0443\u0434\u0430 \u043f\u0440\u0438\u0448\u043b\u043e \u0432 \u043f\u0440\u043e\u0434\u0443\u043a\u0442, \u0438 \u0447\u0435\u0440\u0435\u0437 \u043a\u0430\u043a\u043e\u0439 \u043a\u0430\u043d\u0430\u043b (TG, \u0432\u0435\u0431, app).<\/p>\n

\u042f \u043d\u0435 \u0445\u043e\u0442\u0435\u043b \u0442\u0430\u0449\u0438\u0442\u044c \u0431\u043e\u043b\u044c\u0448\u0443\u044e CDP \u0432\u0440\u043e\u0434\u0435 Mixpanel \u0438\u043b\u0438 Amplitude \u2014 \u0434\u043b\u044f
\u0441\u043e\u043b\u043e-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u044d\u0442\u043e overkill. \u0412\u0435\u0447\u0435\u0440\u043e\u043c \u0441\u0435\u043b \u0438 \u0441\u0434\u0435\u043b\u0430\u043b simplest-thing-that-could-possibly-work: \u043e\u0434\u043d\u0430 \u043a\u043e\u043b\u043e\u043d\u043a\u0430 \u0432 \u0411\u0414, \u043f\u0430\u0440\u0441\u0438\u0442\u0441\u044f \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0432\u0438\u0437\u0438\u0442\u0435, \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438. 100 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430. \u0414\u0435\u043b\u044e\u0441\u044c.<\/p>\n

\u0415\u0441\u043b\u0438 \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043d\u0430 \u0441\u0430\u043c \u043f\u0440\u043e\u0434\u0443\u043a\u0442 \u2014 \u043e\u043d \u0436\u0438\u0432\u0451\u0442 \u0437\u0434\u0435\u0441\u044c:
\ud83e\udd16 Telegram-\u0431\u043e\u0442<\/a>
\ud83c\udf10 \u0412\u0435\u0431-\u0432\u0435\u0440\u0441\u0438\u044f<\/a>
\ud83d\udcf1 Android \u0432 RuStore<\/a><\/p>\n\n

\u0427\u0442\u043e \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043d\u0430 \u0432\u044b\u0445\u043e\u0434\u0435<\/p>\n

\u041e\u0434\u0438\u043d SQL-\u0437\u0430\u043f\u0440\u043e\u0441:<\/p>\n

SELECT acquisition_source, COUNT(*)                                             FROM <your_users_table>  WHERE created_at > NOW() - INTERVAL '7 days'                                    GROUP BY 1                                ORDER BY 2 DESC;<\/code>
<\/a><\/div><\/pre>\n
\u0421 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u043c:<\/p>\n
acquisition_source                         | count ———————————
 NULL                                             | 47
 tg:habr_attr_top                             | 8<\/p>\n
 tg:habr_attr_end                            | 12
 web:habr\/attribution_post\/top        | 4
 web:vc\/growth_post\/top                 | 3<\/p>\n
\u0422\u043e \u0435\u0441\u0442\u044c \u043a\u043e\u043b\u043e\u043d\u043a\u0430 acquisition_source \u0441\u043e \u0441\u0442\u0440\u043e\u043a\u043e\u0439 \u0444\u043e\u0440\u043c\u0430\u0442\u0430 :\/\/ \u2014 \u0438 \u0432\u0441\u0451. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 join\u2019\u043e\u0432, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u0442\u0430\u0431\u043b\u0438\u0446 \u0441\u043e\u0431\u044b\u0442\u0438\u0439. \u0415\u0441\u043b\u0438 \u043a\u0430\u043a\u043e\u0439-\u0442\u043e \u043a\u0430\u043d\u0430\u043b \u0434\u0430\u0451\u0442 0 \u2014 \u043e\u043d \u044f\u0432\u043d\u043e \u043c\u0451\u0440\u0442\u0432. \u0415\u0441\u043b\u0438 \u0434\u0440\u0443\u0433\u043e\u0439 \u0434\u0430\u0451\u0442 12 \u2014 \u0434\u0432\u043e\u0439\u0442\u0435 \u0431\u044e\u0434\u0436\u0435\u0442 \u0442\u0443\u0434\u0430.<\/p>\n
\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430<\/h2>\n
[Web] \u2500\u2500\u2500 UTM \u0438\u0437 URL \u2192 localStorage \u2192 POST \/auth\/register \u0441 source \u2500\u2510<\/p>\n
 [TG Mini App] \u2500\u2500 start_param \u0438\u0437 initData \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2192
 users.acquisition_source
 [Capacitor (web bundle)] \u2500\u2500 \u043e\u0431\u0435 \u0432\u0435\u0442\u043a\u0438 \u0432\u044b\u0448\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442 \u043a\u0430\u043a \u0435\u0441\u0442\u044c \u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n
Capacitor \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u043b\u043e\u0433\u0438\u043a\u0438 \u043d\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u2014 \u043e\u043d \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u0442\u043e\u0442 \u0436\u0435 React-\u0431\u0430\u043d\u0434\u043b \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0440\u0435\u0435\u0441\u0442-\u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442. \u042d\u0442\u043e \u0438 \u0445\u043e\u0440\u043e\u0448\u043e: \u043f\u0438\u0448\u0435\u043c \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043d\u0430 \u0442\u0440\u0451\u0445 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0430\u0445.<\/p>\n
\u0427\u0430\u0441\u0442\u044c 1. \u0412\u0435\u0431: \u043b\u043e\u0432\u0438\u043c UTM<\/h2>\n
\u041f\u043e\u0434\u0445\u043e\u0434 \u2014 first-touch: \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u043c UTM \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0432\u0438\u0437\u0438\u0442\u0435, \u043d\u0435 \u043f\u0435\u0440\u0435\u0442\u0438\u0440\u0430\u0435\u043c \u043f\u0440\u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0445. \u042d\u0442\u043e \u0434\u0430\u0451\u0442 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u0443\u044e \u043a\u0430\u0440\u0442\u0438\u043d\u0443 \u00ab\u0433\u0434\u0435 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043d\u0430\u0448\u0451\u043b \u043d\u0430\u0441 \u0438\u0437\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u043e\u00bb. \u0412\u0430\u0440\u0438\u0430\u043d\u0442 last-touch (\u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437) \u0442\u043e\u0436\u0435 \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b, \u043d\u043e \u043e\u043d \u0443 \u043c\u0435\u043d\u044f \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 Yandex.Metrika \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438, \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0435 \u043d\u0443\u0436\u043d\u043e.<\/p>\n
Helper, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u043d\u0430 \u0441\u0442\u0430\u0440\u0442\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f:<\/p>\n
\/\/ apps\/web\/src\/lib\/acquisitionSource.ts      const STORAGE_KEY = 'speakwithai.acquisition_source';  const MAX_LEN = 128;                                                                                                          function buildSourceString(params: URLSearchParams): string | null {    \/\/ Telegram Mini App \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 (fallback) \u2014 \u043f\u0438\u0448\u0435\u043c \u043a\u0430\u043a tg:                      const tgStart = params.get('tgWebAppStartParam');                               if (tgStart) return `tg:${tgStart}`.slice(0, MAX_LEN);                                                                                                          \/\/ \u041e\u0431\u044b\u0447\u043d\u044b\u0439 \u0432\u0435\u0431 \u2014 UTM                                                            const utmSource = params.get('utm_source');                                     if (!utmSource) return null;                                                                                                                                    const parts = [                                                                   utmSource,        params.get('utm_campaign') ?? '',                                               params.get('utm_content') ?? '',            ];                                                                              while (parts.length > 1 && parts[parts.length - 1] === '') parts.pop();    return `web:${parts.join('\/')}`.slice(0, MAX_LEN);                            }                                                                                                                         export function captureAndStoreSource(): void {                                   try {                                       if (localStorage.getItem(STORAGE_KEY)) return; \/\/ first-touch                   const source = buildSourceString(                                                 new URLSearchParams(window.location.search),      );                                                                              if (source) localStorage.setItem(STORAGE_KEY, source);                        } catch {                                       \/\/ localStorage \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u043e\u0442\u043a\u043b\u044e\u0447\u0451\u043d (Safari private) \u2014 \u043f\u0440\u043e\u043f\u0443\u0441\u043a\u0430\u0435\u043c             }                                           }                                                                                  export function getStoredSource(): string | null {                                try {               return localStorage.getItem(STORAGE_KEY);                                     } catch {                                       return null;                            }  }    <\/code>
<\/a><\/div><\/pre>\n
\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c \u0432 main.tsx \u0434\u043e \u0440\u0435\u043d\u0434\u0435\u0440\u0430 React, \u0447\u0442\u043e\u0431\u044b \u0443\u0441\u043f\u0435\u0442\u044c \u0437\u0430\u0445\u0432\u0430\u0442\u0438\u0442\u044c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043d\u0435 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u044d\u0442\u043e\u0439 \u0441\u0435\u0441\u0441\u0438\u0438:<\/p>\n
\/\/ apps\/web\/src\/main.tsx                                                        import { captureAndStoreSource } from '.\/lib\/acquisitionSource';                                                                                  captureAndStoreSource();                  createRoot(document.getElementById('root')!).render(<App \/>);                                                             \u0414\u0430\u043b\u044c\u0448\u0435 \u043f\u0440\u0438 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u043f\u043e\u043b\u0435 source \u0432 DTO:                                                                                                             const { accessToken } = await registerApi({    name,                                                                           email,                                        password,                                                                       agreementsVersion: AGREEMENTS_VERSION,    source: getStoredSource() ?? undefined,                                       });     <\/code>
<\/a><\/div><\/pre>\n
\u0427\u0430\u0441\u0442\u044c 2. Backend: \u043a\u043e\u043b\u043e\u043d\u043a\u0430 \u0438 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f<\/h2>\n
\u041c\u0438\u0433\u0440\u0430\u0446\u0438\u044f \u0442\u0440\u0438\u0432\u0438\u0430\u043b\u044c\u043d\u0430\u044f:<\/p>\n
public async up(qr: QueryRunner): Promise<void> {                                 await qr.query(`      ALTER TABLE <your_users_table>                                                    ADD COLUMN IF NOT EXISTS acquisition_source VARCHAR(128) NULL;    `);  }  public async down(qr: QueryRunner): Promise<void> {    await qr.query(`      ALTER TABLE <your_users_table> DROP COLUMN IF EXISTS acquisition_source;    `);  }<\/code>
<\/a><\/div><\/pre>\n
source \u2014 \u0432\u043d\u0435\u0448\u043d\u0438\u0439 user-controlled \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 (\u043b\u044e\u0431\u043e\u0439 \u043c\u043e\u0436\u0435\u0442 \u043f\u0440\u0438\u0441\u043b\u0430\u0442\u044c \u0447\u0442\u043e \u0443\u0433\u043e\u0434\u043d\u043e, \u0441\u0441\u044b\u043b\u043a\u0443 \u0441 UTM \u043f\u043e\u0434\u0434\u0435\u043b\u0430\u0442\u044c \u0442\u0440\u0438\u0432\u0438\u0430\u043b\u044c\u043d\u043e). \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e clamp \u0434\u043b\u0438\u043d\u044b + \u0441\u0430\u043d\u0438\u0442\u0430\u0439\u0437 \u043f\u0435\u0440\u0435\u0434 \u0437\u0430\u043f\u0438\u0441\u044c\u044e:<\/p>\n
function sanitizeSource(raw: string | undefined | null): string | null {    if (!raw) return null;                                                          const trimmed = raw.trim();               if (!trimmed) return null;    return trimmed.slice(0, 128);                                                 }                                                                                                                         \/\/ \u0412 AuthService.register:                                                      await this.usersService.create({    email: dto.email,                                                               passwordHash,                             name: dto.name,    agreementsAcceptedAt: new Date(),                                               agreementsVersion: dto.agreementsVersion,     acquisitionSource: sanitizeSource(dto.source),                                });    <\/code>
<\/a><\/div><\/pre>\n
\u042d\u0442\u043e\u0433\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442. \u0423 \u043d\u0430\u0441 \u043d\u0435 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u0434\u043b\u044f \u043c\u0438\u043b\u043b\u0438\u043e\u043d\u043e\u0432 \u0441\u043e\u0431\u044b\u0442\u0438\u0439, \u0443 \u043d\u0430\u0441 \u043e\u0434\u043d\u0430 \u0441\u0442\u0440\u043e\u043a\u0430 \u043d\u0430 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f. \u0415\u0441\u043b\u0438 \u043a\u0442\u043e-\u0442\u043e \u0440\u0435\u0448\u0438\u0442 \u0437\u0430\u043f\u0438\u0445\u0430\u0442\u044c \u0442\u0443\u0434\u0430 XSS \u2014 \u043e\u043d \u043f\u043e\u043f\u0430\u0434\u0451\u0442 \u0432 varchar(128), \u043d\u0438\u043a\u0430\u043a \u043d\u0435 \u0432\u044b\u0439\u0434\u0435\u0442 \u043d\u0430\u0440\u0443\u0436\u0443 \u0447\u0435\u0440\u0435\u0437 \u043d\u0430\u0448\u0443 \u0430\u0434\u043c\u0438\u043d\u043a\u0443 (\u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u0440\u0435\u043d\u0434\u0435\u0440\u0430 \u044d\u043a\u0440\u0430\u043d\u0438\u0440\u0443\u0435\u043c \u043a\u0430\u043a \u043e\u0431\u044b\u0447\u043d\u043e).<\/p>\n
\u0427\u0430\u0441\u0442\u044c 3. Telegram Mini App: start_param<\/h2>\n
Telegram \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442 payload \u0431\u043e\u0442\u0443 \u0447\u0435\u0440\u0435\u0437 \u0441\u0441\u044b\u043b\u043a\u0443 \u0432\u0438\u0434\u0430: t.me\/your_bot\/your_app?startapp=PAYLOAD<\/p>\n
\u0412 Mini App \u044d\u0442\u043e\u0442 payload \u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432\u043d\u0443\u0442\u0440\u0438 Telegram.WebApp.initData \u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u043e\u043c start_param. \u041d\u0430 \u0431\u044d\u043a\u0435 \u043c\u044b \u0438 \u0442\u0430\u043a \u0432\u0430\u043b\u0438\u0434\u0438\u0440\u0443\u0435\u043c initData (HMAC-SHA256 \u043f\u043e bot_token), \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0432\u044b\u0442\u0430\u0449\u0438\u0442\u044c \u043e\u0442\u0442\u0443\u0434\u0430 start_param \u2014 \u0434\u0432\u0435 \u043b\u0438\u0448\u043d\u0438\u0435 \u0441\u0442\u0440\u043e\u043a\u0438.<\/p>\n
\u042f \u043f\u0440\u043e\u0441\u0442\u043e \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u043b \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 verifyInitData \u0442\u0430\u043a \u0447\u0442\u043e\u0431\u044b \u043e\u043d \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u043b \u043d\u0435
 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f, \u043d\u043e \u0438 start_param:<\/p>\n
verifyInitData(initData: string): { user: TelegramUser; startParam: string |    null } {    \/\/ ...\u0442\u0430 \u0436\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f HMAC, \u0447\u0442\u043e \u0431\u044b\u043b\u0430 \u0440\u0430\u043d\u044c\u0448\u0435...                                                                                const params = new URLSearchParams(initData);    \/\/ ... \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0430\u044f \u043b\u043e\u0433\u0438\u043a\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043f\u043e\u0434\u043f\u0438\u0441\u0438 ...                                                                                    const userJson = params.get('user');      const user: TelegramUser = JSON.parse(userJson);                                                                                                                const rawStart = params.get('start_param');    const startParam =                                                                rawStart && rawStart.length > 0 && rawStart.length <= 64        ? rawStart                                                                      : null;                                                                                                               return { user, startParam };                                                  }<\/code>
<\/a><\/div><\/pre>\n
64 \u0441\u0438\u043c\u0432\u043e\u043b\u0430 \u2014 \u044d\u0442\u043e \u043b\u0438\u043c\u0438\u0442 \u0441\u0430\u043c\u043e\u0433\u043e Telegram \u043d\u0430 \u0434\u043b\u0438\u043d\u0443 start_param. \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0437\u0430\u0449\u0438\u0442\u0430 \u043d\u0430 \u0441\u043b\u0443\u0447\u0430\u0439 \u043f\u043e\u0434\u0434\u0435\u043b\u0430\u043d\u043d\u043e\u0433\u043e payload.<\/p>\n
\u0412 \u0441\u0435\u0440\u0432\u0438\u0441\u0435 \u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438 \u043f\u0438\u0448\u0435\u043c source \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438 \u043d\u043e\u0432\u043e\u0433\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f (\u0442\u043e\u043b\u044c\u043a\u043e
 \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438, \u0443 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0449\u0438\u0445\u0441\u044f \u043d\u0435 \u043f\u0435\u0440\u0435\u0442\u0438\u0440\u0430\u0435\u043c):<\/p>\n
async loginWithTelegram(initData: string) {                                       const { user: tgUser, startParam } =        this.telegramAuth.verifyInitData(initData);                                       const telegramId = String(tgUser.id);                                                                                     let user = await this.usersService.findByTelegramId(telegramId);                if (!user) {                                                                      const source = startParam ? `tg:${startParam}` : null;                          user = await this.usersService.create({                                           email: `tg_${telegramId}@demo.speakwithai.pro`,        name: tgUser.first_name,                                                        telegramId,                                                                     isDemoUser: true,        acquisitionSource: source, \/\/ \u2190 \u0437\u0434\u0435\u0441\u044c                                         });                                         }                                                                                                 return this.generateTokens(user.id, user.email);                              }<\/code>
<\/a><\/div><\/pre>\n
\u0427\u0430\u0441\u0442\u044c 4. \u041c\u0430\u0440\u043a\u0438\u0440\u0443\u0435\u043c \u0432\u0441\u0435 \u0441\u0441\u044b\u043b\u043a\u0438<\/h2>\n
\u0411\u0435\u0437 \u0440\u0430\u0437\u043c\u0435\u0447\u0435\u043d\u043d\u044b\u0445 \u0441\u0441\u044b\u043b\u043e\u043a \u0432\u0435\u0441\u044c \u044d\u0442\u043e\u0442 \u043a\u043e\u0434 \u0431\u0435\u0441\u043f\u043e\u043b\u0435\u0437\u0435\u043d. \u0412\u0435\u0437\u0434\u0435 \u0433\u0434\u0435 \u0443 \u043c\u0435\u043d\u044f \u0435\u0441\u0442\u044c \u0443\u043f\u043e\u043c\u0438\u043d\u0430\u043d\u0438\u0435 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u0430 \u2014 \u0432 \u0441\u0442\u0430\u0442\u044c\u044f\u0445, \u0432 \u043f\u043e\u0441\u0442\u0430\u0445, \u0432 \u0431\u0438\u043e \u2014 \u043a\u0430\u0436\u0434\u0430\u044f \u0441\u0441\u044b\u043b\u043a\u0430 \u0442\u0435\u043f\u0435\u0440\u044c \u0438\u043c\u0435\u0435\u0442 \u0443\u043d\u0438\u043a\u0430\u043b\u044c\u043d\u044b\u0439 suffix:<\/p>\n
TG: t.me\/aiteacher_emma_bot\/emma?startapp=habr_attr_top
 Web: speakwithai.pro\/?utm_source=habr&utm_medium=article&utm_campaign=attribution_post&utm_content=top<\/p>\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430  \u2014 \u0435\u0451 \u0438 \u0431\u0443\u0434\u0443 \u0432\u0438\u0434\u0435\u0442\u044c \u0432 \u0411\u0414. \u041f\u043e placement (top\/mid\/end) \u043c\u043e\u0436\u043d\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u043a\u0430\u043a\u043e\u0439 \u0438\u043c\u0435\u043d\u043d\u043e \u0431\u043b\u043e\u043a CTA \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u2014 \u0441\u0430\u043c\u044b\u0439 \u0446\u0435\u043d\u043d\u044b\u0439 \u0441\u0438\u0433\u043d\u0430\u043b, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043e\u043d \u043e\u0442\u0432\u0435\u0442\u0438\u0442 \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441 \u00ab\u0434\u043e\u0447\u0438\u0442\u044b\u0432\u0430\u044e\u0442 \u043b\u0438 \u043c\u043e\u044e \u0441\u0442\u0430\u0442\u044c\u044e \u0438\u043b\u0438 \u0441\u0432\u0430\u043b\u0438\u0432\u0430\u044e\u0442 \u043d\u0430 \u043f\u0435\u0440\u0432\u043e\u043c \u0430\u0431\u0437\u0430\u0446\u0435\u00bb.<\/p>\n
\ud83d\udca1 \u041c\u0435\u0436\u0434\u0443 \u043f\u0440\u043e\u0447\u0438\u043c \u2014 \u0435\u0441\u043b\u0438 \u0441\u0442\u0430\u043b\u043e \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u043f\u043e\u0442\u0440\u043e\u0433\u0430\u0442\u044c \u043f\u0440\u043e\u0434\u0443\u043a\u0442 \u043e \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0440\u0435\u0447\u044c, \u0434\u0435\u043c\u043e \u0432 Telegram<\/a> \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e \u0431\u0435\u0437 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438. \u0410 \u043d\u0438\u0436\u0435 \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u043f\u0440\u043e \u0433\u0440\u0430\u043d\u0438\u0447\u043d\u044b\u0435 \u043a\u0435\u0439\u0441\u044b \u0438 edge cases.<\/p>\n
\u0427\u0430\u0441\u0442\u044c 5. Edge cases<\/h2>\n
    \n
  1. \n
    localStorage \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d (Safari private mode, \u0441\u0442\u0430\u0440\u044b\u0435 WebView) \u041f\u0430\u0434\u0430\u0442\u044c \u043d\u0435\u043b\u044c\u0437\u044f. \u0412\u0441\u0435 \u043e\u0431\u0440\u0430\u0449\u0435\u043d\u0438\u044f \u043a localStorage \u0432 try\/catch, \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c null. \u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0437\u0430\u043f\u0438\u0448\u0435\u0442\u0441\u044f \u2014 \u044d\u0442\u043e \u043d\u0435 \u043a\u0440\u0438\u0442\u0438\u0447\u043d\u043e.<\/p>\n<\/li>\n
  2. \n
    \u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0449\u0438\u0439\u0441\u044f \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u0441 \u0434\u0440\u0443\u0433\u0438\u043c UTM
     First-touch \u2014 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0435\u043c. \u0415\u0441\u043b\u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a \u043f\u0440\u0438\u0448\u0451\u043b \u043f\u043e utm_source=habr 2 \u043d\u0435\u0434\u0435\u043b\u0438
     \u043d\u0430\u0437\u0430\u0434, \u043f\u043e\u0442\u043e\u043c \u043f\u043e utm_source=vc \u0441\u0435\u0439\u0447\u0430\u0441 \u2014 \u0434\u043b\u044f \u043c\u0435\u043d\u044f \u043e\u043d \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f habr. \u042d\u0442\u043e
     \u0441\u043e\u0437\u043d\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u0432\u044b\u0431\u043e\u0440: \u044f \u0445\u043e\u0447\u0443 \u0437\u043d\u0430\u0442\u044c \u00ab\u043a\u0442\u043e \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u043b \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0441 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u043e\u043c\u00bb, \u0430 \u043d\u0435 \u00ab\u0447\u0435\u0440\u0435\u0437 \u0447\u0442\u043e \u043e\u043d \u0437\u0430\u0448\u0451\u043b \u0441\u0435\u0433\u043e\u0434\u043d\u044f\u00bb. Last-touch \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 Yandex.Metrika.<\/p>\n<\/li>\n
  3. \n
    Capacitor (\u043d\u0430\u0442\u0438\u0432\u043d\u043e\u0435 Android)
     \u0417\u0434\u0435\u0441\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u043f\u043e\u0434\u043d\u043e\u0436\u043a\u0430:     window.location.search<\/a> \u043f\u0443\u0441\u0442\u043e\u0439, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u0431\u0430\u043d\u0434\u043b
     \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442\u0441\u044f \u0441     localhost<\/a> (assets \u0438\u0437 APK). UTM \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043b\u043e\u0432\u0438\u0442\u044c \u0447\u0435\u0440\u0435\u0437 URL \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0441\u044f. \u0420\u0435\u0448\u0435\u043d\u0438\u0435 \u2014 \u0434\u0440\u0443\u0433\u043e\u0439 \u043a\u0430\u043d\u0430\u043b \u0430\u0442\u0440\u0438\u0431\u0443\u0446\u0438\u0438: Capacitor \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u0438\u0437 RuStore, \u0438 \u043a\u0430\u0436\u0434\u0430\u044f \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0447\u0435\u0440\u0435\u0437 RuStore \u043f\u0440\u043e\u0441\u0442\u043e \u043f\u043e\u043c\u0435\u0447\u0430\u0435\u0442\u0441\u044f \u043a\u0430\u043a app:rustore \u043d\u0430 \u0431\u044d\u043a\u0435 (\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0435\u043c \u0447\u0435\u0440\u0435\u0437 user-agent \u0438\u043b\u0438 X-Auth-Mode: bearer \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0438 \u0442\u0430\u043a \u0448\u043b\u0451\u0442\u0441\u044f \u043d\u0430 \u043d\u0430\u0442\u0438\u0432\u0435 \u0434\u043b\u044f bearer-\u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438).<\/p>\n<\/li>\n
  4. \n
    GDPR \/ 152-\u0424\u0417
     UTM \u2014 \u043d\u0435 \u043f\u0435\u0440\u0441\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435. start_param \u2014 \u0442\u043e\u0436\u0435. \u042d\u0442\u043e \u043c\u0430\u0440\u043a\u0435\u0440 \u043a\u0430\u043d\u0430\u043b\u0430, \u0430 \u043d\u0435 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u0430. \u0412 \u043e\u0444\u0435\u0440\u0442\u0435\/\u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0435 \u043a\u043e\u043d\u0444\u0438\u0434\u0435\u043d\u0446\u0438\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u0438 \u043f\u0440\u043e \u044d\u0442\u043e \u0434\u0430\u0436\u0435 \u043f\u0438\u0441\u0430\u0442\u044c \u043d\u0435 \u043d\u0443\u0436\u043d\u043e (\u043d\u043e \u044f \u043d\u0430\u043f\u0438\u0441\u0430\u043b \u2014 \u043b\u0438\u0448\u043d\u0438\u043c \u043d\u0435 \u0431\u0443\u0434\u0435\u0442).<\/p>\n<\/li>\n
  5. \n
    \u0427\u0442\u043e \u0435\u0441\u043b\u0438 \u0437\u043b\u043e\u0443\u043c\u044b\u0448\u043b\u0435\u043d\u043d\u0438\u043a \u0437\u0430\u043f\u0438\u0445\u0430\u0435\u0442 1MB \u0442\u0435\u043a\u0441\u0442\u0430 \u0432 source?
     \u041d\u0435 \u0437\u0430\u043f\u0438\u0445\u0430\u0435\u0442.     @MaxLength<\/a>(128) \u0432\u0430\u043b\u0438\u0434\u0430\u0442\u043e\u0440 \u043e\u0442\u0431\u0440\u043e\u0441\u0438\u0442 \u043d\u0430 DTO, plus varchar(128) \u043e\u0431\u0440\u0435\u0436\u0435\u0442 \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0411\u0414 \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u043a\u0430\u043a\u0438\u043c-\u0442\u043e \u0447\u0443\u0434\u043e\u043c \u043f\u0440\u043e\u0439\u0434\u0451\u0442.<\/p>\n<\/li>\n<\/ol>\n
    \u0427\u0430\u0441\u0442\u044c 6. \u0427\u0442\u0435\u043d\u0438\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432<\/h2>\n
    \u041c\u044b \u0437\u0430\u0448\u043b\u0438 \u0440\u0430\u0434\u0438 \u044d\u0442\u043e\u0439 \u0441\u0442\u0440\u043e\u0447\u043a\u0438 SQL:<\/p>\n
    SELECT              acquisition_source,    COUNT(*) AS users,     MIN(created_at) AS first_seen,    MAX(created_at) AS last_seen  FROM <your_users_table>                       WHERE created_at > NOW() - INTERVAL '7 days'    AND acquisition_source IS NOT NULL  GROUP BY 1                                                                      ORDER BY 2 DESC;<\/code>
    <\/a><\/div><\/pre>\n
    \u041f\u043e\u0441\u043b\u0435 \u043d\u0435\u0434\u0435\u043b\u0438 \u0442\u0430\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0439 \u0443 \u043c\u0435\u043d\u044f \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n
    acquisition_source                  | users | first_seen
     ———————————\u00b1——\u00b1———-
     NULL                                      |  47   | 2026-04-25
     tg:habr1029400_end              |  12   | 2026-04-30
     tg:habr1029400_top               |   8   | 2026-04-30 <\/p>\n
    web:habr\/tma_post\/end           |   4   | 2026-04-30
     tg:vc2885735_end                  |   3   | 2026-04-30
     web:vc\/rustore_post\/top         |   1   | 2026-05-01<\/p>\n
    \u0418 \u0441\u0440\u0430\u0437\u0443 \u0432\u0438\u0434\u043d\u043e:<\/p>\n
    \u2014 end (\u043d\u0438\u0436\u043d\u0438\u0439 CTA) \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0432 \u043e\u0431\u0435\u0438\u0445 \u0441\u0442\u0430\u0442\u044c\u044f\u0445 \u043b\u0443\u0447\u0448\u0435 <\/em>top. \u0417\u043d\u0430\u0447\u0438\u0442 \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u0438
     \u0432\u0441\u0451-\u0442\u0430\u043a\u0438 \u0434\u043e\u0447\u0438\u0442\u044b\u0432\u0430\u044e\u0442.
     \u2014 TG-\u043a\u0430\u043d\u0430\u043b \u0434\u0430\u0451\u0442 \u0432 3 \u0440\u0430\u0437\u0430 \u0431\u043e\u043b\u044c\u0448\u0435 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0439 \u0447\u0435\u043c web \u043d\u0430 \u0442\u043e\u0439 \u0436\u0435 \u0441\u0442\u0430\u0442\u044c\u0435.
     \u0410\u0443\u0434\u0438\u0442\u043e\u0440\u0438\u044f Habr \u0441\u043a\u043b\u043e\u043d\u044f\u0435\u0442\u0441\u044f \u043a Telegram.
     \u2014     vc.ru<\/a> \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0447\u0430\u043b \u0434\u0430\u0432\u0430\u0442\u044c \u0441\u0438\u0433\u043d\u0430\u043b \u2014 \u0440\u0430\u043d\u043e \u0441\u0443\u0434\u0438\u0442\u044c. \u2014 47 NULL \u2014 \u044d\u0442\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u043a\u0430 \u0438 \u0441\u0442\u0430\u0440\u044b\u0435 \u0441\u0441\u044b\u043b\u043a\u0438. \u0421\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0435\u043c \u0434\u043e\u043b\u044f \u0431\u0443\u0434\u0435\u0442 \u043f\u0430\u0434\u0430\u0442\u044c.<\/p>\n
    \u0427\u0430\u0441\u0442\u044c 7. \u0427\u0442\u043e \u044f \u043f\u043e\u043d\u044f\u043b \u0437\u0430 \u043d\u0435\u0434\u0435\u043b\u044e<\/h2>\n
    \u2014 \u0410\u0442\u0440\u0438\u0431\u0443\u0446\u0438\u044f \u0432\u0430\u0436\u043d\u0435\u0435 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438. YM\/GA \u0433\u043e\u0432\u043e\u0440\u044f\u0442 \u00ab\u043a\u0442\u043e\u00bb, \u0430\u0442\u0440\u0438\u0431\u0443\u0446\u0438\u044f \u2014 \u00ab\u043e\u0442\u043a\u0443\u0434\u0430\u00bb. \u0411\u0435\u0437
     \u0432\u0442\u043e\u0440\u043e\u0433\u043e \u043f\u0435\u0440\u0432\u043e\u0435 \u0431\u0435\u0441\u043f\u043e\u043b\u0435\u0437\u043d\u043e.
     \u2014 \u041f\u0440\u043e\u0441\u0442\u044b\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u044f \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442. 100 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430 \u0441 \u043e\u0434\u043d\u043e\u0439 \u043a\u043e\u043b\u043e\u043d\u043a\u043e\u0439 \u0434\u0430\u044e\u0442 80% \u0438\u043d\u0441\u0430\u0439\u0442\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043d\u0443\u0436\u043d\u044b \u0441\u043e\u043b\u043e-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443. \u0411\u043e\u043b\u044c\u0448\u0438\u0435 CDP \u2014 \u044d\u0442\u043e \u0434\u043b\u044f \u043a\u043e\u043c\u0430\u043d\u0434 \u043e\u0442 5 \u0447\u0435\u043b\u043e\u0432\u0435\u043a. \u2014 First-touch + last-touch (YM) \u2014 \u043a\u043e\u043c\u043f\u043b\u0435\u043c\u0435\u043d\u0442\u0430\u0440\u043d\u044b\u0435 \u0441\u0438\u0441\u0442\u0435\u043c\u044b. \u041d\u0435 \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u0439\u0442\u0435.
     \u2014 \u041e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0442\u0430\u0433\u0438\u0440\u0443\u0439\u0442\u0435 \u0441\u0441\u044b\u043b\u043a\u0438 \u0432\u0435\u0437\u0434\u0435. \u0415\u0441\u043b\u0438 \u044d\u0442\u043e\u0433\u043e \u043d\u0435 \u0434\u0435\u043b\u0430\u0442\u044c \u2014 \u0430\u0442\u0440\u0438\u0431\u0443\u0446\u0438\u044f \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 NULL \u0438 \u0432\u0435\u0441\u044c \u043a\u043e\u0434 \u0431\u044b\u043b \u0437\u0440\u044f.<\/p>\n
    \u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h2>\n
    \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043a\u0430\u043d\u0430\u043b\u043e\u0432 \u043f\u0440\u0438\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u044f (web + \u0431\u043e\u0442 \/ app + \u0441\u0430\u0439\u0442 \/ \u043b\u044e\u0431\u0430\u044f
     \u043a\u043e\u043c\u0431\u0438\u043d\u0430\u0446\u0438\u044f) \u0438 \u0432\u044b \u043d\u0435 \u043c\u043e\u0436\u0435\u0442\u0435 \u043e\u0442\u0432\u0435\u0442\u0438\u0442\u044c \u00ab\u043e\u0442\u043a\u0443\u0434\u0430 \u0441\u0435\u0439\u0447\u0430\u0441 \u043f\u0440\u0438\u0445\u043e\u0434\u044f\u0442 \u043b\u044e\u0434\u0438\u00bb \u2014 \u043f\u043e\u043f\u0440\u043e\u0431\u0443\u0439\u0442\u0435 \u0442\u0430\u043a\u043e\u0439 \u0436\u0435 \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u0435\u0442\u0430\u043f. \u042d\u0442\u043e \u0432\u0435\u0447\u0435\u0440 \u0440\u0430\u0431\u043e\u0442\u044b, \u0438 \u043e\u043d\u043e \u0441\u0440\u0430\u0437\u0443 \u043e\u043a\u0443\u043f\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u043f\u0435\u0440\u0432\u043e\u0439 \u043a\u0430\u043c\u043f\u0430\u043d\u0438\u0438.<\/p>\n
    \u0415\u0441\u043b\u0438 \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043d\u0430 \u043f\u0440\u043e\u0434\u0443\u043a\u0442, \u0434\u043b\u044f \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u044d\u0442\u043e \u0432\u0441\u0451 \u0434\u0435\u043b\u0430\u043b\u043e\u0441\u044c:<\/p>\n
    \ud83e\udd16 Telegram Mini App<\/a> (3 \u043c\u0438\u043d\u0443\u0442\u044b \u0441 AI \u0431\u0435\u0437 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438)<\/p>\n
    \ud83c\udf10 \u0412\u0435\u0431-\u0432\u0435\u0440\u0441\u0438\u044f<\/a><\/p>\n
    \ud83d\udcf1 Android \u0432 RuStore<\/a><\/p>\n
    \u2753 \u0412\u043e\u043f\u0440\u043e\u0441 \u043a \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u044f\u043c: \u043a\u0430\u043a \u0432\u044b \u0443 \u0441\u0435\u0431\u044f \u0440\u0435\u0448\u0430\u0435\u0442\u0435 \u0437\u0430\u0434\u0430\u0447\u0443 \u043c\u0443\u043b\u044c\u0442\u0438-\u043a\u0430\u043d\u0430\u043b\u044c\u043d\u043e\u0439
     \u0430\u0442\u0440\u0438\u0431\u0443\u0446\u0438\u0438? \u0422\u0430\u0449\u0438\u0442\u0435 CDP, \u043a\u043e\u0441\u0442\u044b\u043b\u0438\u0442\u0435 \u043a\u0430\u043a \u044f, \u0438\u043b\u0438 \u0432\u043e\u043e\u0431\u0449\u0435 \u043d\u0435 \u0441\u0447\u0438\u0442\u0430\u0435\u0442\u0435 \u0438
     \u043e\u0440\u0438\u0435\u043d\u0442\u0438\u0440\u0443\u0435\u0442\u0435\u0441\u044c \u043d\u0430 \u043e\u0449\u0443\u0449\u0435\u043d\u0438\u044f?<\/p>\n<\/div>\n
    \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 https:\/\/habr.com\/ru\/articles\/1030560\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
    \u0411\u0435\u0437 \u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0445 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a, \u043e\u0434\u043d\u043e\u0439 \u043a\u043e\u043b\u043e\u043d\u043a\u043e\u0439 \u0432 \u0411\u0414, \u0434\u043b\u044f \u0441\u043e\u043b\u043e-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u043a\u043e\u0442\u043e\u0440\u043e\u043c\u0443 \u043d\u0430\u0434\u043e \u0443\u0437\u043d\u0430\u0442\u044c \u0447\u0442\u043e \u0443 \u043d\u0435\u0433\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442.\u042f \u0434\u0435\u043b\u0430\u044e \u0433\u043e\u043b\u043e\u0441\u043e\u0432\u043e\u0439 AI-\u0440\u0435\u043f\u0435\u0442\u0438\u0442\u043e\u0440 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0433\u043e. \u041f\u0440\u043e\u0434\u0443\u043a\u0442 \u0436\u0438\u0432\u0451\u0442 \u0432 \u0442\u0440\u0451\u0445 \u043c\u0435\u0441\u0442\u0430\u0445: \u0432\u0435\u0431-\u0441\u0430\u0439\u0442 speakwithai.pro, Telegram Mini App \u0438 Android-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0432 RuStore. \u0423 \u043c\u0435\u043d\u044f \u043e\u0434\u043d\u0430 \u0438 \u0442\u0430 \u0436\u0435 \u0431\u0430\u0437\u0430 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u043d\u0430 NestJS + Postgres, \u0438 \u043c\u043d\u0435 \u043e\u0447\u0435\u043d\u044c \u043d\u0443\u0436\u0435\u043d \u043e\u0442\u0432\u0435\u0442 \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441: \u043e\u0442\u043a\u0443\u0434\u0430 \u0432\u043e\u043e\u0431\u0449\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u044f\u0442 \u043b\u044e\u0434\u0438?Yandex.Metrika \u0438 Google Analytics \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u044e\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u0430\u0439\u0442. Telegram Mini App \u0434\u043b\u044f \u043d\u0438\u0445 \u2014 \u0447\u0451\u0440\u043d\u044b\u0439 \u044f\u0449\u0438\u043a. Android-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0447\u0435\u0440\u0435\u0437 WebView \u2014 \u0442\u043e\u0436\u0435. \u0418\u0437 6000 \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u043e\u0432 \u0441\u0442\u0430\u0442\u044c\u0438 \u043d\u0430 Habr \u044f \u043d\u0435 \u043c\u043e\u0433 \u0441\u043a\u0430\u0437\u0430\u0442\u044c, \u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043e\u0442\u0442\u0443\u0434\u0430 \u043f\u0440\u0438\u0448\u043b\u043e \u0432 \u043f\u0440\u043e\u0434\u0443\u043a\u0442, \u0438 \u0447\u0435\u0440\u0435\u0437 \u043a\u0430\u043a\u043e\u0439 \u043a\u0430\u043d\u0430\u043b (TG, \u0432\u0435\u0431, app).\u042f \u043d\u0435 \u0445\u043e\u0442\u0435\u043b \u0442\u0430\u0449\u0438\u0442\u044c \u0431\u043e\u043b\u044c\u0448\u0443\u044e CDP \u0432\u0440\u043e\u0434\u0435 Mixpanel \u0438\u043b\u0438 Amplitude \u2014 \u0434\u043b\u044f \u0441\u043e\u043b\u043e-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u044d\u0442\u043e overkill. \u0412\u0435\u0447\u0435\u0440\u043e\u043c \u0441\u0435\u043b \u0438 \u0441\u0434\u0435\u043b\u0430\u043b simplest-thing-that-could-possibly-work: \u043e\u0434\u043d\u0430 \u043a\u043e\u043b\u043e\u043d\u043a\u0430 \u0432 \u0411\u0414, \u043f\u0430\u0440\u0441\u0438\u0442\u0441\u044f \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0432\u0438\u0437\u0438\u0442\u0435, \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438. 100 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430. \u0414\u0435\u043b\u044e\u0441\u044c.\u0415\u0441\u043b\u0438 \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043d\u0430 \u0441\u0430\u043c \u043f\u0440\u043e\u0434\u0443\u043a\u0442 \u2014 \u043e\u043d \u0436\u0438\u0432\u0451\u0442 \u0437\u0434\u0435\u0441\u044c: \ud83e\udd16 Telegram-\u0431\u043e\u0442 \ud83c\udf10 \u0412\u0435\u0431-\u0432\u0435\u0440\u0441\u0438\u044f \ud83d\udcf1 Android \u0432 RuStore\u0427\u0442\u043e \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043d\u0430 \u0432\u044b\u0445\u043e\u0434\u0435\u041e\u0434\u0438\u043d SQL-\u0437\u0430\u043f\u0440\u043e\u0441:SELECT acquisition_source, COUNT(*)                                             FROM <your_users_table>  WHERE created_at > NOW() — INTERVAL ‘7 days’                                    GROUP BY 1                                ORDER BY 2 DESC;\u0421 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u043c:acquisition_source                         | count ——————————— NULL                                             | 47 tg:habr_attr_top                             | 8 tg:habr_attr_end                            | 12 web:habr\/attribution_post\/top        | 4 web:vc\/growth_post\/top                 | 3\u0422\u043e \u0435\u0441\u0442\u044c \u043a\u043e\u043b\u043e\u043d\u043a\u0430 acquisition_source \u0441\u043e \u0441\u0442\u0440\u043e\u043a\u043e\u0439 \u0444\u043e\u0440\u043c\u0430\u0442\u0430 :\/\/ \u2014 \u0438 \u0432\u0441\u0451. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 join\u2019\u043e\u0432, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u0442\u0430\u0431\u043b\u0438\u0446 \u0441\u043e\u0431\u044b\u0442\u0438\u0439. \u0415\u0441\u043b\u0438 \u043a\u0430\u043a\u043e\u0439-\u0442\u043e \u043a\u0430\u043d\u0430\u043b \u0434\u0430\u0451\u0442 0 \u2014 \u043e\u043d \u044f\u0432\u043d\u043e \u043c\u0451\u0440\u0442\u0432. \u0415\u0441\u043b\u0438 \u0434\u0440\u0443\u0433\u043e\u0439 \u0434\u0430\u0451\u0442 12 \u2014 \u0434\u0432\u043e\u0439\u0442\u0435 \u0431\u044e\u0434\u0436\u0435\u0442 \u0442\u0443\u0434\u0430.\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430[Web] \u2500\u2500\u2500 UTM \u0438\u0437 URL \u2192 localStorage \u2192 POST \/auth\/register \u0441 source \u2500\u2510 [TG Mini App] \u2500\u2500 start_param \u0438\u0437 initData \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2192 users.acquisition_source [Capacitor (web bundle)] \u2500\u2500 \u043e\u0431\u0435 \u0432\u0435\u0442\u043a\u0438 \u0432\u044b\u0448\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442 \u043a\u0430\u043a \u0435\u0441\u0442\u044c \u2500\u2500\u2500\u2500\u2500\u2500\u2518Capacitor \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u043b\u043e\u0433\u0438\u043a\u0438 \u043d\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u2014 \u043e\u043d \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u0442\u043e\u0442 \u0436\u0435 React-\u0431\u0430\u043d\u0434\u043b \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0440\u0435\u0435\u0441\u0442-\u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442. \u042d\u0442\u043e \u0438 \u0445\u043e\u0440\u043e\u0448\u043e: \u043f\u0438\u0448\u0435\u043c \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043d\u0430 \u0442\u0440\u0451\u0445 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0430\u0445.\u0427\u0430\u0441\u0442\u044c 1. \u0412\u0435\u0431: \u043b\u043e\u0432\u0438\u043c UTM\u041f\u043e\u0434\u0445\u043e\u0434 \u2014 first-touch: \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u043c UTM \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0432\u0438\u0437\u0438\u0442\u0435, \u043d\u0435 \u043f\u0435\u0440\u0435\u0442\u0438\u0440\u0430\u0435\u043c \u043f\u0440\u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0445. \u042d\u0442\u043e \u0434\u0430\u0451\u0442 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u0443\u044e \u043a\u0430\u0440\u0442\u0438\u043d\u0443 \u00ab\u0433\u0434\u0435 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043d\u0430\u0448\u0451\u043b \u043d\u0430\u0441 \u0438\u0437\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u043e\u00bb. \u0412\u0430\u0440\u0438\u0430\u043d\u0442 last-touch (\u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437) \u0442\u043e\u0436\u0435 \u0438\u043c\u0435\u0435\u0442 \u0441\u043c\u044b\u0441\u043b, \u043d\u043e \u043e\u043d \u0443 \u043c\u0435\u043d\u044f \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 Yandex.Metrika \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438, \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0435 \u043d\u0443\u0436\u043d\u043e.Helper, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u043d\u0430 \u0441\u0442\u0430\u0440\u0442\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f:\/\/ apps\/web\/src\/lib\/acquisitionSource.ts      const STORAGE_KEY = ‘speakwithai.acquisition_source’;  const MAX_LEN = 128;                                                                                                          function buildSourceString(params: URLSearchParams): string | null {    \/\/ Telegram Mini App \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 (fallback) \u2014 \u043f\u0438\u0448\u0435\u043c \u043a\u0430\u043a tg:                      const tgStart = params.get(‘tgWebAppStartParam’);                               if (tgStart) return `tg:${tgStart}`.slice(0, MAX_LEN);                                                                                                          \/\/ \u041e\u0431\u044b\u0447\u043d\u044b\u0439 \u0432\u0435\u0431 \u2014 UTM                                                            const utmSource = params.get(‘utm_source’);                                     if (!utmSource) return null;                                                                                                                                    const parts = [                                                                   utmSource,        params.get(‘utm_campaign’) ?? »,                                               params.get(‘utm_content’) ?? »,            ];                                                                              while (parts.length > 1 && parts[parts.length — 1] === ») parts.pop();    return `web:${parts.join(‘\/’)}`.slice(0, MAX_LEN);                            }                                                                                                                         export function captureAndStoreSource(): void {                                   try {                                       if (localStorage.getItem(STORAGE_KEY)) return; \/\/ first-touch                   const source = buildSourceString(                                                 new URLSearchParams(window.location.search),      );                                                                              if (source) localStorage.setItem(STORAGE_KEY, source);                        } catch {                                       \/\/ localStorage \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u043e\u0442\u043a\u043b\u044e\u0447\u0451\u043d (Safari private) \u2014 \u043f\u0440\u043e\u043f\u0443\u0441\u043a\u0430\u0435\u043c             }                                           }                                                                                  export function getStoredSource(): string | null {                                try {               return localStorage.getItem(STORAGE_KEY);                                     } catch {                                       return null;                            }  }    \u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c \u0432 main.tsx \u0434\u043e \u0440\u0435\u043d\u0434\u0435\u0440\u0430 React, \u0447\u0442\u043e\u0431\u044b \u0443\u0441\u043f\u0435\u0442\u044c \u0437\u0430\u0445\u0432\u0430\u0442\u0438\u0442\u044c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043d\u0435 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u044d\u0442\u043e\u0439 \u0441\u0435\u0441\u0441\u0438\u0438:\/\/ apps\/web\/src\/main.tsx                                                        import { captureAndStoreSource } from ‘.\/lib\/acquisitionSource’;                                                                                  captureAndStoreSource();                  createRoot(document.getElementById(‘root’)!).render(<App \/>);                                                             \u0414\u0430\u043b\u044c\u0448\u0435 \u043f\u0440\u0438 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u043f\u043e\u043b\u0435 source \u0432 DTO:                                                                                                             const { accessToken } = await registerApi({    name,                                                                           email,                                        password,                                                                       agreementsVersion: AGREEMENTS_VERSION,    source: getStoredSource() ?? undefined,                                       });     \u0427\u0430\u0441\u0442\u044c 2. Backend: \u043a\u043e\u043b\u043e\u043d\u043a\u0430 \u0438 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f\u041c\u0438\u0433\u0440\u0430\u0446\u0438\u044f \u0442\u0440\u0438\u0432\u0438\u0430\u043b\u044c\u043d\u0430\u044f:public async up(qr: QueryRunner): Promise<void> {                                 await qr.query(`      ALTER TABLE <your_users_table>                                                    ADD COLUMN IF NOT EXISTS acquisition_source VARCHAR(128) NULL;    `);  }  public async down(qr: QueryRunner): Promise<void> {    await qr.query(`      ALTER TABLE <your_users_table> DROP COLUMN IF EXISTS acquisition_source;    `);  }source \u2014 \u0432\u043d\u0435\u0448\u043d\u0438\u0439 user-controlled \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 (\u043b\u044e\u0431\u043e\u0439 \u043c\u043e\u0436\u0435\u0442 \u043f\u0440\u0438\u0441\u043b\u0430\u0442\u044c \u0447\u0442\u043e \u0443\u0433\u043e\u0434\u043d\u043e, \u0441\u0441\u044b\u043b\u043a\u0443 \u0441 UTM \u043f\u043e\u0434\u0434\u0435\u043b\u0430\u0442\u044c \u0442\u0440\u0438\u0432\u0438\u0430\u043b\u044c\u043d\u043e). \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e clamp \u0434\u043b\u0438\u043d\u044b + \u0441\u0430\u043d\u0438\u0442\u0430\u0439\u0437 \u043f\u0435\u0440\u0435\u0434 \u0437\u0430\u043f\u0438\u0441\u044c\u044e:function sanitizeSource(raw: string | undefined | null): string | null {    if (!raw) return null;                                                          const trimmed = raw.trim();               if (!trimmed) return null;    return trimmed.slice(0, 128);                                                 }                                                                                                                         \/\/ \u0412 AuthService.register:                                                      await this.usersService.create({    email: dto.email,                                                               passwordHash,                             name: dto.name,    agreementsAcceptedAt: new Date(),                                               agreementsVersion: dto.agreementsVersion,     acquisitionSource: sanitizeSource(dto.source),                                });    \u042d\u0442\u043e\u0433\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442. \u0423 \u043d\u0430\u0441 \u043d\u0435 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u0434\u043b\u044f \u043c\u0438\u043b\u043b\u0438\u043e\u043d\u043e\u0432 \u0441\u043e\u0431\u044b\u0442\u0438\u0439, \u0443 \u043d\u0430\u0441 \u043e\u0434\u043d\u0430 \u0441\u0442\u0440\u043e\u043a\u0430 \u043d\u0430 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f. \u0415\u0441\u043b\u0438 \u043a\u0442\u043e-\u0442\u043e \u0440\u0435\u0448\u0438\u0442 \u0437\u0430\u043f\u0438\u0445\u0430\u0442\u044c \u0442\u0443\u0434\u0430 XSS \u2014 \u043e\u043d \u043f\u043e\u043f\u0430\u0434\u0451\u0442 \u0432 varchar(128), \u043d\u0438\u043a\u0430\u043a \u043d\u0435 \u0432\u044b\u0439\u0434\u0435\u0442 \u043d\u0430\u0440\u0443\u0436\u0443 \u0447\u0435\u0440\u0435\u0437 \u043d\u0430\u0448\u0443 \u0430\u0434\u043c\u0438\u043d\u043a\u0443 (\u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u0440\u0435\u043d\u0434\u0435\u0440\u0430 \u044d\u043a\u0440\u0430\u043d\u0438\u0440\u0443\u0435\u043c \u043a\u0430\u043a \u043e\u0431\u044b\u0447\u043d\u043e).\u0427\u0430\u0441\u0442\u044c 3. Telegram Mini App: start_paramTelegram \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442 payload \u0431\u043e\u0442\u0443 \u0447\u0435\u0440\u0435\u0437 \u0441\u0441\u044b\u043b\u043a\u0443 \u0432\u0438\u0434\u0430: t.me\/your_bot\/your_app?startapp=PAYLOAD\u0412 Mini App \u044d\u0442\u043e\u0442 payload \u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432\u043d\u0443\u0442\u0440\u0438 Telegram.WebApp.initData \u043f\u043e\u0434 \u043a\u043b\u044e\u0447\u043e\u043c start_param. \u041d\u0430 \u0431\u044d\u043a\u0435 \u043c\u044b \u0438 \u0442\u0430\u043a \u0432\u0430\u043b\u0438\u0434\u0438\u0440\u0443\u0435\u043c initData (HMAC-SHA256 \u043f\u043e bot_token), \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0432\u044b\u0442\u0430\u0449\u0438\u0442\u044c \u043e\u0442\u0442\u0443\u0434\u0430 start_param \u2014 \u0434\u0432\u0435 \u043b\u0438\u0448\u043d\u0438\u0435 \u0441\u0442\u0440\u043e\u043a\u0438.\u042f \u043f\u0440\u043e\u0441\u0442\u043e \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u043b \u0443\u0436\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 verifyInitData \u0442\u0430\u043a \u0447\u0442\u043e\u0431\u044b \u043e\u043d \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u043b \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f, \u043d\u043e \u0438 start_param:verifyInitData(initData: string): { user: TelegramUser; startParam: string |    null } {    \/\/ …\u0442\u0430 \u0436\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f HMAC, \u0447\u0442\u043e \u0431\u044b\u043b\u0430 \u0440\u0430\u043d\u044c\u0448\u0435…                                                                                const params = new URLSearchParams(initData);    \/\/ … \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0430\u044f \u043b\u043e\u0433\u0438\u043a\u0430 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043f\u043e\u0434\u043f\u0438\u0441\u0438 …                                                                                    const userJson = params.get(‘user’);      const user: TelegramUser = JSON.parse(userJson);                                                                                                                const rawStart = params.get(‘start_param’);    const startParam =                                                                rawStart && rawStart.length > 0 && rawStart.length <= 64        ? rawStart                                                                      : null;                                                                                                               return { user, startParam };                                                  }64 \u0441\u0438\u043c\u0432\u043e\u043b\u0430 \u2014 \u044d\u0442\u043e \u043b\u0438\u043c\u0438\u0442 \u0441\u0430\u043c\u043e\u0433\u043e Telegram \u043d\u0430 \u0434\u043b\u0438\u043d\u0443 start_param. \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0437\u0430\u0449\u0438\u0442\u0430 \u043d\u0430 \u0441\u043b\u0443\u0447\u0430\u0439 \u043f\u043e\u0434\u0434\u0435\u043b\u0430\u043d\u043d\u043e\u0433\u043e payload.\u0412 \u0441\u0435\u0440\u0432\u0438\u0441\u0435 \u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438 \u043f\u0438\u0448\u0435\u043c source \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438 \u043d\u043e\u0432\u043e\u0433\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f (\u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438, \u0443 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0449\u0438\u0445\u0441\u044f \u043d\u0435 \u043f\u0435\u0440\u0435\u0442\u0438\u0440\u0430\u0435\u043c):async loginWithTelegram(initData: string) {                                       const { user: tgUser, startParam } =        this.telegramAuth.verifyInitData(initData);              …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-478273","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/478273","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=478273"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/478273\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=478273"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=478273"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=478273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}