Dokumentacija kūrėjams

Kiekvienas užklausimas autentiškumas patvirtinamas naudojant slaptąjį raktą, esantį „Authorization“ antraštėje, pagal „Bearer“ schemą.

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

Jei jūsų API raktai sukuria reklamuotojų paskyras jūsų pačių vartotojams („Connect“ režimas — žr. skyrių „Autentiškumo patvirtinimas“ aukščiau), jūs gaunate dalį sumos, kurią tie reklamuotojai moka už savo skelbimus. Toliau pateiktas paskirstymas gaunamas realiuoju laiku iš to paties galinio taško, niekada nėra užkoduotas kodo lygiu ir yra visiškai atskirtas nuo rekomendacinės komisijos, apie kurią rašoma toliau šiame puslapyje.

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

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

Kaip tai veikia

1. Vienas iš jūsų „Connect“ režimu veikiančių reklamuotojų sumoka už reklamą per jūsų integraciją.
2. Skelbimas yra peržiūrimas ir patvirtinamas – automatiškai arba mūsų moderatorių komandos.
3. Jūsų dalis įtraukta į eilę automatiniam išmokėjimui į jūsų piniginę – tas pats mechanizmas, kaip ir toliau aprašytoje rekomendavimo programoje.

Išmokėjimo sąlygos

• Jūsų partnerio paskyroje sukonfigūruota kriptovaliutų išmokėjimų piniginė.
• Jums nereikia atlikti KYC procedūros – jūsų partnerio paskyra jau buvo patikrinta jos sukūrimo metu.

Pavyzdys: sukauptų akcijų skaičiaus nustatymas

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
}

Kiekvienai reklamuotojo paskyrai suteikiamas įdiegtų AI įrankių rinkinys – reklamos turinio ir vaizdų generatorius, pokalbių asistentas, biudžeto konsultantas ir išorinis SEO auditorius – už kuriuos, be fiksuoto metinio mokesčio, mokama AI kreditais.

Pavyzdys — reklamos turinio kūrimas

Ta pati kategorija ir verslo aprašymas taip pat naudojami žemiau pateiktame vaizdų generatoriuje.

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
}

Sukurti atitinkamą vaizdinę medžiagą tai pačiai reklamai:

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
}

Įdėkite paruoštą reklamos bloką į savo svetainę — nereikia nieko kurti, nereikia naudoti „iframe“. Skriptas atvaizduojamas tiesiogiai puslapyje, izoliuotame „Shadow DOM“ konteineriuje, todėl jo stilius niekada neatsispindi jūsų svetainėje, o jūsų svetainės stilius niekada neatsispindi jame.

Įtraukite jį į savo puslapį

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

Pagal numatytuosius nustatymus čia rodomas visas viešas kategorijos reitingas – visi platformos reklamuotojai, o ne tik tie, kuriuos pritraukėte. Norėdami rodyti tik tų reklamuotojų skelbimus, kuriuos sukūrėte naudodami „Connect“ režimą (t. y. tuos, už kuriuos gaunate komisinį atlygį), pridėkite „data-partner“ su savo partnerio ID (jį rasite savo valdymo skydo puslapyje „Kūrėjai“):

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

Jei jūsų reklamuotojai priklauso kelioms kategorijoms, visiškai atsisakykite „data-category“ – naudodami tik „data-partner“, valdiklis viename tinklelyje parodys visas jūsų reklamas iš visų kategorijų, o ne po vieną valdiklio bloką kiekvienai kategorijai:

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

Norite, kad šalia turinyje rodomo reklamos bloko būtų ir apačioje esantis blokas, kuriuose būtų rodomos skirtingos reklamos? Pridėkite antrąjį valdiklio bloką su atributu „data-layout="compact"“ (viena reklama, suskleidžiama į nedidelį langelį) ir nustatykite „data-offset“ reikšmę pagal tai, kiek reklamų jau rodo jūsų pirmasis valdiklis:

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

Savybės

Kaip partneriui iš tikrųjų išmokama rekomendacijos komisija — procentinė dalis, išmokėjimo tvarka ir sąlygos.

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
}

Išmokėjimo sąlygos

• Reklamuotojo bendra išmokėtina suma pasiekia minimalią išmokėjimo sumą.
• Jų paskyroje sukonfigūruota kriptovaliutų išmokėjimų piniginė.
• Jų KYC statusas yra patvirtintas.

Pavyzdys: sukauptų pelnų perskaitymas

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
}

Kainų pakopos (veikiančios)

Skaitykite duomenis tiesiogiai iš šio galinio taško — niekada neįrašykite šių verčių kodo, nes jos mūsų pusėje gali pasikeisti. Sukurkite savo vartotojams pakopų pasirinkimo meniu vietoj laisvai užpildomo sumos laukelio: kiekviena rodoma kaina jau yra tiksli suma, kurią reikia pervesti atliekant mokėjimą, o čia rodomos prieinamos naudos vartotojams aiškiai parodo, ką jie gauna už tą kainą, todėl jie pasirenka kainą, kurią supranta, o ne spėlioja skaičių.

Užklausų skaičius ribojamas pagal raktą ir per minutę. Kiekviename autentiškame atsakyme yra antraštės „X-RateLimit-Limit“, „X-RateLimit-Remaining“ ir „X-RateLimit-Reset“; viršijus ribą, grąžinamas kodas 429 „Too Many Requests“ su antrašte „Retry-After“.

Pasirinktinai, kiekvienam partneriui. Kol neįtrauksite įrašo, jūsų raktai priima užklausas iš bet kurio IP adreso – pirmasis įrašas perjungia visus to partnerio raktus į režimą, kai leidžiami tik įtraukti į sąrašą adresai.

Kiekvienas „webhook“ pasirašomas naudojant HMAC-SHA256 ir vienkartinį raktą, suteiktą jo sukūrimo metu – prieš pasitikėdami duomenų turiniu, patikrinkite parašą. Įvykiai perduodami tik tam partneriui, kuriam priklauso atitinkamas reklamuotojas.