Әзірлеушіге арналған құжаттама

Әрбір сұраным Authorization басылымындағы Bearer схемасы арқылы құпия кілтпен аутентификацияланады.

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

Егер сіздің API кілттеріңіз өз пайдаланушыларыңыз үшін жарнама берушілердің есептік жазбаларын жасаса (Connect режимі — жоғарыдағы Аутентификацияны қараңыз), сіз сол жарнама берушілер өз жарнамалары үшін төлейтін соманың бір бөлігін аласыз. Төмендегі бөліну осы бірдей endpoint-тен тікелей оқылады, ешқашан қатты кодталмаған және осы беттің әрі қарайғы сілтеме комиссиясынан мүлдем бөлек.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

Қалай жұмыс істейді

1. Connect режиміндегі жарнама берушілеріңіздің бірі сіздің интеграцияңыз арқылы жарнамаға ақы төлейді.
2. Жарнама қаралып, мақұлданады — автоматты түрде немесе модерация тобымыз арқылы.
3. Сіздің үлесіңіз әмиянға автоматты түрде төленетін кезекке қойылды, бұл төмендегі рефералдық бағдарламадағыдай механизм.

Төлем шарттары

• Сіздің серіктес шотыңызға крипто төлем әмияны бапталып қойылған.
• Сіздің жағыңызда KYC талап етілмейді — серіктес шотыңыз құрылған кезде-ақ тексерілген.

Мысал: жинақталған үлестерді оқу

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

Әр жарнама берушінің есепшотына кіріктірілген AI құралдарының жиынтығы беріледі: жарнама мазмұны мен визуалды генератор, әңгімелесу ассистенті, бюджет жөніндегі кеңесші және сыртқы SEO аудиторы. Олар жыл сайынғы біркелкі бағадан бөлек AI кредиттерімен төленеді.

Мысал — жарнама мазмұнын жасау

Сол санат пен бизнес сипаттамасы төмендегі сурет генераторына да негіз болады.

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

Сол жарнамаға сәйкес келетін визуал жасаңыз:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

Дайын жарнама блогын өз сайтыңызға орналастырыңыз — құру қажет емес, iframe қолданудың қажеті жоқ. Скрипт оқшауланған Shadow DOM ішінде тікелей бетке рендерленеді, сондықтан оның стильдері ешқашан сіздің сайтыңызға әсер етпейді, ал сіздің сайтыңыздың стильдері де оған әсер етпейді.

Оны бетіңізге қосыңыз

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Әдепкі бойынша бұл категорияның толық ашық рейтингін көрсетеді — платформадағы барлық жарнама берушілерді, тек сіз әкелгендерді ғана емес. Connect режимі арқылы жасаған (сіздің үлесіңізді түзетін) жарнама берушілердің жарнамаларын ғана көрсету үшін data-partner деректеріне серіктес идентификаторыңызды қосыңыз (оны өз бақылау тақтаңыздың Әзірлеушілер бетінен таба аласыз):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Егер сіздің жарнама берушілеріңіз бірнеше санатқа жататын болса, data-category сипаттамасын мүлде алып тастаңыз — тек data-partner сипаттамасын пайдаланғанда виджет барлық санаттардағы барлық жарнамаларыңызды бір торда көрсетеді, әр санатқа бөлек виджет блогын орналастырудың қажеті жоқ:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Мазмұндағы баннер блогының қасына әрқайсысы әртүрлі жарнама көрсететін футер стиліндегі блок қосқыңыз келе ме? data-layout="compact" (бір жарнама, кішігірім «пилл» түрінде жиырылатын) және data-offset мәнін бірінші виджетіңіздегі жарнамалар санына тең етіп орнатып, екінші виджет блогын қосыңыз:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Атрибуттар

Серіктестің жолдау комиссиясы оларға қалай нақты жетеді — пайыздық мөлшерлеме, төлем механизмі және алғышарттары.

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

Төлем шарттары

• Жарнама берушінің жалпы төленуге тиісті табысы ең төменгі төлем сомасына жетті.
• Олардың шотында крипто төлем әмияны бапталып қойылған.
• Олардың KYC мәртебесі расталды.

Мысал: жинақталған табыстарды оқу

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

Баға деңгейлері (тікелей)

Осы ендпойнттан тікелей оқыңыз — осы мәндерді ешқашан қатты кодтамаңыз, олар біздің жағымызда өзгеруі мүмкін. Тегін сома өрісінің орнына өз пайдаланушыларыңызға арналған деңгей таңдағышты құрыңыз: көрсетілген әрбір баға төлем жасау кезінде жіберілетін нақты соманы білдіреді, ал мұнда көрсетілген ашылған артықшылықтар пайдаланушыларға сол бағаның нені қамтитынын дәл түсіндіреді, сондықтан олар сандарды болжаудың орнына түсінетін бағаны таңдайды.

Сұраулар әр кілт бойынша минутына шектеледі. Әрбір аутентификацияланған жауап X-RateLimit-Limit, X-RateLimit-Remaining және X-RateLimit-Reset басылықтарын қамтиды; шектен асқан кезде Retry-After басылығымен 429 Too Many Requests қатесі қайтарылады.

Әр серіктес үшін міндетті емес. Сіз жазба қосқанға дейін кілттеріңіз кез келген IP-мекенжайдан келетін сұраныстарды қабылдайды — алғашқы жазба сол серіктестің барлық кілттерін тек рұқсат етілген тізімге ғана жіберу режиміне ауыстырады.

Әрбір вебхук құрылған кезде бір рет берілетін құпия кілт негізінде HMAC-SHA256 әдісімен қол қойылады — жүктемені сенімге алмас бұрын қолтаңбаны тексеріңіз. Оқиғалар тек тиісті жарнама берушіге ие серіктеске жеткізіледі.