Үҫтереүсе документацияһы

Һәр һорау Authorization башлығындағы серле асҡыс ярҙамында Bearer схемаһын ҡулланып аутентификациялана.

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

Әгәр һеҙҙең API-ключтарығыҙ үҙ ҡулланыусыларығыҙ өсөн рекламодатель иҫәптәрен булдыра (Connect режимы — юғарыраҡ Authentication-ға ҡарағыҙ), һеҙ шул рекламодательҙарҙың рекламалары өсөн түләгән аҡсаһының өлөшөн алаһығыҙ. Түбәндәге бүленеш шул уҡ 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 менән имзалана — йөкмәткегә ышанырҙан алда имзаны тикшерегеҙ. Ваҡиғалар тик шул рекламодательгә ҡараған партнерға ғына ебәрелә.