Garatzailearen dokumentazioa

Eskaera bakoitza egiaztatzen da Authorization buruan dagoen gako sekretu batekin, Bearer eskema erabiliz.

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

Zure API gakoek zure erabiltzaileentzat iragarkigile-kontuak sortzen badituzte (Connect modua — ikus goiko Autentifikazioa), iragarkigile horiek beren iragarkietarako ordaintzen dutena zati bat irabazten duzu. Beheko banaketa puntu berean zuzenean irakurtzen da, inoiz ez da kodetuta egon, eta orrialde honetako behean dagoen erreferentzia-komisioarekin erabat bereizita dago.

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

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

Nola funtzionatzen duen

1. Zure Connect moduko iragarki-emaileetako batek zure integrazioaren bidez iragarki baten ordainketa egiten du.
2. Iragarkia berrikusi eta onartzen da — automatikoki edo gure moderazio-taldeak.
3. Zure zatia zure zorroan automatikoki ordaintzeko ilaran dago, beheko erreferentzia-programaren mekanismo bera erabiliz.

Ordainketa-baldintzak

• Zure bazkide kontuan kripto-ordainketa-zorro bat konfiguratuta dago.
• Zure aldetik ez da KYCrik behar — zure bazkide-kontua sortzean jada egiaztatuta dago.

Adibidea: pilatutako akzioak irakurtzea

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
}

Publizitate-kontu bakoitzak AI tresna integratuen multzo bat jasotzen du — iragarkien edukia eta irudiak sortzeko generadore bat, elkarrizketa-laguntzaile bat, aurrekontu-aholkulari bat eta SEO kanpoko auditori bat — AI kredituak erabiliz ordaintzen dena, urteko prezio finkoaren gainetik.

Adibidea — iragarkien edukia sortu

Kategoria bera eta negozioaren deskribapen bera beheko irudi-sortzailea ere elikatzen dute.

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
}

Sortu iragarki berarentzako ikusizko material egokia:

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
}

Zure webgunean prestaturiko iragarki-unitate bat jarri — ez dago eraikuntza-urratsik, ez iframe-rik. Scriptak orrian zuzenean itzal-DOM isolatu baten barruan bistaratzen du, beraz, bere estiloek ez dute inoiz zure webgunera ihes egiten, eta zure webguneko estiloek ere ez dute inoiz horretara.

Gehitu zure orrialdean

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

Lehenetsita, honek kategoria osorako sailkapen publiko osoa erakusten du — plataformako iragarki-emaile guztiak, ez bakarrik zuk ekarritakoak. Connect moduan sortu dituzun iragarki-emaileek soilik (zure kuota sortzen dutenek) bidalitako iragarkiak erakusteko, gehitu data-partner zure bazkide-IDarekin (aurki dezakezu zure kontrol-paneleko Garatzaileen orrialdean):

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

Zure iragarki-emaileek kategoria anitz hartzen badituzte, kendu erabat data-category — data-partner bakarrik erabilita, widget-ak zure iragarki guztiak kategoria guztietakoak sare bakar batean erakusten ditu, kategoria bakoitzeko widget-bloke bat behar izatearen ordez:

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

Eduki barruko unitatearen ondoan oin-ohar estiloko beste unitate bat nahi duzu, bakoitzak iragarki desberdinak erakutsiko dituena? Gehitu bigarren widget bloke bat data-layout="compact" (iragarki bakarra, pilula txiki batean tolestu daitekeena) eta data-offset lehen widgetak dagoeneko zenbat iragarki erakusten dituen arabera ezarrita:

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

Ezaugarriak

Nola iristen zaien benetan bazkide baten erreferentzia-komisioa — ehunekoa, ordainketa-mekanismoa eta aurre-baldintzak.

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
}

Ordainketa-baldintzak

• Iragarkiaren ordaindu beharreko irabazi osoek gutxieneko ordainketa-kopurua lortzen dute.
• Haien kontuan kripto-ordainketa-zorro bat konfiguratuta dago.
• Haien KYC egoera egiaztatuta dago.

Adibidea: pilatutako irabaziak irakurtzea

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
}

Prezio-mailak (zuzenekoa)

Irakurri zuzenean endpoint honetatik — ez ezazu balio hauek inoiz kode gogorrean idatzi, gure aldetik aldatu daitezke. Erabili maila-auketagailu bat zure erabiltzaileentzat zenbateko-eremu libre baten ordez: erakusten den prezio bakoitza ordainketa sortzean bidali beharreko zenbateko zehatza da, eta hemen agertzen diren desblokeatutako onurak erabiltzaileei zehazki azaltzen diete prezio horrek zer eskaintzen dien, beraz, zenbaki bat asmatu beharrean ulertzen duten prezio bat hautatzen dute.

Eskaerak gako bakoitzeko minutuko mugatuta daude. Erantzun autentifikatu bakoitzak X-RateLimit-Limit, X-RateLimit-Remaining eta X-RateLimit-Reset buru-ilarak daramatza; muga gainditzeak 429 Eskaera Gehiegi akats-kodea itzultzen du Retry-After buru-ilara batekin.

Aukerakoa, bazkide bakoitzeko. Sarrera bat gehitu arte, zure gakoek edozein IP helbidetatik datozen eskaerak onartzen dituzte — lehen sarrerak bazkide horren gako guztiak soilik onartzeko zerrendan egotera aldatzen ditu.

Webhook bakoitza HMAC-SHA256 bidez sinatzen da, sortze unean behin emandako sekretu batekin — sinadura egiaztatu karga konfiantzaz onartu aurretik. Ekitaldiak soilik jasotzen ditu iragarleari dagokion bazkideak.