Партнерська програма

Модуль партнерської програми дозволяє вести реферальну програму в магазині. Партнери діляться посиланнями, а плагін відстежує конверсії та нараховує комісії.

Як це працює

1. Клієнт реєструється як партнер у панелі Мій обліковий запис
2. Адміністратор активує обліковий запис партнера
3. Партнер отримує унікальний токен та реферальне посилання
4. Партнер поширює посилання (наприклад, у соціальних мережах, на блозі)
5. Відвідувач натискає посилання - токен зберігається в cookie
6. Відвідувач оформляє замовлення - плагін пов’язує замовлення з партнером
7. Після оплати замовлення плагін нараховує комісію

Налаштування

Перейдіть до WooCommerce > Налаштування > Polski > Модулі PRO > Партнерська програма.

Модуль контролюється опцією:

polski_affiliates

Загальні налаштування

Параметр	Опис
Увімкнути партнерську програму	Активує модуль
Ставка комісії (%)	Відсоткова комісія від вартості замовлення (за замовчуванням 10%)
Основа комісії	Сума нетто / Сума брутто / Сума нетто без доставки
Тривалість cookie (днів)	Скільки днів cookie з токеном є дійсним (за замовчуванням 30)
Автоматична активація	Автоматично активувати нових партнерів (за замовчуванням: вимкнено)
Мінімальна виплата	Мінімальна сума комісії для виплати
Параметр URL	Назва параметра в реферальному посиланні (за замовчуванням poleca)

Ставки комісії за продукт

Окрім глобальної ставки комісії адміністратор може встановити індивідуальну ставку для обраного продукту. В редагуванні продукту в секції “Партнерська програма”:

• Ставка комісії (%) - перевизначає глобальну ставку
• Виключити з програми - продукт не генерує комісію

Ставки за категорію продукту також підтримуються - налаштування на категорії стосується всіх продуктів у цій категорії, якщо продукт не має власної ставки.

Реферальні посилання

Формат посилання

Реферальне посилання містить параметр URL із токеном партнера:

https://example.com/?poleca=abc123def456

Параметр poleca є налаштовуваним. Токен - це унікальний ідентифікатор партнера, що генерується при реєстрації.

Cookie tracking

Після натискання реферального посилання плагін встановлює cookie:

Параметр	Значення
Назва cookie	polski_affiliate_token
Значення	Токен партнера
Термін дії	Налаштовуваний (за замовчуванням 30 днів)
Шлях	/
SameSite	Lax

Cookie встановлюється на стороні сервера (PHP) із прапорцем HttpOnly. При наступних візитах клієнта плагін перевіряє наявність cookie та пов’язує можливе замовлення з партнером.

Атрибуція замовлення

Плагін використовує модель атрибуції “last click” - якщо клієнт натиснув посилання від кількох партнерів, комісію отримує останній. Cookie перезаписується при кожному натисканні нового посилання.

Реєстрація та активація партнерів

Реєстрація

Клієнт може зареєструватися як партнер у панелі Мій обліковий запис на сторінці /moje-konto/polski-affiliates/. Форма реєстрації містить:

• ім’я та прізвище (отримуються автоматично з облікового запису)
• спосіб виплати комісії (переказ / код знижки)
• номер банківського рахунку (для переказу)
• згода на правила партнерської програми

Активація

За замовчуванням нові облікові записи партнерів потребують ручної активації адміністратором. Адміністратор отримує сповіщення електронною поштою про нову реєстрацію та може:

• активувати обліковий запис у панелі WooCommerce > Партнери
• відхилити реєстрацію з поясненням причини

За бажанням можна увімкнути автоматичну активацію - нові облікові записи стають активними одразу після реєстрації.

Статуси партнера

Статус	Опис
Pending	Очікує на активацію
Active	Активний - може генерувати посилання та заробляти комісії
Suspended	Призупинений адміністратором
Rejected	Відхилений - реєстрацію відхилено

Відстеження комісій

Нарахування комісії

Комісія нараховується автоматично після оплати замовлення, пов’язаного з партнером. Комісія не нараховується для:

• скасованих або повернених замовлень
• замовлень, зроблених самим партнером (self-referral)
• продуктів, виключених із програми

Статуси комісії

Статус	Опис
Pending	Нарахована, очікує на затвердження
Approved	Затверджена, готова до виплати
Paid	Виплачена
Rejected	Відхилена (наприклад, замовлення повернене)

Автоматичне затвердження

Комісія змінює статус із “Pending” на “Approved” після спливу налаштовуваного періоду (за замовчуванням 14 днів). Затримка захищає від комісій за замовлення, які будуть повернені.

Якщо замовлення скасовується або повертається протягом періоду очікування, комісія автоматично відхиляється.

Панель Мій обліковий запис

Модуль додає ендпоінт /polski-affiliates до панелі Мій обліковий запис. Ендпоінт доступний за адресою:

