AffiliateWP Signup Referrals - Плагин WordPress

Руководство по настройке AffiliateWP Signup Referrals для регистраций в WordPress

AffiliateWP Signup Referrals нужен не для обычной комиссии с продажи, а для отдельного сценария: партнёр приводит человека на сайт, человек создаёт учётную запись, и в AffiliateWP появляется реферальная запись за сам факт регистрации. В этом руководстве разберём, где включается add-on, какие типы регистрации он поддерживает, как выбрать статус и сумму вознаграждения, как не получить дубли на checkout и как проверить, что referral создаётся именно после нужного действия.

Материал рассчитан на владельца сайта, вебмастера или маркетолога, который уже использует AffiliateWP и хочет стимулировать не только покупки, но и рост базы пользователей, партнёров, клиентов магазина, участников сообщества или лидов через формы. Здесь не будет инструкций по покупке лицензии или обходу активации. Мы сосредоточимся на работе уже установленного продукта, настройках, проверках, диагностике и решении типичных проблем.

Главный принцип простой: платить за регистрацию стоит только тогда, когда регистрация действительно имеет ценность для бизнеса. Поэтому настройку нужно начинать не с суммы, а с понимания, какой тип учётной записи засчитывается, как он связан с воронкой, где может возникнуть двойной referral и какие данные вы будете проверять после теста.

Какую задачу закрывает add-on и где он полезен

Обычная логика партнёрской программы чаще всего привязана к продаже: посетитель перешёл по ссылке партнёра, купил товар или оформил подписку, после этого в системе появилась комиссия. Signup Referrals меняет точку конверсии. Он позволяет считать результатом не заказ, а создание WordPress-аккаунта через поддерживаемый регистрационный сценарий.

Это важно для проектов, где регистрация сама по себе является ценным действием. Например, сайт может собирать заявки на закрытый каталог, приглашать пользователей в бесплатный курс, развивать личный кабинет перед продажей, набирать партнёров в собственную сеть или отслеживать первичные регистрации в магазине до первой покупки. В таких случаях партнёру можно назначить плоскую сумму за signup, а не процент от заказа, потому что у регистрации нет цены заказа, от которой можно корректно считать процент.

По официальным материалам AffiliateWP, Signup Referrals создаёт referral при нескольких типах действий: регистрация нового affiliate через форму AffiliateWP, регистрация пользователя через WooCommerce, Easy Digital Downloads, Gravity Forms User Registration, Ultimate Member и UserPro. Настройки интеграций показываются только тогда, когда соответствующие плагины есть на сайте и активны. Это снижает риск включить сценарий, которого фактически нет, но требует внимательной проверки после установки.

С практической точки зрения add-on особенно полезен в четырёх ситуациях:

• Сайт набирает новых партнёров и хочет поощрять действующих affiliate за приглашение других участников программы.
• WooCommerce-магазин считает полезной регистрацию клиента до первой покупки, например для последующей цепочки писем, закрытых скидок или работы с личным кабинетом.
• EDD-магазин продаёт цифровые продукты, но хочет отдельно отслеживать создание аккаунта через форму регистрации или checkout.
• Проект использует Gravity Forms User Registration, Ultimate Member или UserPro как главную точку входа для пользователей, участников или лидов.

При этом Signup Referrals не превращает любую форму на сайте в реферальное событие. Если у формы нет создания WordPress-пользователя или она не относится к поддерживаемой интеграции, referral за регистрацию не должен появляться. Для обычных заявок, подписок и лидов лучше смотреть отдельные интеграции AffiliateWP для форм или opt-in сценариев, а не пытаться натянуть signup-логику на действие без учётной записи.

Мини-итог: AffiliateWP Signup Referrals стоит рассматривать как инструмент для регистрации аккаунта, а не как универсальный счётчик всех действий. Сначала определите, какой signup имеет ценность, затем включайте только соответствующий тип регистрации.

Кому подойдёт AffiliateWP Signup Referrals, а кому лучше выбрать другой сценарий

