> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/marketing/partnyorskaya-programma.md).

# Партнёрская программа

Инструкция по настройке партнерской программы

Партнёрская программа определяет условия вознаграждения за обмены приглашённых клиентов. Партнёр распространяет свою реферальную ссылку, привлекает новых клиентов и получает бонусы за их успешно завершённые обмены.

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

### Валюта партнёрских начислений

Вознаграждения рассчитываются в основной валюте системного баланса. Она также определяет валюту гарантированного минимума программы и минимальной суммы для запроса выплаты.

Перед настройкой денежных условий откройте: **«Настройки» — «Общие настройки»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fr5C6XW5d75lD54LMR4qd%2Fimage.png?alt=media&amp;token=de3d7fc6-08cc-4dbd-8685-5f8dffc7f981" alt=""><figcaption></figcaption></figure>

Перейдите на вкладку «Баланс системы» и проверьте «Основная валюта баланса». Если клиент отдаёт другую валюту, для процентного расчёта потребуется её пересчёт в валюту баланса.

Например, при основной валюте USDT гарантированное начисление 0.20 означает 0.20 USDT. На установке с другой основной валютой та же запись задаёт сумму в выбранной валюте.

{% content-ref url="/pages/iQ0Q1S2FO1IBlTW1yEWg" %}
[Баланс системы](/guide/nastroiki/obshie-nastroiki/balans-sistemy.md)
{% endcontent-ref %}

***

## Список программ

В панели управления откройте: **«Партнёрам» — «Реферальные программы»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FB6f1Tjw8q2u5ZT6Z6m4S%2Fimage.png?alt=media&amp;token=d791cc4e-0cc5-4790-bf30-7e0bd90195d3" alt=""><figcaption></figcaption></figure>

Метка «По умолчанию» обозначает программу, выбранную в общих настройках для новых партнёрских ссылок.

«Отключено» в колонке «Мин. начисление» означает, что гарантированный минимум равен нулю. Это не признак отключённой программы.

«Без срока» в колонке «Срок» означает отсутствие собственного срока программы. В этом случае используется срок из общих настроек партнёров.

Для создания программы нажмите «Добавить». Общие параметры открываются через кнопку с шестерёнкой «Настройки партнёров».

## Добавление программы

Нажмите «Добавить». Откроется окно «Добавить программу» с пятью полями, описанными ниже.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FMvqZUGiyVDIKef8Th15v%2Fimage.png?alt=media&amp;token=32557117-e7ab-44fd-9002-f763ce3fd0b5" alt=""><figcaption></figcaption></figure>

Эти поля задают условия конкретной программы. Общий способ расчёта и разрешение начислений настраиваются отдельно после её создания.

### Название программы

Укажите название, по которому программу можно отличить от остальных при просмотре списка и назначении партнёру. Например, «Стандартная» или «Партнёры с повышенным вознаграждением».

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

Упоминание процента в названии не устанавливает этот процент. Для расчёта используется отдельное поле «Процент партнёра».

### Описание

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

Например, для программы с вознаграждением от суммы обмена:

> Вознаграждение составляет 0.5% от расчётной суммы успешно завершённого обмена приглашённого клиента. Гарантированный минимум за одну подходящую заявку — 0.20 USDT. При расчёте учитываются условия направления обмена.

Такое описание подходит только для программы с соответствующими настройками. Текст помогает понимать условия в списке, но сам не участвует в расчёте бонуса.

Описание заполняется по языкам. Значение на основном языке обязательно.

### Процент партнёра

Укажите размер процентного вознаграждения не меньше 0. Вводите число без знака процента. Для дробной части используйте точку.

<table><thead><tr><th width="182.9921875">Что ввести</th><th>Какой процент используется</th></tr></thead><tbody><tr><td>0.5</td><td>0.5% — половина одного процента</td></tr><tr><td>1</td><td>1% — один процент</td></tr><tr><td>20</td><td>20% — двадцать процентов</td></tr></tbody></table>

Значение 0.5 не означает 50%. В поле вводится сам процент: чтобы назначить двадцать процентов, нужно указать 20, а не 0.20.

Размер бонуса зависит от того, к какой сумме применяется процент. Это определяется полем **«Тип вознаграждений»** в «Настройки партнёров».

