Kehittäjien ohjeet

Jokainen pyyntö todennetaan salaisella avaimella Authorization-otsikossa Bearer-menetelmää käyttäen.

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

Jos API-avaimesi luovat mainostajatilejä omille käyttäjillesi (Connect-tila – katso kohta ”Todennus” yllä), saat osuuden siitä, mitä kyseiset mainostajat maksavat mainoksistaan. Alla esitetty jakosuhde luetaan reaaliaikaisesti tästä samasta päätepisteestä; se ei ole koskaan koodattu kiinteästi, ja se on täysin erillinen tämän sivun alempana mainitusta viittauspalkkiosta.

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

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

Kuinka se toimii

1. Yksi Connect-tilassa toimivista mainostajistasi maksaa mainoksesta integrointisi kautta.
2. Mainos tarkistetaan ja hyväksytään – joko automaattisesti tai moderointitiimimme toimesta.
3. Osuutesi on jonossa automaattista maksua varten lompakkoosi – sama menettelytapa kuin alla kuvatussa suositteluohjelmassa.

Maksuehdot

• Kryptovaluutan maksulompakko on määritetty kumppanitilillesi.
• Sinun puoleltasi ei vaadita KYC-tunnistautumista — kumppanitilisi on jo tarkistettu avaamisen yhteydessä.

Esimerkki: kertyneiden osakkeiden lukeminen

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
}

Jokaiseen mainostajatiliin kuuluu joukko sisäänrakennettuja tekoälytyökaluja – mainossisällön ja visuaalisen materiaalin luontityökalu, keskusteluavustaja, budjettineuvoja sekä ulkoinen SEO-tarkastaja –, joiden käyttö maksetaan tekoälykrediiteillä kiinteän vuosimaksun lisäksi.

Esimerkki — mainossisällön luominen

Sama luokka ja liiketoimintakuvaus toimivat myös alla olevan kuvageneraattorin perustana.

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
}

Luo samaan mainokseen sopiva kuva:

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
}

Lisää valmiiksi laadittu mainosyksikkö omalle sivustollesi — ilman kehitysvaihetta, ilman iframe-kehyksiä. Skripti renderöidään suoraan sivulle eristetyn Shadow DOM:n sisällä, joten sen tyylit eivät koskaan vaikuta sivustoosi, eikä sivustosi tyylit vaikuta siihen.

Lisää se sivullesi

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

Oletusasetuksena tässä näkyy kyseisen kategorian koko julkinen ranking – kaikki alustan mainostajat, ei vain ne, jotka olet itse tuonut mukaan. Jos haluat näyttää vain niiden mainostajien mainokset, jotka olet luonut Connect-tilassa (eli ne, joista saat osuutesi), lisää data-partner-attribuutti ja kumppanitunnuksesi (löydät sen oman hallintapaneelisi Kehittäjät-sivulta):

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

Jos mainostajasi kuuluvat useaan luokkaan, poista data-category kokonaan — kun käytät pelkästään data-partner-attribuuttia, widget näyttää kaikki mainoksesi kaikista luokista yhdessä ruudukossa, eikä jokaiselle luokalle tarvita erillistä widget-lohkoa:

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

Haluatko sisältöalueen vieressä olevan alatunnisteen tyyppisen yksikön, jossa kummassakin näytetään eri mainoksia? Lisää toinen widget-lohko, jossa on attribuutti data-layout="compact" (yksi mainos, joka voidaan taittaa pieneksi pilleriksi) ja attribuutti data-offset asetettuna sen mukaan, kuinka monta mainosta ensimmäisessä widgetissä jo näytetään:

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

Ominaisuudet

Miten kumppanin välityspalkkio tosiasiassa maksetaan hänelle — prosenttiosuus, maksutapa ja edellytykset.

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
}

Maksuehdot

• Mainostajan maksettavat tulot yhteensä saavuttavat vähimmäismaksurajan.
• Heidän tililleen on määritetty kryptovaluutan maksulompakko.
• Heidän KYC-tietonsa on vahvistettu.

Esimerkki: kertyneiden tulojen lukeminen

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
}

Hintatasot (käytössä)

Lue tiedot suoraan tästä päätepisteestä — älä koskaan määritä näitä arvoja kiinteästi koodiin, sillä ne voivat muuttua meidän puoleltamme. Luo omille käyttäjillesi hintatasovalitsin ilmaisen summan kentän sijaan: jokainen näkyvä hinta on jo tarkalleen se summa, joka lähetetään maksua luotaessa, ja tässä näkyvät avatut edut kertovat käyttäjille tarkalleen, mitä kyseisellä hinnalla saa, joten he valitsevat hinnan, jonka ymmärtävät, sen sijaan että arvaisivat summaa.

Pyyntöjen määrä on rajoitettu avainta ja minuuttia kohden. Jokaisessa todennetussa vastauksessa on X-RateLimit-Limit-, X-RateLimit-Remaining- ja X-RateLimit-Reset-otsikot; rajan ylittäminen palauttaa virheen 429 Too Many Requests, jossa on Retry-After-otsikko.

Valinnainen, kumppanikohtaisesti. Ennen kuin lisäät merkinnän, avaimesi hyväksyvät pyyntöjä mistä tahansa IP-osoitteesta — ensimmäinen merkintä muuttaa kyseisen kumppanin kaikki avaimet sallittujen listalle rajoitetuiksi.

Jokainen webhook allekirjoitetaan HMAC-SHA256-algoritmilla käyttäen kertaluonteista salaisuutta, joka luodaan webhookin luomisen yhteydessä — tarkista allekirjoitus ennen kuin luotat datapakettiin. Tapahtumat toimitetaan ainoastaan sille kumppanille, joka omistaa kyseisen mainostajan.