Плагин подойдёт сайтам, где партнёры приводят не только покупателей, но и будущих пользователей. Это может быть магазин с долгим циклом принятия решения, образовательный проект с бесплатным вводным курсом, членский сайт, каталог услуг, SaaS-лендинг на WordPress или партнёрская программа, где важен рост числа зарегистрированных участников.

Хороший кандидат для внедрения - проект, в котором есть понятная связь между регистрацией и будущей ценностью пользователя. Если вы знаете, что часть зарегистрированных клиентов позже покупает, проходит обучение, оставляет заявку или приглашает других участников, плоская комиссия за signup может быть удобным мотиватором. В этом случае add-on помогает расширить партнёрскую механику за пределы "продажа или ничего".

Не лучший сценарий - сайт, где регистрация открыта всем без фильтра и не несёт бизнес-ценности. Если пользователь может создать пустой аккаунт за несколько секунд, а дальше ничего не происходит, комиссия за signup будет провоцировать шумные регистрации. Для таких проектов важнее сначала настроить подтверждение email, модерацию affiliate-заявок, защиту форм и аналитику качества пользователей.

Есть и промежуточный вариант. Например, вы хотите платить за регистрацию, но только после ручной проверки нового affiliate. В этом случае нужно учитывать настройку статуса и логику approval: если на сайте включено требование одобрения партнёров, создание referral для affiliate registration может быть отложено до утверждения. Это не ошибка, а ожидаемое поведение, которое защищает программу от оплаты неподтверждённых заявок.

Когда add-on особенно уместен

Используйте Signup Referrals, если вам нужно отделить ценность регистрации от ценности покупки. На практике это удобно для бесплатного входа в платную воронку, регистрации в личном кабинете, создания профиля участника, вступления в affiliate-программу или отдельной формы User Registration через Gravity Forms.

В таких сценариях лучшая настройка - отдельная сумма для каждого типа регистрации. Регистрация клиента WooCommerce, заявка нового affiliate и форма участника через Gravity Forms обычно имеют разную ценность. Одинаковая комиссия для всех типов часто приводит к неверной мотивации: партнёрам выгоднее гнать самый дешёвый signup, даже если бизнесу важнее другой.

Когда стоит ограничиться обычными referral-событиями

Если бизнес платит только за реальные продажи, лучше оставить стандартные интеграции WooCommerce, Easy Digital Downloads или формы с типом referral, который соответствует оплате или лиду. Signup Referrals не заменяет продажные комиссии, recurring-комиссии или checkout-сценарии, где покупатель выбирает affiliate вручную. Это отдельный слой: "вознаграждение за создание аккаунта".

Также не стоит включать все типы регистрации "на всякий случай". Каждый включённый тип создаёт дополнительную точку оплаты. Чем больше точек оплаты, тем внимательнее нужно тестировать дубли, статусы и качество пользователей.

Что проверить перед установкой и включением

Перед установкой add-on полезно пройти короткую подготовку. Она экономит больше времени, чем последующая диагностика, потому что большинство ошибок в signup referral-сценариях связано не с самим add-on, а с тем, что на сайте не создана нужная регистрационная точка, не работает tracking cookie, включены конфликтующие интеграции или не продуман статус referral.

Базовые условия

Сначала убедитесь, что на сайте установлен и активен AffiliateWP, а основная партнёрская программа уже работает: есть активный affiliate, реферальная ссылка, визиты появляются в AffiliateWP » Visits, а обычные referrals создаются в поддерживаемых интеграциях. Если базовое отслеживание не работает, add-on для регистраций тоже не даст надёжного результата.

Дальше проверьте, какой регистрационный путь вы собираетесь учитывать:

• Для affiliate registration должна быть включена регистрация affiliate в настройках AffiliateWP, а форма должна выводиться через блок, [affiliate_registration] или [affiliate_area].
• Для WooCommerce нужна активная регистрация пользователей на странице My Account или во время checkout, если вы хотите учитывать именно этот путь.
• Для Easy Digital Downloads нужна форма регистрации аккаунта или включённое создание аккаунта на checkout.
• Для Gravity Forms нужен сценарий User Registration, а не просто контактная форма без создания пользователя.
• Для Ultimate Member и UserPro нужно проверить, что регистрация действительно создаёт WordPress-пользователя и проходит через поддерживаемую интеграцию.