/moje-konto/polski-affiliates/

Дашборд партнера

Після активації облікового запису партнер бачить дашборд із:

• Статистика - загальна кількість кліків, замовлень, комісій
• Реферальне посилання - повне посилання з кнопкою копіювання
• Комісії - список комісій із датами, сумами та статусами
• Виплати - історія виплат
• Місячна статистика - графік кліків та конверсій

Генерація посилань

Партнер може згенерувати реферальне посилання на:

• головну сторінку магазину
• конкретний продукт
• категорію продуктів
• будь-яку сторінку в домені магазину

Кожне посилання містить параметр poleca з токеном партнера.

Адміністративна панель

Список партнерів

Перейдіть до WooCommerce > Партнери. Таблиця містить:

• ім’я та прізвище
• електронна пошта
• статус
• дата реєстрації
• кількість рекомендацій
• загальна комісія
• баланс до виплати

Управління комісіями

Перейдіть до WooCommerce > Партнери > Комісії. Адміністратор може:

• переглядати список комісій із фільтрами (партнер, статус, дата)
• затверджувати або відхиляти комісії
• позначати комісії як виплачені
• експортувати комісії до CSV

Звіт

Перейдіть до WooCommerce > Партнери > Звіт. Звіт містить:

• загальна вартість замовлень із рекомендацій
• загальна сума комісій
• конверсія (кліки -> замовлення)
• топ 10 партнерів
• місячний тренд

Хуки

polski_pro/affiliate/commission_created

Дія, що викликається після нарахування комісії.

/**
 * @param int   $commission_id ID prowizji
 * @param int   $affiliate_id  ID afilianta
 * @param int   $order_id      ID zamówienia
 * @param float $amount        Kwota prowizji
 */
do_action('polski_pro/affiliate/commission_created', int $commission_id, int $affiliate_id, int $order_id, float $amount);

Приклад:

add_action('polski_pro/affiliate/commission_created', function (int $commission_id, int $affiliate_id, int $order_id, float $amount): void {
    // Powiadomienie afilianta o nowej prowizji
    $affiliate = get_userdata($affiliate_id);
    wp_mail(
        $affiliate->user_email,
        'Nowa prowizja w programie afiliacyjnym',
        sprintf(
            'Otrzymałeś prowizję %.2f zł za zamówienie #%d.',
            $amount,
            $order_id
        )
    );
}, 10, 4);

polski_pro/affiliate/registered

Дія, що викликається після реєстрації нового партнера.

/**
 * @param int $user_id ID użytkownika
 * @param string $token Wygenerowany token afilianta
 */
do_action('polski_pro/affiliate/registered', int $user_id, string $token);

Приклад:

add_action('polski_pro/affiliate/registered', function (int $user_id, string $token): void {
    // Przypisanie roli WordPress
    $user = get_userdata($user_id);
    $user->add_role('affiliate');
}, 10, 2);

polski_pro/affiliate/validate_referral

Фільтрує валідацію рекомендації перед нарахуванням комісії.

/**
 * @param bool $is_valid     Czy polecenie jest prawidłowe
 * @param int  $affiliate_id ID afilianta
 * @param int  $order_id     ID zamówienia
 */
apply_filters('polski_pro/affiliate/validate_referral', bool $is_valid, int $affiliate_id, int $order_id): bool;

Приклад:

add_filter('polski_pro/affiliate/validate_referral', function (bool $is_valid, int $affiliate_id, int $order_id): bool {
    $order = wc_get_order($order_id);

    // Blokowanie self-referral po adresie e-mail
    $affiliate_email = get_userdata($affiliate_id)->user_email;
    if ($order->get_billing_email() === $affiliate_email) {
        return false;
    }

    return $is_valid;
}, 10, 3);

Найпоширеніші проблеми

Комісія не нараховується

1. Перевірте, чи партнер має статус “Active”
2. Перевірте, чи cookie polski_affiliate_token встановлено (інструменти розробника браузера)
3. Перевірте, чи замовлення не було зроблено самим партнером
4. Перевірте, чи продукти в замовленні не виключені з програми

Cookie не встановлюється після натискання посилання

1. Перевірте, чи параметр URL правильний (за замовчуванням poleca)
2. Перевірте, чи токен партнера існує та активний
3. Перевірте, чи плагіни кешування не кешують сторінку з параметрами URL - додайте параметр poleca до списку виключень кешу

Партнер не бачить панелі в Мій обліковий запис

1. Перевірте, чи модуль партнерської програми увімкнений
2. Перейдіть до Налаштування > Постійні посилання та натисніть “Зберегти” (оновлює правила rewrite)
3. Перевірте, чи ендпоінт polski-affiliates зареєстрований

Пов’язані ресурси

• Огляд PRO
• Повідомити про проблему

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Перед впровадженням зверніться до юриста. Polski for WooCommerce - це програмне забезпечення з відкритим кодом (GPLv2), що надається без гарантій.