Izstrādātāju dokumentācija

Katrs pieprasījums tiek autentificēts, izmantojot slepeno atslēgu autorizācijas galvenē saskaņā ar „Bearer“ shēmu.

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

Ja jūsu API atslēgas izveido reklāmdevēju kontus jūsu lietotājiem (režīms „Connect“ — skatiet sadaļu „Autentifikācija“ iepriekš), jūs saņemat daļu no summas, ko šie reklāmdevēji maksā par savām reklāmām. Zemāk norādītais sadalījums tiek nolasīts reāllaikā no šī paša galapunkta, tas nekad nav ieprogrammēts kodā un ir pilnīgi atsevišķs no rekomendācijas komisijas, kas aprakstīta tālāk šajā lapā.

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

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

Kā tas darbojas

1. Viens no jūsu „Connect” režīma reklāmdevējiem apmaksā reklāmu, izmantojot jūsu integrāciju.
2. Reklāma tiek pārbaudīta un apstiprināta — automātiski vai ar mūsu moderatoru komandas palīdzību.
3. Jūsu daļa ir iekļauta rindā automātiskai izmaksai uz jūsu elektronisko maku — tas notiek pēc tā paša principa kā zemāk aprakstītajā ieteikumu programmā.

Izmaksas nosacījumi

• Jūsu partnera kontā ir iestatīta kriptovalūtas izmaksu maku.
• No jūsu puses nav nepieciešama KYC pārbaude — jūsu partnera konts jau ir pārbaudīts tā izveides brīdī.

Piemērs: uzkrāto akciju skaita nolasīšana

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
}

Katram reklāmdevēja kontam tiek nodrošināts iebūvētu AI rīku komplekts — reklāmas satura un vizuālo elementu ģenerators, sarunu palīgs, budžeta konsultants un ārējais SEO auditors —, kuru izmantošana tiek apmaksāta ar AI kredītiem papildus fiksētajai gada cenai.

Piemērs — reklāmas satura izveide

Tā pati kategorija un uzņēmuma apraksts tiek izmantoti arī zemāk redzamajam attēlu ģeneratoram.

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
}

Izveidojiet atbilstošu attēlu šai reklāmai:

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
}

Ievietojiet gatavu reklāmas bloku savā vietnē — bez izstrādes posma, bez iframe. Skripts tiek attēlots tieši lapā izolētā Shadow DOM vidē, tādējādi tā stili nekad neietekmē jūsu vietni, un jūsu vietnes stili nekad neietekmē to.

Pievieno to savai lapai

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

Pēc noklusējuma šeit tiek parādīts pilnais publiskais reitings šai kategorijai — visi platformas reklāmdevēji, nevis tikai tie, kurus esat piesaistījis. Lai parādītu tikai to reklāmdevēju reklāmas, kurus esat izveidojis, izmantojot „Connect“ režīmu (tie, kas ģenerē jūsu daļu), pievienojiet „data-partner“ ar savu partnera ID (to varat atrast savā vadības panelī sadaļā „Izstrādātāji”):

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

Ja jūsu reklāmdevēji pārstāv vairākas kategorijas, pilnībā izņemiet „data-category“ — izmantojot tikai „data-partner“, logrīks parādīs visas jūsu reklāmas no visām kategorijām vienā tabulā, tādējādi nav nepieciešams atsevišķs logrīka bloks katrai kategorijai:

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

Vēlaties, lai līdzās satura vidū esošajam blokam būtu arī apakšējās joslas stila bloks, kurā katrā tiktu rādītas atšķirīgas reklāmas? Pievienojiet otro logrīku bloku ar atribūtu data-layout="compact" (viena reklāma, ko var saspiest mazā „pill” formātā) un atribūtu data-offset, kurā norādiet, cik daudz reklāmu jau rāda jūsu pirmais logrīks:

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

Īpašības

Kā partnera komisija par ieteikumu faktiski nonāk pie viņa — procentuālā daļa, izmaksas mehānisms un priekšnosacījumi.

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
}

Izmaksas nosacījumi

• Reklāmdevēja kopējie izmaksājamie ienākumi sasniedz minimālo izmaksas summu.
• Viņu kontā ir iestatīta kriptovalūtas izmaksu maku.
• Viņu KYC statuss ir pārbaudīts.

Piemērs: uzkrāto peļņu nolasīšana

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
}

Cenu līmeņi (aktīvi)

Lasiet datus tiešsaistē no šī galapunkta — nekad neiekļaujiet šīs vērtības kodā, jo tās var mainīties no mūsu puses. Izveidojiet saviem lietotājiem pakalpojuma līmeņu izvēlni, nevis lauku, kurā jāievada brīvi izvēlēta summa: katra norādītā cena jau ir precīza summa, kas jānosūta, veicot maksājumu, un šeit norādītās atbloķētās priekšrocības lietotājiem precīzi paskaidro, ko viņi saņem par šo cenu, tādējādi viņi izvēlas cenu, kuru saprot, nevis mēģina uzminēt skaitli.

Pieprasījumu skaitam ir noteikts ierobežojums katrai atslēgai katru minūti. Katrai autentificētajai atbildei ir pievienoti galvenes X-RateLimit-Limit, X-RateLimit-Remaining un X-RateLimit-Reset; ja tiek pārsniegts ierobežojums, tiek atgriezts kļūdas kods 429 „Too Many Requests” ar galveni „Retry-After”.

Pēc izvēles, katram partnerim. Kamēr neievadi ierakstu, tavi atslēgas pieņem pieprasījumus no jebkuras IP adreses — pirmais ieraksts pārslēdz visas šī partnera atslēgas uz režīmu, kurā tiek pieļautas tikai atļautajā sarakstā iekļautās adreses.

Katrs webhook tiek parakstīts ar HMAC-SHA256, izmantojot slepeno atslēgu, kas tiek izsniegta vienreiz — izveides brīdī —; pirms uzticēties datu saturam, pārbaudiet parakstu. Notikumi tiek nosūtīti tikai tam partnerim, kuram pieder attiecīgais reklāmdevējs.