Что лучше решить заранее

До включения продумайте статус и сумму. Статус Pending удобен, если нужно сначала проверить качество регистрации, одобрить affiliate, отсеять тесты или дождаться внутренней проверки. Статус Unpaid быстрее попадает в рабочую очередь выплат, но требует уверенности, что signup уже можно считать валидным. В документации AffiliateWP отдельно подчёркивается, что pending referrals не попадают в видимые earnings и отчёты как подтверждённые, пока не будут переведены дальше.

Сумма должна быть плоской и реалистичной. Signup Referrals не поддерживает процентную ставку для своего события, потому что регистрация не содержит суммы заказа. Если вы хотите стимулировать покупки, используйте обычную комиссию продаж. Если хотите стимулировать новую учётную запись, задавайте отдельный flat amount для соответствующей регистрации.

Наконец, проверьте кеш и оптимизацию. AffiliateWP использует cookies affwp_ref, affwp_ref_visit_id и при кампаниях affwp_campaign. Если кеш, CDN или оптимизатор скриптов мешают cookies, visit может не появиться, а signup referral не будет к чему привязать. Для страниц affiliate area, registration, login и checkout обычно безопаснее настроить исключения из кеша и отдельно проверить cookie после перехода по реферальной ссылке.

Установка и первичная проверка без лишнего риска

После подготовки можно переходить к установке. В рамках этого руководства мы не разбираем покупку, ключи и доступ к платным файлам. Практическая часть начинается с ситуации, когда AffiliateWP уже установлен, а add-on доступен в вашем админ-разделе или загружен как ZIP-файл.

Общий порядок установки

1. Откройте админ-панель WordPress под учётной записью с правами установки плагинов.
2. Установите и активируйте add-on AffiliateWP Signup Referrals обычным способом для WordPress-плагинов.
3. Проверьте, что нужные интеграционные плагины уже активны: WooCommerce, Easy Digital Downloads, Gravity Forms User Registration, Ultimate Member или UserPro.
4. Перейдите в AffiliateWP » Settings » Integrations и найдите блок Signup Referrals.
5. Пока не включайте все типы сразу. Начните с одного сценария, который проще всего протестировать.

Такая последовательность снижает риск смешать несколько событий. Если сразу включить WooCommerce registration, affiliate registration и Gravity Forms User Registration, а потом получить два referral за один тест, будет сложнее понять, какой конкретно путь сработал.

Быстрая техническая проверка

Перед первым реальным тестом создайте отдельного тестового affiliate или используйте существующего, но не тестируйте под той же учётной записью, которая является affiliate. По умолчанию AffiliateWP блокирует self-referrals, поэтому проверка "я сам перешёл по своей ссылке и сам зарегистрировался" может закончиться отсутствием referral, хотя настройка исправна.

Правильнее открыть реферальную ссылку в другом браузере, в приватном окне или на отдельном тестовом профиле. После перехода проверьте AffiliateWP » Visits. Если visit не записался, не переходите к регистрации: сначала проверьте cookies, кеш, блокировщики и JavaScript-ошибки. Signup Referrals создаёт referral на основе реферального контекста, и без visit вы будете диагностировать не тот слой.

Проверка перед настройкой: переход по ссылке affiliate должен создать visit, а в браузере должны быть видны cookies AffiliateWP. Только после этого имеет смысл проверять регистрацию и referral.

Настройка типов регистрации, статусов и сумм

Основная настройка AffiliateWP Signup Referrals находится в AffiliateWP » Settings » Integrations. В этом разделе появляются флажки для поддерживаемых типов регистрации. Важная деталь: интеграции обычно показываются только при активном соответствующем плагине. Если вы не видите нужный вариант, сначала проверьте, установлен ли сам WooCommerce, EDD, Gravity Forms User Registration или другой связанный компонент.

Referral Types: включайте только нужные события

В блоке referral types выберите регистрацию, которую хотите оплачивать. Для первого запуска лучше ограничиться одним типом. Например, если ваша цель - платить affiliate за регистрацию новых партнёров, включите Affiliate Registration. Если цель - рост клиентской базы магазина, начните с WooCommerce Registration. Если вы собираете участников через форму Gravity Forms User Registration, включайте именно этот вариант.