{% content-ref url="/pages/TIY3c859sG8UHEvTh39d" %}
[Настройка партнёрских вознаграждений](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-voznagrazhdenii.md)
{% endcontent-ref %}

Числа в примерах условные: они объясняют формулы и не являются рекомендуемыми настройками. В примерах используется процент программы без персональных переопределений, фиксированного вознаграждения, гарантированного минимума и ограничений суммы. Основная валюта баланса — USDT.

{% tabs %}
{% tab title="Расчёт от суммы обмена" %}

#### Для чего используется

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

В общих настройках ему соответствует значение «От суммы обмена» поля «Тип вознаграждений».

Для расчёта берётся итоговая сумма, которую отдаёт клиент, с учётом дополнительной комиссии. Затем она приводится к основной валюте баланса. Ниже эта величина называется расчётной суммой обмена.

Параметры прибыли направления в этом способе не участвуют в процентном расчёте.

#### Формула

**Бонус партнёра = расчётная сумма обмена × процент партнёра ÷ 100.**

#### Пример: 0.5% от обмена на 1000 USDT

Условия:

* расчётная сумма обмена — 1000 USDT;
* в поле «Процент партнёра» указано 0.5;
* в общих настройках выбран способ «От суммы обмена».

Расчёт:

**1000 × 0.5 ÷ 100 = 5 USDT.**

Партнёр получает **5 USDT**. Ставка 0.5% применяется ко всем 1000 USDT расчётной суммы.

#### Пример: обмен в другой валюте

Допустим, итоговая сумма на стороне клиента составляет 100000 RUB, а основная валюта баланса — USDT. Для этого условного примера система пересчитывает 1 RUB в 0.01 USDT.

Сначала рассчитывается сумма в валюте баланса:

**100000 RUB × 0.01 USDT за 1 RUB = 1000 USDT.**

Затем применяется процент программы 0.5:

**1000 × 0.5 ÷ 100 = 5 USDT.**

Партнёр получает **5 USDT**. Курс 0.01 приведён только для объяснения; в работе используется пересчёт, доступный системе для соответствующих валют.
{% endtab %}

{% tab title="Расчёт от прибыли обменника" %}

#### Для чего используется

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

В общих настройках ему соответствует значение «От прибыли в настройках направлений» поля «Тип вознаграждений».

Расчётная сумма обмена определяется так же: итоговая сумма, которую отдаёт клиент, с учётом дополнительной комиссии приводится к основной валюте баланса. Затем по параметрам направления рассчитывается прибыль для начисления партнёрского бонуса.

#### Откуда берётся прибыль

В настройках направления используется блок «Прибыль обменника для партнеров». В нём задаются процентная часть «%» и фиксированная часть «S».

Процентная часть определяет долю расчётной суммы обмена. Фиксированная часть добавляет к полученной прибыли сумму в валюте системного баланса.

**Расчётная прибыль = расчётная сумма обмена × процент прибыли ÷ 100 + фиксированная часть прибыли.**

Прибыль для этого расчёта ограничивается величиной расчётной суммы обмена и не может быть отрицательной.

После этого применяется процент программы:

**Бонус партнёра = расчётная прибыль × процент партнёра ÷ 100.**

#### Пример: 20% от прибыли при обмене на 1000 USDT

Условия:

* расчётная сумма обмена — 1000 USDT;
* в блоке «Прибыль обменника для партнеров» указано 4 в «%» и 0 в «S»;
* в поле программы «Процент партнёра» указано 20;
* в общих настройках выбран способ «От прибыли в настройках направлений».

Сначала рассчитывается прибыль:

**1000 × 4 ÷ 100 = 40 USDT.**

Затем рассчитывается доля партнёра:

**40 × 20 ÷ 100 = 8 USDT.**

Партнёр получает **8 USDT**. Значение 4 задаёт процент прибыли направления, а значение 20 — долю партнёра в этой прибыли. В поле программы нужно ввести именно 20.

#### Пример: прибыль с фиксированной частью

Сохраним расчётную сумму 1000 USDT, прибыль 4% и долю партнёра 20%. В поле «S» блока «Прибыль обменника для партнеров» укажем 2.

Процентная часть прибыли:

**1000 × 4 ÷ 100 = 40 USDT.**

Прибыль с фиксированной частью:

**40 + 2 = 42 USDT.**

Вознаграждение партнёра:

**42 × 20 ÷ 100 = 8.40 USDT.**

Партнёр получает **8.40 USDT**. Фиксированная часть 2 USDT добавляется к расчётной прибыли; партнёр получает от неё свою долю.

Поле «S» в блоке прибыли и поле направления «Фиксированная сумма выплаты» выполняют разные задачи. Первое участвует в расчёте прибыли. Второе задаёт само вознаграждение и заменяет процентный расчёт.

{% hint style="info" %}
Для этого способа используется прибыль, заданная в партнёрских настройках направления. Она не становится автоматически фактической чистой прибылью обменного пункта с учётом всех его расходов.

Если обе части прибыли равны нулю, результат процентного расчёта также равен нулю. Положительный гарантированный минимум программы при разрешённом начислении может увеличить этот результат.
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Процент и способ расчёта нужно выбирать вместе. При расчётной сумме 1000 USDT значение 20 даст **200 USDT** в режиме «От суммы обмена» и **8 USDT** в режиме «От прибыли в настройках направлений», если расчётная прибыль составляет 40 USDT.

Изменение общего способа расчёта затрагивает партнёров, которые используют эту общую настройку. Назначение другой программы само по себе способ расчёта не переключает.
{% endhint %}

#### Что может изменить итоговый бонус

У партнёра, направления или отдельной заявки могут быть условия, заменяющие процент программы. Фиксированная выплата направления заменяет процентный расчёт, а ограничения процента и суммы могут изменить результат.

Поэтому колонка «Процент» в списке показывает значение самой программы, а не гарантированный итог для любой заявки.

Значение 0 в поле программы допустимо. Оно обнуляет её собственный процент, но не отключает всю партнёрскую систему: персональные условия, фиксированная выплата или гарантированный минимум могут сохранить положительное начисление.

Порядок настройки вознаграждений и связанные параметры разобраны отдельно:

{% content-ref url="/pages/TIY3c859sG8UHEvTh39d" %}
[Настройка партнёрских вознаграждений](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-voznagrazhdenii.md)
{% endcontent-ref %}

### Срок действия (минуты)

Поле определяет срок хранения информации о партнёре в браузере нового посетителя после перехода по реферальной ссылке. Эта информация сохраняется в cookie — небольшой записи в браузере — и используется при регистрации клиента.

Укажите целое количество минут. Чтобы перевести дни в минуты, умножьте количество дней на 24 и на 60.

Например, для 30 дней: **30 × 24 × 60 = 43200 минут.**

В поле нужно ввести 43200.

Для быстрого заполнения доступны три кнопки:

<table><thead><tr><th width="209.83203125">Кнопка</th><th>Устанавливаемый срок</th></tr></thead><tbody><tr><td>«5 мес»</td><td>150 дней — 216000 минут</td></tr><tr><td>«1 год»</td><td>365 дней — 525600 минут</td></tr><tr><td>«3 года»</td><td>1095 дней — 1576800 минут</td></tr></tbody></table>

Положительное значение программы имеет приоритет перед общим сроком. Если в программе указано 43200, для неё используется срок 30 дней даже при общем режиме «Без ограничения по времени».

Пустое поле или значение 0 означает использование общих настроек «Срок жизни реферала». При варианте «Ограничить по времени» срок берётся из поля «Время жизни cookie (в днях)».

{% hint style="info" %}
Срок cookie не ограничивает период начислений за уже зарегистрированного приглашённого клиента. После регистрации связь клиента с партнёром сохраняется в системе; окончание cookie само по себе эту связь не удаляет.
{% endhint %}

### Минимальное гарантированное начисление

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

Валюта указана рядом с названием поля. Например, при надписи «Минимальное гарантированное начисление (USDT)» значение 0.20 означает 0.20 USDT.

Вводите неотрицательное число без обозначения валюты. Для дробной части используется точка; допускается не более четырёх знаков после неё.

#### Пример работы гарантии

Допустим, партнёр получает 0.5% от суммы обмена, а в этом поле указано 0.20. Основная валюта баланса — USDT. Других денежных ограничений в примере нет.

При расчётной сумме обмена 10 USDT процентный бонус составит: **10 × 0.5 ÷ 100 = 0.05 USDT.**

