Arendajate dokumentatsioon

Iga päring autentitakse „Authorization“-päises oleva salajase võtmega, kasutades „Bearer“-skeemi.

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

Kui teie API-võtmed loovad teie enda kasutajatele reklaamijate kontosid (Connect-režiim – vt eespool jaotist „Autentimine”), teenite te osa summast, mida need reklaamijad oma reklaamide eest maksavad. Allpool esitatud jaotus loetakse reaalajas samast lõpppunktist, seda ei ole kunagi koodi sisse kirjutatud ning see on täiesti eraldiseisev käesoleva lehekülje allpool kirjeldatud soovitustasust.

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

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

Kuidas see toimib

1. Üks teie Connect-režiimis tegutsevatest reklaamijatest maksab reklaami eest teie integratsiooni kaudu.
2. Reklaam vaadatakse läbi ja kiidetakse heaks – kas automaatselt või meie modereerimismeeskonna poolt.
3. Teie osa on järjekorda pandud automaatseks väljamaksmiseks teie rahakotti – sama mehhanism nagu allpool kirjeldatud soovitamisprogrammis.

Väljamaksetingimused

• Teie partnerikontole on seadistatud krüptovaluuta väljamaksete rahakott.
• Teie poolt ei ole vaja KYC-protseduuri läbida — teie partnerikonto on loomisel juba kontrollitud.

Näide: kogunenud aktsiate lugemine

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
}

Iga reklaamija kontole antakse kasutusse sisseehitatud tehisintellekti tööriistade komplekt – reklaami sisu ja visuaalide genereerija, vestlusassistent, eelarvenõustaja ja väline SEO-auditeerija –, mille eest tasutakse tehisintellekti krediitidega lisaks kindlasummalisele aastatasule.

Näide – reklaamisisu genereerimine

Sama kategooria ja tegevusala kirjeldus on aluseks ka allpool olevale pildigeneraatorile.

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
}

Loo sama reklaami jaoks sobiv visuaal:

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
}

Lisage valmis reklaamplokk oma veebilehele – ilma eraldi loomise etapita ja ilma iframe’ita. Skript kuvatakse otse lehele isoleeritud Shadow DOM-i sees, mistõttu selle stiilid ei mõjuta kunagi teie veebilehte ja teie veebilehe stiilid ei mõjuta kunagi seda.

Lisa see oma lehele

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

Vaikimisi kuvatakse siin kategooria täielik avalik edetabel – kõik platvormil olevad reklaamijad, mitte ainult need, keda sina oled toonud. Et kuvada ainult nende reklaamijate reklaame, keda oled loonud Connect-režiimis (need, kes teenivad sulle komisjonitasu), lisa atribuut „data-partner“ koos oma partneri ID-ga (leiad selle oma juhtpaneeli arendajate lehelt):

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

Kui teie reklaamijad kuuluvad mitmesse kategooriasse, jätke „data-category“ täielikult välja – kui kasutada ainult „data-partner“, kuvab vidin kõik teie reklaamid kõigist kategooriatest ühes tabelis, selle asemel et iga kategooria jaoks oleks vaja eraldi vidinablokki:

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

Kas soovid lisaks sisu sees olevale reklaamplokile ka jaluselaadset reklaamplokki, kus kummaski kuvatakse erinevaid reklaame? Lisa teine vidinablokk, millel on atribuut data-layout="compact" (üks reklaam, mida saab kokku klappida väikseks pilliks) ja mille atribuut data-offset on seatud vastavalt sellele, mitu reklaami su esimene vidin juba kuvab:

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

Omadused

Kuidas partneri soovitustasu talle tegelikult laekub – protsendimäär, väljamaksmise kord ja eeltingimused.

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
}

Väljamaksetingimused

• Reklaamija maksmisele kuuluv kogutulu on jõudnud minimaalse väljamaksesummale.
• Nende kontole on seadistatud krüptovaluuta väljamakse rahakott.
• Nende KYC-staatus on kinnitatud.

Näide: kogunenud kasumi väljatoomine

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
}

Hinnatasemed (kasutusel)

Loe andmeid otse sellest lõpppunktist — ära kunagi koodi neid väärtusi püsivalt sisse, sest need võivad meie poolel muutuda. Looge oma kasutajatele taseme valikuvahend tasuta summa välja asemel: iga kuvatud hind on juba täpne summa, mis tuleb makse loomisel saata, ning siin kuvatud avatud soodustused näitavad kasutajatele täpselt, mida see hind neile annab, nii et nad valivad hinna, mida nad mõistavad, selle asemel, et numbrit ära arvata.

Päringute arv on piiratud võtme ja minuti kohta. Iga autentimise läbinud vastus sisaldab päiseid X-RateLimit-Limit, X-RateLimit-Remaining ja X-RateLimit-Reset; piiri ületamisel tagastatakse vastus 429 Too Many Requests koos päisega Retry-After.

Valikuline, iga partneri kohta. Kuni sa pole veel kirjet lisanud, võtavad su võtmed vastu taotlusi mis tahes IP-aadressilt – esimene kirje muudab kõnealuse partneri kõik võtmed nii, et need lubavad ainult lubatud nimekirjas olevaid aadresse.

Iga webhook on allkirjastatud HMAC-SHA256-ga, kasutades loomise ajal ühekordselt väljastatud salajast võtit – kontrollige allkirja enne, kui usaldate andmeid. Sündmused edastatakse ainult sellele partnerile, kellele kuulub asjaomane reklaamija.