Не путайте registration referral с обычными form referrals. В Gravity Forms есть отдельная интеграция AffiliateWP для form submission, где можно выбирать тип referral и суммы по форме. Signup Referrals нужен именно там, где отправка формы создаёт WordPress-пользователя через User Registration. Если на одной и той же форме включить несколько механизмов referral, можно получить дубли или разную логику статусов.

Amount: задавайте flat amount по ценности регистрации

После включения конкретной интеграции появляется поле суммы для этого типа регистрации. Документация AffiliateWP описывает именно отдельные flat amounts по интеграциям. Это удобно: регистрация нового affiliate может стоить условно больше, чем обычная регистрация клиента, а регистрация через форму заявки может иметь собственную экономику.

Не начинайте с максимальной мотивации. Для нового сценария разумнее поставить осторожную сумму, оставить status Pending, собрать первые тестовые данные и посмотреть качество регистраций. Если вы поставите сумму 0, referral может всё равно создаваться как запись с нулевой суммой, но тогда проверьте настройку Ignore Referrals with Zero Amounts в AffiliateWP. Если такие referrals игнорируются, нулевые тесты могут не появляться в списке, и это будет выглядеть как ошибка add-on.

Для первого теста

Для первого теста выбирайте небольшую ненулевую сумму и один тип регистрации. Так вы проверите саму цепочку tracking без риска перепутать нулевые referrals, несколько интеграций и разные статусы.

Referral Status: когда выбирать Pending, а когда Unpaid

Pending выбирайте для открытых регистраций, ручного approval, потенциально спорных лидов, бесплатных аккаунтов и тестового запуска. Такой статус помогает не смешивать новые регистрации с уже подтверждёнными выплатами. Unpaid уместен там, где регистрация сама по себе уже считается валидным результатом и вы готовы включать её в будущий payout без дополнительной проверки.

Для affiliate registration статус особенно важен. Если включено требование approval, referral за приглашённого affiliate может появиться только после одобрения нового партнёра. Это защищает от ситуации, когда партнёр получает оплату за заявку, которая затем отклоняется.

Для рабочего режима

После тестов можно оставить Pending для сценариев с ручной проверкой и перевести более надёжные регистрации в Unpaid. Главное - не смешивать эти режимы без правила, иначе affiliate не поймёт, почему одни регистрации видны как готовые к выплате, а другие ждут review.

WooCommerce и EDD: защита от дублей на checkout

Для WooCommerce и Easy Digital Downloads есть отдельный риск: человек может одновременно создать аккаунт и оформить покупку. Тогда один и тот же переход affiliate способен породить signup referral и обычный checkout referral. В документации Signup Referrals для таких случаев предусмотрены параметры WooCommerce - Disable Checkout Referral и EDD - Disable Checkout Referral.

Если вы хотите платить только за регистрацию, включите disable checkout referral для соответствующей интеграции. Если хотите платить отдельно за регистрацию и отдельно за заказ, оставьте оба события, но заранее примите это как осознанную модель вознаграждения. В большинстве магазинов безопаснее начинать с предотвращения дублей, а потом расширять схему после проверки экономики.

Как работает связка "переход affiliate -> регистрация -> referral"

Чтобы правильно настроить и диагностировать add-on, полезно понимать цепочку. Визит начинается с реферальной ссылки. AffiliateWP сохраняет данные affiliate в cookie и записывает visit. Затем пользователь проходит один из поддерживаемых регистрационных сценариев. Если этот сценарий включён в Signup Referrals и условия совпали, в AffiliateWP » Referrals появляется referral с выбранной суммой и статусом.

Почему visit важнее первого взгляда на referral

Когда referral не появляется, многие сразу проверяют поле суммы или статус. Но первый слой - tracking. Если cookies не записались, Signup Referrals не узнает, какому affiliate назначать signup. Поэтому в тестовом сценарии всегда проверяйте три уровня: cookies в браузере, запись visit в админ-панели, затем запись referral после регистрации.