Он меньше гарантии, поэтому партнёру начисляется **0.20 USDT**.

При расчётной сумме обмена 150 USDT: **150 × 0.5 ÷ 100 = 0.75 USDT.**

Сумма выше гарантии, поэтому партнёр получает **0.75 USDT**. Гарантия не прибавляется к бонусу и не уменьшает результат, который уже выше минимума.

#### Ноль и ограничения направления

Значение 0 отключает гарантию программы. В первом примере при нулевой гарантии и отсутствии других ограничений начисление составит 0.05 USDT.

Если гарантия включена, более высокий минимум направления усиливает её. При гарантии программы 0.20 USDT и значении «Мин. сумма выплаты» направления 0.50 USDT минимальное начисление составит 0.50 USDT.

{% hint style="warning" %}
Гарантированный минимум применяется после максимальной суммы направления и может увеличить бонус выше неё. Например, при максимуме направления 0.10 USDT и гарантии программы 0.20 USDT итог может составить 0.20 USDT. Согласуйте эти ограничения перед использованием программы.
{% endhint %}

Гарантия может повысить даже нулевой результат расчёта, но не заменяет разрешение начислений и не создаёт отсутствующую связь между клиентом и партнёром.

«Минимальное гарантированное начисление» относится к одному обмену. Общая настройка «Минимальная выплата» определяет, с какого доступного баланса партнёр сможет запросить вывод средств.

***

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

Созданную программу нужно назначить участникам. Для начислений также должны быть включены партнёрская система и вознаграждения по нужным направлениям.

### Условия направления обмена

Откройте: **«Основное» — «Направление обмена» — «Список направлений»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fjiw2jHA16V2ZBfN6Z8Xk%2Fimage.png?alt=media&amp;token=7dea9f8f-52f6-490b-837e-0128a377361b" alt=""><figcaption></figcaption></figure>

Откройте редактирование нужного направления. В категории «Дополнительное» выберите «Партнерская программа».

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FrXd0aVTj0m7XhzJKzbKv%2Fimage.png?alt=media&amp;token=dfcfac93-4f82-4f33-b124-afc6b2108af2" alt=""><figcaption></figcaption></figure>

Для начислений по этому направлению в поле **«Партнерские вознаграждения»** должно быть выбрано «Да». Значение «Нет» запрещает начисления по направлению независимо от процента программы.

Для способа «От прибыли в настройках направлений» задайте параметры блока «Прибыль обменника для партнеров». Для обычного процентного расчёта поле «Фиксированная сумма выплаты» должно быть равно 0.

Сохраните изменения через «Сохранить». Условия проверяются отдельно для каждого направления, по которому планируются партнёрские начисления.

Подробная настройка прибыли, фиксированного вознаграждения и ограничений направления:

{% content-ref url="/pages/XBgGc4uYSuRcyGxAnrJs" %}
[Настройка партнёрских программ для отдельных направлений обмена](/guide/marketing/partnyorskaya-programma/nastroika-partnyorskikh-programm-dlya-otdelnykh-napravlenii-obmena.md)
{% endcontent-ref %}

### Общие настройки партнёров

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FPvR2EbMwNRlQmyexmswy%2Fimage.png?alt=media&amp;token=8ecfc5c6-77b5-483e-a8f8-a8f853cc41d0" alt=""><figcaption></figcaption></figure>

Вернитесь к списку программ и откройте «Настройки партнёров».

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FTeilisDE0r27O8Hw8eZ2%2Fimage.png?alt=media&amp;token=ac82d833-08a6-48d8-a789-6dd8a77b2a12" alt=""><figcaption></figcaption></figure>

В поле **«Программа по умолчанию»** выберите созданную программу. Она будет использоваться при создании новых партнёрских ссылок. Существующие партнёры сохраняют ранее назначенные программы.

В поле **«Тип вознаграждений»** выберите «От суммы обмена» или «От прибыли в настройках направлений». Используйте тот способ, для которого рассчитан процент программы.

В поле **«Минимальная выплата»** укажите доступный баланс, начиная с которого партнёр сможет запросить вывод. Сумма задаётся в основной валюте баланса. Например, значение 100 при валюте USDT означает, что запрос выплаты доступен при балансе от 100 USDT. Бонусы меньше этой суммы могут начисляться и накапливаться.

