Dokumentacija za razvijalce

Vsako zahtevo se avtentificira s skrivnim ključem v glavi »Authorization« po shemi »Bearer«.

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

Če vaši API-ključi ustvarjajo oglaševalske račune za vaše lastne uporabnike (način »Connect« – glej »Preverjanje pristnosti« zgoraj), prejmete delež od zneska, ki ga ti oglaševalci plačajo za svoje oglase. Spodaj navedeni delež se v realnem času bere iz istega končnega točke, nikoli ni vnaprej določen, in je popolnoma ločen od provizije za napotitev, opisane nižje na tej strani.

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

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

Kako deluje

1. Eden od vaših oglaševalcev v načinu »Connect« plača za oglas prek vaše integracije.
2. Oglas se pregleda in odobri – bodisi samodejno bodisi s strani naše ekipe za moderiranje.
3. Vaš delež je v čakalni vrsti za samodejno izplačilo v vašo denarnico, in sicer po istem načelu kot pri spodaj opisanem programu za priporočanje.

Pogoji izplačila

• Na vašem partnerskem računu je nastavljena denarnica za izplačila v kriptovalutah.
• Z vaše strani ni potrebno nobeno preverjanje identitete (KYC) — vaš partnerski račun je bil preverjen že ob odprtju.

Primer: branje skupnega števila delnic

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
}

Vsak oglaševalski račun dobi nabor vgrajenih orodij z umetno inteligenco – generator vsebine in vizualnih elementov oglasov, pogovorni pomočnik, svetovalec za proračun ter zunanji revizor za optimizacijo za iskalnike (SEO) –, ki se poleg pavšalne letne cene plačujejo z AI-krediti.

Primer — ustvarjanje oglaševalske vsebine

Ista kategorija in opis dejavnosti sta podlaga tudi za spodnji generator slik.

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
}

Ustvarite ustrezno vizualno podobo za isti oglas:

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
}

Pripravljeno oglaševalsko enoto preprosto vstavite na svojo spletno stran – brez razvijanja, brez iframe-a. Skript se prikaže neposredno na strani znotraj izoliranega Shadow DOM-a, tako da se njegovi slogi nikoli ne prenesejo na vašo spletno stran, prav tako pa se slogi vaše spletne strani nikoli ne prenesejo nanj.

Dodaj to na svojo stran

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

Privzeto se prikaže celotna javna lestvica za kategorijo – vsi oglaševalci na platformi, ne le tisti, ki ste jih pridobili vi. Če želite prikazati le oglase oglaševalcev, ki ste jih ustvarili prek načina »Connect« (tisti, ki ustvarjajo vaš delež), dodajte atribut »data-partner« z vašo partnersko identifikacijsko številko (najdete jo na strani »Razvijalci« na vaši nadzorni plošči):

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

Če vaši oglaševalci sodijo v več kategorij, popolnoma odstranite atribut »data-category« — če uporabite samo atribut »data-partner«, bo widget prikazal vse vaše oglase iz vseh kategorij v eni mreži, namesto da bi potrebovali en blok widgeta za vsako kategorijo:

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

Želite poleg widgeta v vsebini dodati še enega v obliki spodnjega pasu, pri čemer bi vsak prikazoval drugačne oglase? Dodajte drugi blok widgeta z atributom data-layout="compact" (en oglas, ki se lahko skrči v majhno okence) in atributom data-offset, nastavljenim na število oglasov, ki jih že prikazuje vaš prvi widget:

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

Lastnosti

Kako partner dejansko prejme provizijo za priporočilo – odstotek, način izplačila in pogoji.

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
}

Pogoji izplačila

• Skupni zaslužek oglaševalca, ki ga je treba izplačati, doseže minimalni znesek za izplačilo.
• Na njihovem računu je nastavljena denarnica za izplačila v kriptovalutah.
• Njihov status KYC je preverjen.

Primer: prikaz nakopičenih dobičkov

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
}

Cenovni razredi (v živo)

Podatke preberite v realnem času iz te končne točke — teh vrednosti nikoli ne vpisujte neposredno v kodo, saj se lahko na naši strani spremenijo. Namesto polja za vnos prostega zneska ustvarite izbirnik cenovnih stopenj za svoje uporabnike: vsaka prikazana cena je že natančen znesek, ki ga je treba poslati ob ustvarjanju plačila, prikazane odklejene ugodnosti pa uporabnikom natančno povedo, kaj ta cena vključuje, tako da izberejo ceno, ki jo razumejo, namesto da bi ugibali znesek.

Število zahtevkov je omejeno na ključ in na minuto. Vsak avtentificiran odgovor vsebuje glave X-RateLimit-Limit, X-RateLimit-Remaining in X-RateLimit-Reset; v primeru prekoračitve omejitve se vrne napaka 429 Too Many Requests z glavo Retry-After.

Neobvezno, za vsakega partnerja. Dokler ne dodate vnosa, vaši ključi sprejemajo zahteve s katerega koli IP-naslova – prvi vnos preklopi vse ključe tega partnerja na način, da sprejemajo le zahteve s seznama dovoljenih naslovov.

Vsak webhook je podpisan s HMAC-SHA256 z uporabo enkratnega gesla, ki se generira ob ustvarjanju — preverite podpis, preden zaupate vsebini. Dogodki se posredujejo izključno partnerju, ki je lastnik zadevnega oglaševalca.