AffiliateWP считает unique visits, а не каждый клик или просмотр страницы. Поэтому повторный переход по той же ссылке в том же браузере может не создать новую строку visit, пока cookie активна. Это не означает, что tracking сломан. Для чистого теста удалите cookies или используйте новый браузерный профиль.

Почему автоматическая регистрация пользователя как affiliate не равна signup referral

В настройках AffiliateWP есть режим автоматической регистрации новых user accounts как affiliates. Документация Signup Referrals отдельно указывает, что такой режим сам по себе не создаёт signup referral. Это важное ограничение: add-on реагирует на конкретные поддерживаемые registration methods, а не на любое последующее превращение пользователя в affiliate.

Если ваша логика строится на автоматическом превращении всех пользователей в affiliates, проверьте, нужен ли вам Signup Referrals вообще. Возможно, цель лучше закрывается обычным affiliate registration, ручным approval или отдельной формой регистрации партнёра.

Практический пример: вознаграждение за регистрацию нового affiliate

Разберём предметный сценарий. У сайта уже есть партнёрская программа, и действующие affiliates приглашают новых партнёров. Владелец хочет назначать плоское вознаграждение за каждого приглашённого affiliate, но выплачивать его только после одобрения заявки. Это один из самых чистых сценариев для Signup Referrals, потому что регистрация affiliate напрямую связана с ростом партнёрской сети.

Цель

Получить referral в AffiliateWP, когда новый человек пришёл по ссылке действующего affiliate и зарегистрировался через форму affiliate registration. Referral должен быть связан с пригласившим affiliate, иметь заранее выбранную сумму и не попадать в выплату до проверки, если используется approval.

Подготовка

• В AffiliateWP есть активный affiliate, который может сгенерировать referral URL.
• На сайте включена регистрация affiliate через блок Affiliate Registration, [affiliate_registration] или страницу [affiliate_area].
• В настройках AffiliateWP » Settings » Affiliates продуман режим Require Approval, если заявки нужно проверять вручную.
• Кеш не мешает cookies AffiliateWP на страницах регистрации и affiliate area.

Шаги настройки

1. Перейдите в AffiliateWP » Settings » Integrations.
2. В блоке Signup Referrals включите Affiliate Registration.
3. Укажите flat amount для регистрации нового affiliate.
4. Выберите статус Pending, если новый affiliate должен быть одобрен перед учётом выплаты.
5. Сохраните изменения через Save Changes.
6. Откройте реферальную ссылку действующего affiliate в отдельном браузере.
7. Проверьте visit в AffiliateWP » Visits.
8. Заполните affiliate registration form новым email и отправьте заявку.
9. Если включён approval, одобрите нового affiliate и затем проверьте referral.

Ожидаемый результат и проверка

В AffiliateWP » Referrals должна появиться запись с выбранной суммой и статусом. В edit screen нового affiliate должен быть виден ID referring affiliate, если регистрация проходила как affiliate registration. Если запись не появилась сразу при включённом approval, сначала проверьте статус нового affiliate: referral может быть отложен до утверждения.

Нюанс тестирования: не проверяйте сценарий в той же учётной записи, которая является приглашающим affiliate. Для чистого теста используйте отдельный браузер, новый email и заранее очищенные cookies.

Практичные идеи применения для разных регистрационных воронок

Signup Referrals можно применять не только как "бонус за партнёра". Сильнее всего add-on раскрывается там, где регистрация является понятным промежуточным результатом в воронке. Ниже - несколько сценариев, которые можно адаптировать без выдумывания дополнительных функций продукта.

WooCommerce: клиентский аккаунт как первый шаг к покупке

Для магазина регистрация может быть важна, если вы строите повторные продажи через личный кабинет, закрытые предложения, историю заказов или клиентские письма. В этом сценарии включайте WooCommerce Registration, назначайте умеренный flat amount и обязательно решайте вопрос с checkout referral. Если регистрация и покупка происходят одновременно, вы должны заранее выбрать, платите ли за оба события или только за одно.

