Ҳуҷҷатгузории таҳиягар

Ҳар як дархост бо калиди махфӣ дар сарлавҳаи Authorization бо истифода аз схемаи Bearer аутентификатсия карда мешавад.

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

Агар калидҳои API-и шумо барои корбарони худ ҳисоби таблиғгарон эҷод кунанд (режими Connect — ба Authentication дар боло нигаред), шумо саҳми пардохтҳои таблиғгарон барои таблиғоти онҳоро ба даст меоред. Тақсимоти зерин мустақиман аз ҳамин нуқтаи поёнӣ хонда мешавад, ҳеҷ гоҳ дар код сахт муқаррар нашудааст ва комилан аз комиссияи тавсия, ки дар поёни ин саҳифа оварда шудааст, ҷудо аст.

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
}

Ҳар як ҳисоби таблиғгари илова бар нархи солонаи ягона маҷмӯи асбобҳои дохилии зеҳни сунъиро мегирад: генератори мундариҷа ва визуалии реклама, ёвари гуфтугӯӣ, маслиҳатгари буҷет ва аудитори берунаи SEO, ки бо кредитҳои зеҳни сунъӣ пардохт мешаванд.

Мисол — тавлиди матни таблиғотӣ

Ҳамин категория ва тавсифи тиҷорат низ генератори тасвириро дар поён таъмин мекунанд.

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-и шарики худ илова кунед (онро дар саҳифаи Developers-и панели идоракунии худ пайдо кунед):

<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-ро дар бар мегирад; аз ҳад гузаштан бо ҳолати 429 Too Many Requests ва сарсухани Retry-After баргардонида мешавад.

Ихтиёрӣ, барои ҳар як шарик. То даме ки шумо сабт илова накунед, калидҳои шумо дархостҳоро аз ҳар IP қабул мекунанд — аввалин сабт ҳамаи калидҳои он шарикро танҳо ба рӯйхати иҷозатдодашуда маҳдуд мекунад.

Ҳар як вебхук бо HMAC-SHA256 имзо мешавад, ки дар замони эҷод як маротиба сирре дода мешавад — пеш аз эътимод кардан ба мундариҷа имзоро тасдиқ кунед. Ҳодисаҳо танҳо ба шарике ирсол мешаванд, ки соҳиби таблиғгари дахлдор аст.