Коротко: агенція реєструється один раз під власною юридичною назвою. Щоб рекламувати своїх клієнтів, вона вказує назву кожного клієнта в полі Назва для учасників. Агенція платить, тримає баланси та отримує рахунки. Розробники можуть створювати акції й події та керувати ними через Agilis REST API (https://ads.agilis.dating). Для цього потрібні ключі API з Рекламного кабінету Agilis. Тестові ключі безкоштовні, а створене з ними ніколи не показується учасникам.
Для агенцій
- Зареєструйте агенцію під її власною юридичною назвою. → Як зареєструватися
- Коли створюєте акцію чи подію, вкажіть назву клієнта в полі Назва для учасників. Учасники бачитимуть назву клієнта, а не вашу.
- Ви повинні мати дозвіл кожного клієнта на рекламу від його імені. Згідно з Умовами розміщення реклами, відповідальність за це несе агенція.
Хто платить і хто отримує рахунки
- Оплата здійснюється з облікового запису вашої агенції у валюті розрахунків агенції.
- Кожен працівник вашої агенції має власний баланс і платить з нього. Баланс організації — це їхня загальна сума. → Як працюють баланси
- Рахунки й результати оформлюються на вашу агенцію, по одному рахунку на кожен платіж. Так ви можете перевиставити рахунок кожному клієнту.
- Щоб витрати кожного клієнта були окремими, створюйте для кожного клієнта окрему акцію чи подію. Потім перевиставляйте клієнту суму з її рахунку.
Ролі в команді
Адміністратори організації та Рекламодавці працюють у Рекламному кабінеті Agilis, а Розробники — через API. Розробники не можуть створювати акції чи події в Рекламному кабінеті. Проте зі своїми ключами API вони можуть створювати, публікувати й оплачувати їх через API. Ваша компанія відповідає за те, як використовуються її ключі. Повну таблицю наведено в розділі Ролі в команді та дозволи.
Agilis REST API
- Базова 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
- Увійдіть у Рекламний кабінет Agilis як Адміністратор організації або Розробник.
- Виберіть Тестовий режим або Робочий режим за допомогою перемикача вгорі сторінки.
- Перейдіть у розділ Ключі 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.