Проверка результата проста: affiliate приводит пользователя, пользователь создаёт аккаунт на My Account или checkout, а в referrals появляется запись именно за registration. Если появляется ещё и referral за покупку, это не всегда ошибка. Ошибкой это станет только тогда, когда вы не планировали двойное вознаграждение.

Easy Digital Downloads: аккаунт перед доступом к цифровому продукту

Для EDD registration referral удобен, если пользователь сначала создаёт аккаунт, получает доступ к бесплатному материалу, демо, закрытому разделу или будущим загрузкам. Если регистрация идёт через shortcode регистрации, можно отделить signup referral от покупки. Если аккаунт создаётся прямо на checkout, снова проверьте параметр отключения checkout referral.

В этой воронке полезно держать статус Pending на старте. Так вы увидите, какие affiliates приводят реальные аккаунты, а какие дают много пустых регистраций без последующего действия.

Gravity Forms User Registration: форма лида с созданием пользователя

Gravity Forms User Registration подходит для кастомных анкет: заявка на обучение, членство, доступ к демо, профиль специалиста, предварительная регистрация в сервисе. Signup Referrals работает именно с User Registration, поэтому обычная контактная форма без создания пользователя не заменяет этот сценарий.

Если на сайте параллельно используются Affiliate Forms for Gravity Forms или Affiliate Forms for Ninja Forms, внимательно проверьте пересечение. Официальная документация Signup Referrals рекомендует отключать affiliate registration referral type, если другой form-based механизм уже создаёт referral, чтобы избежать дублей. Это тот случай, где "больше включённых галочек" ухудшает качество данных.

Сообщество или membership-сайт: качество важнее количества

Для community и membership-проектов регистрация часто ценна, но качество пользователей отличается сильнее, чем в магазине. Здесь лучше начинать с Pending, включить подтверждение email или ручную модерацию там, где это уместно, и анализировать не только количество signup referrals, но и дальнейшие действия пользователя: входы, заполнение профиля, участие, покупка доступа или прохождение onboarding.

Signup Referrals фиксирует событие регистрации. Он не решает задачу оценки качества участника сам по себе. Поэтому для таких проектов полезно совместить referral-логику с внутренней CRM, списком пользователей, сегментами email-маркетинга или ручным review.

Проверка результата после настройки

Проверка должна быть такой же структурированной, как настройка. Если просто отправить форму и посмотреть "появилось или нет", легко пропустить неверный affiliate, неправильный статус, дубли или проблему с cookie. Лучше пройти цепочку от ссылки до записи referral.

Тестовый сценарий по шагам

1. Скопируйте referral URL активного affiliate из affiliate area или сформируйте ссылку с параметром ?ref=ID.
2. Откройте ссылку в браузере без старых cookies AffiliateWP.
3. Проверьте cookies affwp_ref и affwp_ref_visit_id через инструменты разработчика браузера.
4. Откройте AffiliateWP » Visits и убедитесь, что visit записался.
5. Пройдите выбранную регистрацию: affiliate form, WooCommerce, EDD или Gravity Forms User Registration.
6. Проверьте AffiliateWP » Referrals: сумма, статус, referring affiliate, context и reference должны соответствовать сценарию.
7. Если тест был через checkout, проверьте, нет ли нежелательного второго referral за покупку.
8. Если статус Pending, вручную переведите тестовую запись в нужное состояние только после проверки качества.

Что смотреть в списке Referrals

В первую очередь смотрите не только сумму. Важнее понять, правильно ли выбран affiliate и не смешался ли signup referral с sale referral. Если доступна колонка reference или context, используйте её для привязки к конкретному пользователю, заказу, форме или интеграции. Для Gravity Forms обычная интеграция связывает reference с entry ID, но в signup-сценарии проверяйте также создание WordPress-пользователя.

Если referral стоит в Pending, он может не отображаться в affiliate dashboard как заработок и не попадать в отчёты как подтверждённая сумма. Это нормальная часть жизненного цикла referral. Не меняйте статус на Unpaid только ради того, чтобы "увидеть сумму", пока не закончена проверка.

Безопасные улучшения: кеш, Cloudflare и читаемая форма регистрации

