Ösüşdiriji dokumentasiýasy

Her bir haýyş Authorization başlygyndaky gizlin açar bilen Bearer skemasy ulanylyp awtentifikasiýa edilýär.

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

Eger API açarlaryňyz öz ulanyjylaryňyz üçin reklam beriji hasaplary döredýän bolsa (Connect režimi — ýokardaky Awtentifikasiýa bölümine serediň), onda şol reklam berijileriň reklamalary üçin tölän pullarynyň bir bölegini gazanýarsyňyz. Aşakdaky paýlaşma şol bir endpoint-den göni okalýar, hiç haçan kodda ýazylmaýar we bu sahypanyň aşagyndaky referal komissiýasyndan doly aýry.

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

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

Ol nähili işleýär

1. Connect-režimindäki reklam berijileriňiziň biri integrasiýaňyz arkaly reklama töleg edýär.
2. Reklama gözden geçirilýär we tassyklanylýar — awtomatik ýa-da biziň moderasiýa toparymyz tarapyndan.
3. Siziň paýyňyz awtomatik usulda pul çykarmak üçin walýetiňize nobata goýuldy, bu aşakdaky referal programmasyndaky ýaly bir mehanizmdir.

Töleg şertleri

• Partner hasabyňyzda kriptopul töleg jübüsi sazlandy.
• Siziň tarapyňyzda KYC talap edilmeýär — hyzmatdaş hasabyňyz döredilen wagtyndan bäri barlanýar.

Mysal: ýygnalan paýlary okamak

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
}

Her bir reklam beriji hasabyna gurnalan sun'iy aň gurallarynyň toplumy berilýär — reklama mazmuny we wizual generatori, gepleşikli kömekçi, býujet geňeşçisi we daşarky SEO barlagçysy — olar ýönekeý ýyllyk tölegden başga, sun'iy aň kreditleri bilen tölenýär.

Mysal — reklama mazmunyny döretmek

Şol bir kategoriýa we iş beýany aşakdaky surat generatoryny hem işledýär.

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
}

Şol bir reklamanyň gabat gelýän görselini dörediň:

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
}

Taýýar mahabat bölümini saýtyňyza salyň — gurmak ädimi ýok, iframe gerek däl. Skript sahypada gönüden-göni izolýasiýa edilen Shadow DOM içinde görkezilýär, şonuň üçin onuň stilleri hiç haçan saýtyňyza geçmeýär we saýtyňyzyň stilleri hem oňa geçmeýär.

Ony sahypanyňyza goşuň

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

Öňünden bu kategoriýa boýunça doly açyk reýtingi görkezýär — platformadaky ähli mahabatçylary, diňe siziň getireniňiz bolmadyk. Connect režimi arkaly döreden mahabatçylaryň (sizden paý gazanýanlaryň) mahabatlaryny diňe görkezmek üçin data-partner elementini partner ID-ňiz bilen goşuň (ony öz paneliňiziň Ösüşçi sahypasynda tapyp bilersiňiz):

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

Eger reklam berijileriňiz birnäçe kategoriýa degişli bolsa, data-category elementini düýbünden aýyryň — diňe data-partner bilen widget ähli kategoriýalardaky ähli reklamalaryňyzy bir gridde görkezýär, her kategoriýa üçin aýratyn widget bloky gerek bolmazdan:

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

Mazmun içindäki bölüm bilen bir hatarda, her biri dürli reklamalary görkezjek footer-stilinde bir bölümi hem goşmak isleýärsiňizmi? Ikinji widget blokyny data-layout="compact" (bir sany reklama, kiçi tablet görnüşine öwrülip bilýän) we data-offset parametrini birinji widgetiňiz eýýäm näçe reklama görkezýändigine görä sazlap goşuň:

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

Aýratynlyklar

Partneriň salgylama komissiýasy hakykatda oňa nähili ýetýär — göterim, töleg mehanizmi we öňki şertler.

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
}

Töleg şertleri

• Reklam berijiniň tölenmeli jemi girdejisi iň pes töleg mukdaryna ýetýär.
• Olaryň hasabynda kriptopul töleg jübüsi sazlandy.
• Olaryň KYC statusy tassyklanyldy.

Mysal: ýygnalan girdejileri okamak

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
}

Bahalaşdyrma basgançaklary (göni)

Bu endpoint-den göni okaň — bu bahalary hiç haçan kodda gömmeň, olar biziň tarapdan üýtgäp biler. Erkin möçber meýdanynyň ýerine ulanyjylaryňyz üçin gatlak saýlaýjyny gurnuň: görkezilen her bir bahanyň özi töleg döredilende iberiljek takyk möçberdir, we bu ýerde görkezilen açylan artykmaçlyklar ulanyjylara şol bahanyň näme getirýändigini takyk düşündirýär, şonuň üçin olar san çaklamak ýerine özlerine düşnükli bahany saýlaýarlar.

Her açar üçin minutda haýyşlar çäklendirilýär. Her tassyklanan jogap X-RateLimit-Limit, X-RateLimit-Remaining we X-RateLimit-Reset başlyklaryny öz içine alýar; çägi aşan halatynda Retry-After başlygy bilen 429 Too Many Requests hatasy gaýtarylýar.

Her bir hyzmatdaş üçin islege bagly. Giriş goşýança, açarlaryňyz islendik IP-den gelýän haýyşlary kabul edýär — ilkinji giriş şol hyzmatdaşyň ähli açarlaryny diňe rugsat berlen sanawa girizýär.

Her webhook döredilen wagty bir gezek berlen gizlin açar bilen HMAC-SHA256 arkaly gol çekilýär — ýükleýini ynanmazdan ozal goly tassyklap geçiň. Hadysalar diňe degişli reklam beriji eýe bolan hyzmatdaşyna iberilýär.