Үстерүче өчен документация

Һәр сорау 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 билгесен партнёр IDыгыз белән өстәгез (аны үз дашбордыгыздагы Үсешчеләр битендә табыгыз):

<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
}

Бәяләр баскычлары (туры эфир)

Бу endpointтан турыдан-туры укыгыз — бу кыйммәтләрне беркайчан да статик рәвештә язмагыз, алар безнең яктан үзгәртелергә мөмкин. Бушлай күләм кыры урынына үз кулланучыларыгыз өчен баскыч сайлагыч төзегез: күрсәтелгән һәр бәя түләү булдырганда җибәреләсе төгәл сумманы аңлата, ә монда күрсәтелгән ачылган өстенлекләр кулланучыларга шул бәянең нәрсәгә икәнен төгәл аңлата, шуның белән алар сан фаразлау урынына үзләренә аңлаешлы бәяне сайлыйлар.

Таләпләр һәр ачкычка минутына чикләнгән. Һәр расланган җавап X-RateLimit-Limit, X-RateLimit-Remaining һәм X-RateLimit-Reset башлыкларын үз эченә ала; лимитны узып китсә, Retry-After башлыгы белән 429 Too Many Requests хатасы кайтарыла.

Һәр партнер өчен ихтыяри. Язма өстәгәнче, сезнең ачкычлар теләсә кайсы IP-дән мөрәҗәгатьләрне кабул итә — беренче язма шул партнерның барлык ачкычларын тик рөхсәт ителгән исемлеккә генә кертергә үзгәртә.

Һәр вебхук бер тапкыр, булдыру вакытында бирелгән сер ярдәмендә HMAC-SHA256 белән имзалана — йөкләмәне ышанып кабул итәр алдыннан имзаны тикшерегез. Вакыйгалар тиешле рекламодательгә ия булган партнер гына тапшырыла.