У Signup Referrals мало смысла дорабатывать кодом сам add-on. Большинство безопасных улучшений находится вокруг него: исключить страницы регистрации из агрессивного кеша, убедиться в cookies, сделать форму понятнее и не создавать дублирующие referral-механики.

Исключения для кеша и cookies

Если сайт использует WP Rocket, LiteSpeed Cache, W3 Total Cache, NitroPack или CDN, проверьте исключения для страниц affiliate area, registration, login, WooCommerce account и checkout. В документации AffiliateWP для кеша отдельно перечисляются cookies affwp_ref, affwp_ref_visit_id и affwp_campaign, которые нужно учитывать в правилах bypass или exclusions.

После изменения правил всегда очищайте кеш и повторяйте тест с новым браузерным профилем. Старые cookies и старые cache entries часто создают ложное ощущение, что настройка не изменилась.

Официальный snippet для совместимости cookie names

Если ваш сайт использует Cloudflare или среду, где нужны совместимые имена cookies, в официальной документации AffiliateWP приведён фильтр для compatibility mode. Вставляйте такой код только через дочернюю тему или безопасный менеджер snippets, не редактируйте ядро WordPress или файлы плагина.

add_filter( 'affwp_tracking_cookie_compat_mode', '__return_true' );

После включения проверьте, что в браузере появляются prefixed cookies, например wp_affwp_ref. Если вы не используете Cloudflare, Pantheon или похожий слой, не включайте compatibility mode просто "для улучшения". Любое изменение tracking-логики должно иметь понятную причину и тест до/после.

Форма регистрации должна объяснять ценность действия

Если вы платите affiliate за регистрацию, страница signup должна быть понятной для пользователя. Для AffiliateWP registration form используйте блок Affiliate Registration или shortcode, а поля настраивайте так, чтобы человек понимал, зачем он регистрируется. Если вы используете Gravity Forms User Registration, проверьте обязательный email, username и password-логику. Документация Affiliate Forms for Gravity Forms отдельно предупреждает, что отсутствие password field может привести к менее удобному onboarding через сброс пароля.

Это не визуальная мелочь. Чем яснее форма, тем меньше мусорных регистраций и меньше спорных referrals, которые затем приходится отклонять вручную.

Почему signup referral не появился или сработал дважды

Диагностику лучше вести от tracking-слоя к регистрационному событию. Если начать с переустановки add-on, можно потратить время и не заметить, что cookies не пишутся из-за кеша, пользователь тестирует self-referral или включены два разных механизма referral на одном checkout.

Referral не создаётся после регистрации

Симптом: пользователь прошёл регистрацию, но в AffiliateWP » Referrals нет новой записи. Возможная причина - не было visit, cookies не сохранились, выбранный тип регистрации не включён или форма не создаёт WordPress-пользователя.

Проверьте cookies affwp_ref и affwp_ref_visit_id, затем AffiliateWP » Visits. Если visit отсутствует, настройте кеш, CDN, блокировщики и JavaScript-ошибки. Если visit есть, проверьте, включён ли именно тот registration type, через который проходил пользователь.

Быстрая развилка

Если нет visit, проблема почти наверняка в tracking-слое. Если visit есть, но referral не создан, переходите к registration type, статусу, форме и zero amount настройке.

Настройка интеграции не отображается

Симптом: в AffiliateWP » Settings » Integrations нет нужного варианта, например WooCommerce Registration или Gravity Forms User Registration. Чаще всего соответствующий плагин не активен, не настроен или выбран не тот сценарий формы.

Активируйте нужный плагин и проверьте, что он реально создаёт user account. Для Gravity Forms нужна User Registration-логика, а не просто форма заявки. После активации обновите страницу настроек и сохраните конфигурацию заново.

Появились два referral за один checkout

Симптом: при WooCommerce или EDD checkout создаётся referral за регистрацию и referral за покупку. Это ожидаемо, если одновременно включены signup referral и checkout/sale referral.

Решение зависит от бизнес-правила. Если вы не хотите платить дважды, включите WooCommerce - Disable Checkout Referral или EDD - Disable Checkout Referral в Signup Referrals. Если двойная оплата задумана, оставьте оба события, но фиксируйте это в правилах партнёрской программы, чтобы выплаты не выглядели случайными.