В поле **«Срок жизни реферала»** задайте общий срок хранения информации в cookie. Если срок не нужно ограничивать заданным количеством дней, выберите «Без ограничения по времени». Для ограничения выберите «Ограничить по времени» и заполните «Время жизни cookie (в днях)». Общая настройка используется, когда в самой программе не задан положительный срок в минутах.

Когда условия подготовлены, переведите «Включить реферальную программу» в состояние «Включено» и нажмите «Сохранить настройки».

В списке выбранная программа получит метку «По умолчанию». Повторно откройте настройки и проверьте, что сохранены нужная программа и способ расчёта.

Состояние «Выключено» у общего переключателя останавливает начисление новых бонусов. Созданные программы, ссылки и ранее начисленные средства при этом сохраняются. У отдельной программы собственного переключателя активности нет.

Остальные общие параметры и их настройка описаны на отдельной странице:

{% content-ref url="/pages/AC2l2SiiYcIET21YCvBU" %}
[Настройки партнерской программы](/guide/marketing/partnyorskaya-programma/nastroiki-partnerskoi-programmy.md)
{% endcontent-ref %}

### Назначение программы отдельному партнёру

Чтобы изменить условия действующего партнёра, откройте: **«Пользователи» — «Список пользователей»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FpKlW4pQ9J0svx2STvtPQ%2Fimage.png?alt=media&amp;token=54710b15-3260-475b-a580-bfe8f6afac15" alt=""><figcaption></figcaption></figure>

Откройте карточку партнёра. На вкладке «Основное» найдите блок «Заявки и лимиты · Партнёрство».

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FN8WjnM6UdOcTFk9NXd8S%2Fimage.png?alt=media&amp;token=ca61cfc7-492e-4eb9-989e-4c421026d3ce" alt=""><figcaption></figcaption></figure>

Если партнёр должен использовать процент программы без персональной замены, в поле «Персональный партнерский процент» должно быть 0. Для использования общего способа расчёта в поле «Начисление партнерам бонусов от» должно быть выбрано «По умолчанию».

Эти параметры находятся в карточке партнёра. Индивидуальные условия направления и ограничения всё равно могут повлиять на итоговый бонус.

1. В поле «Реферальная программа» выберите нужную программу.
2. Проверьте персональный процент и способ расчёта с учётом пояснения выше.
3. Проверьте, что для «Реферальные бонусы» выбрано «Выплачивать».
4. Нажмите «Сохранить».
5. Повторно откройте карточку и проверьте назначенную программу и сохранённые условия.

При смене программы существующая реферальная ссылка партнёра сохраняется вместе с привлечёнными клиентами.

Если включена настройка «Разрешить активацию реферальной программы после верификации», для начисления требуется подтверждённый email партнёра. Она находится в **«Настройки» — «Общие настройки»**, на вкладке «Посетители».

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FDeiKA4z1NFp7eEDIaNGJ%2Fimage.png?alt=media&amp;token=6da4c7ad-462c-4644-8455-bfa2b33c03c6" alt=""><figcaption></figcaption></figure>

***

## Проверка начислений

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

Для проверки связи с приглашённым клиентом откройте его карточку в **«Пользователи» — «Список пользователей»**. В поле «Пригласил» должен быть указан нужный партнёр. Это поле показывает, кто пригласил клиента; собственная «Реферальная программа» клиента определяет условия уже его участия как партнёра.

Фактическое начисление проверяйте по успешно завершённой заявке приглашённого клиента. Откройте: **«Журнал событий» — «Лог партнеров»**

На странице «Логи реферальной системы» найдите событие «Начислен бонус партнёру» для нужной заявки. Сверьте участников, заявку, сумму и валюту начисления. Сравните результат с расчётом по программе с учётом условий направления и персональных настроек.

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

Если начисления нет или сумма отличается от ожидаемой, порядок проверки связи клиента, разрешений, валюты, курсов и ограничений приведён в отдельной инструкции:

{% content-ref url="/pages/oncpa956kkB87pjEgjoW" %}
[Почему партнёры не получают бонусы и как это исправить](/guide/marketing/partnyorskaya-programma/pochemu-partnyory-ne-poluchayut-bonusy-i-kak-eto-ispravit.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/marketing/partnyorskaya-programma.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
