Коротко: агентство регистрируется один раз под своим юридическим названием и рекламирует клиентов. Для этого название каждого клиента указывается в поле Отображаемое название. Агентство платит, распоряжается балансами и получает счета. Разработчики могут создавать акции и мероприятия и управлять ими через REST API Agilis (https://ads.agilis.dating) с помощью ключей API из Рекламного кабинета. Тестовые ключи бесплатны, а созданное с ними никогда не показывается пользователям.
Для агентств
- Зарегистрируйте агентство под его собственным юридическим названием. → Как зарегистрироваться
- При создании акции или мероприятия укажите название клиента в поле Отображаемое название. Пользователи увидят название клиента, а не ваше.
- Вы должны получить от каждого клиента разрешение размещать рекламу от его имени. По Условиям размещения рекламы ответственность за это несёт агентство.
Кто платит и кто получает счета
- Оплата производится с аккаунта агентства в валюте расчётов агентства.
- У каждого сотрудника агентства свой баланс, и он платит с него. Баланс организации — это общая сумма. → Как работают балансы
- Счета и результаты оформляются на имя агентства, по одному счёту на каждый платёж. Так вы сможете перевыставить расходы каждому клиенту.
- Чтобы вести расходы каждого клиента отдельно, создавайте для каждого клиента свою акцию или своё мероприятие и перевыставляйте расходы по соответствующему счёту.
Роли в команде
Администраторы организации и Рекламодатели работают в Рекламном кабинете, а Разработчики работают через API. Разработчики не могут создавать акции и мероприятия в Рекламном кабинете. Однако с помощью своих ключей API они могут создавать, публиковать и оплачивать их через API, и за использование ключей отвечает ваша организация. Полная таблица приведена в разделе Роли и права в команде.
REST API Agilis
- Базовый URL: https://ads.agilis.dating
- Справочник: www.agilis.dating/api-doc — с примерами на cURL, Python, Node.js и PHP и помощником по API
- Для машинной обработки: OpenAPI 3.1 — www.agilis.dating/openapi.json, Markdown — www.agilis.dating/api-doc.md, полный текст для инструментов ИИ — www.agilis.dating/llms-full.txt
- Акции: получение списка ваших категорий и интересов; расчёт стоимости акции до её создания; создание, просмотр списка, приостановка, возобновление и удаление акций; получение результатов каждой акции
- Мероприятия: предпросмотр, публикация, просмотр списка, редактирование, перенос, отмена и удаление мероприятий; получение результатов каждого мероприятия
Как получить ключ API
- Войдите в Рекламный кабинет как Администратор организации или Разработчик.
- Выберите Тестовый режим или Рабочий режим с помощью переключателя вверху страницы.
- Откройте Ключи API → Создать новый ключ, задайте название и при желании срок действия.
- Сразу скопируйте ключ. Больше вы его не увидите.
Тестовые ключи начинаются с pk_test_, рабочие — с pk_live_. У каждого сотрудника может быть до 10 ключей в каждом режиме. Кнопка Заменить ключ сразу меняет ключ на новый, поэтому сначала обновите свои системы. Передавайте ключ в заголовке запроса x-api-key: x-api-key: pk_test_….
Безопасная разработка
- Разрабатывайте и тестируйте с ключом
pk_test_: тестовые акции и мероприятия бесплатны и никогда не показываются пользователям. - Перед созданием акции рассчитайте её стоимость с помощью метода расчёта цены.
- Не храните ключи в репозиториях кода и в браузерах. Обращайтесь к API со своего сервера.
Вопросы
Может ли агентство вести нескольких клиентов из одного аккаунта?
Да. Зарегистрируйте агентство один раз и указывайте клиента в каждой акции или мероприятии.
Можно ли получить отдельный счёт для каждого клиента?
Счета выставляются агентству, по одному на каждый платёж. На их основе вы можете перевыставлять расходы клиентам.
Есть ли тестовая среда?
Да. Тестовый режим с ключами pk_test_ — полноценная тестовая среда. Ничего не списывается и ничего не показывается пользователям.
Можно ли подключить инструменты ИИ для программирования?
Да. Укажите в своём инструменте адрес www.agilis.dating/api-doc.md или www.agilis.dating/openapi.json.