Referral висит в Pending и не виден affiliate как заработок

Симптом: запись есть в админке, но affiliate не видит сумму как подтверждённый заработок. По документации AffiliateWP pending referrals не считаются подтверждёнными earnings и не попадают в отчётность как готовые выплаты.

Проверьте выбранный default status для Signup Referrals. Если вы намеренно используете Pending, вручную переводите качественные регистрации в Unpaid после проверки. Если проверка не нужна, измените статус для будущих signup referrals на Unpaid, но не забывайте, что старые записи уже нужно обработать отдельно.

Тест срабатывает не так, как у реального пользователя

Симптом: в одном браузере всё работает, в другом нет, или тест под администратором не создаёт referral. Возможные причины - старые cookies, self-referral, logged-in состояние, кеш страницы или уже существующий affiliate account.

Повторите тест в отдельном браузере, с новым email, после очистки cookies. Не используйте аккаунт приглашающего affiliate как регистрируемого пользователя. Если форма affiliate registration не видна logged-in пользователю, проверьте её в режиме гостя или под отдельной учётной записью.

Zero amount referral не появляется

Симптом: вы поставили сумму 0 для теста или lead tracking, но referral не записался. Проверьте настройку Ignore Referrals with Zero Amounts в AffiliateWP » Settings » Commissions. Если она включена, нулевые referrals могут игнорироваться.

Для теста лучше использовать небольшую ненулевую сумму или временно отключить игнорирование zero amount, если это соответствует вашей политике. После теста верните настройку в нужное состояние.

Ограничения и решения, которые важно не перепутать

Signup Referrals решает узкую задачу, и это его плюс. Но из-за близости терминов его легко спутать с другими возможностями AffiliateWP. Ошибки выбора инструмента часто приводят к сложной схеме, которую потом трудно объяснить партнёрам.

Если вам нужно платить за повторные платежи подписки, смотрите Recurring Referrals, а не Signup Referrals. Если покупатель должен сам выбрать affiliate на checkout, это сценарий Checkout Referrals. Если нужно платить за отправку формы без создания пользователя, проверьте интеграцию формы. Если задача - показать affiliate отдельные вкладки dashboard, это вообще другой add-on с shortcodes.

Signup Referrals также не оценивает качество регистрации, не подтверждает email, не предотвращает недобросовестные заявки и не заменяет модерацию affiliate. Он создаёт referral при поддерживаемом signup-событии. Всё, что связано с качеством пользователя, нужно закрывать настройками WordPress, формы, AffiliateWP approval, антиспам-защитой и внутренними правилами программы.

С точки зрения скорости add-on обычно не должен быть главным источником нагрузки, потому что срабатывает на конкретном событии регистрации. Но страницы регистрации, affiliate area и checkout чувствительны к кешу и оптимизации. Не пытайтесь ускорить их агрессивным полным кешированием, если после этого ломается tracking.

Когда AffiliateWP Signup Referrals будет удачным выбором

AffiliateWP Signup Referrals стоит использовать, когда вы можете ясно ответить на три вопроса: какая регистрация ценна, кто получает вознаграждение и как вы проверяете результат. Если ответы есть, add-on даёт аккуратный способ добавить в партнёрскую программу не только продажи, но и рост пользовательской базы.

Для первого запуска выберите один тип регистрации, поставьте понятный flat amount, начните со статуса Pending, проверьте cookies и visits, затем проведите тестовую регистрацию в отдельном браузере. После этого смотрите на referral: affiliate, сумма, статус, context и отсутствие дублей должны совпасть с вашим сценарием. Только после такого теста имеет смысл расширять схему на WooCommerce, EDD, Gravity Forms User Registration или другие поддерживаемые пути.

Если вам нужен именно этот сценарий и основной AffiliateWP уже используется на сайте, можно получить файл AffiliateWP Signup Referrals и проверить add-on на staging-копии или тестовой воронке. Не начинайте с боевой выплаты за все регистрации сразу: сначала докажите, что tracking, status и суммы работают так, как ожидает ваша партнёрская программа.