Þróunaraðilaskjöl

Öllum beiðnum er vottað með leynilykli í Authorization-hausnum, með Bearer-skema.

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

Ef API-lyklarnir þínir búa til auglýsingareikninga fyrir eigin notendur (Connect-hamur — sjá Auðkenningu hér að ofan), færðu hlutdeild í því sem þessir auglýsendur greiða fyrir auglýsingarnar sínar. Hlutdeildarskiptingin hér að neðan er lesin beint úr sama endapunkti, aldrei kóðað beint inn, og er algjörlega aðskilin frá tilvísunarkommissjóninni neðar á þessari síðu.

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

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

Hvernig það virkar

1. Einn af auglýsingaraðilum þínum í Connect-ham greiðir fyrir auglýsingu í gegnum samþættinguna þína.
2. Auglýsingin er yfirfarin og samþykkt — sjálfkrafa eða af miðlunarhópi okkar.
3. Þinn hluti er í biðröð til sjálfvirkrar úttektar í veskið þitt, sama kerfi og í tilvísunarprógramminu hér að neðan.

Útborgunarskilyrði

• Krypto-útborgunarpoki er stilltur á samstarfsaðilareikningnum þínum.
• Engin KYC-staðfesting er nauðsynleg af þinni hálfu — reikningi samstarfsaðila þíns hefur þegar verið staðfestur við stofnun.

Dæmi: lesa uppsöfnuð hlutabréf

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
}

Hver auglýsingareikningur fær innbyggðan sett af gervigreindartólum — tól til að búa til auglýsingainnihald og sjónrænt efni, samtalsaðstoð, fjárhagsráðgjafa og ytri SEO-endurskoðanda — sem greitt er fyrir með gervigreindarkredítum ofan á fasta ársgjaldið.

Dæmi — búa til auglýsingainnihald

Sama flokkur og fyrirtækislýsing knýja einnig myndagerðartólið hér að neðan.

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
}

Búðu til samsvarandi sjónrænt efni fyrir sömu auglýsinguna:

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
}

Slepptu tilbúnum auglýsingaeiningu á eigin vefsíðu — engin uppsetningarstig, enginn iframe. Skriftan birtir beint í síðunni innan einangraðs Shadow DOM, svo stílar hennar berast aldrei inn á síðuna þína og stílar síðunnar þinnar berast aldrei inn í hana.

Bættu því við síðuna þína

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

Venjulega sýnir þetta alla opinbera röðun flokksins — alla auglýsingaraðila á vettvanginum, ekki bara þá sem þú hefur bætt við. Til að sýna aðeins auglýsingar frá auglýsingaraðilum sem þú bjóst til í gegnum Connect-ham (þeir sem mynda þinn hlut), bætirðu við data-partner með partner ID-inu þínu (finnst á Developers-síðunni á eigin mælaborð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>

Ef auglýsingaraðilar þínir ná yfir nokkra flokka, slepptu data-category alveg — með data-partner einu og sér sýnir viðmótið allar auglýsingar þínar í öllum flokkum í einu ristin, í stað þess að þurfa einn viðmótsblokk fyrir hvern flokk:

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

Viltu hafa einingu í fótarlínustíl hlið við þá einingu sem er í meginmáli og láta hvoru um sig sýna mismunandi auglýsingar? Bættu við öðru widget-blokki með data-layout="compact" (ein auglýsing, samanbrjótanleg í litla töflu) og stilltu data-offset eftir því hversu margar auglýsingar fyrsta widget-ið þitt sýnir nú þegar:

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

Eiginleikar

Hvernig tilvísunarkoma samstarfsaðila berst til þeirra — hlutfallið, greiðslumekanismi og forsendurnar.

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
}

Útborgunarskilyrði

• Heildargreiðanlegar tekjur auglýsanda ná lágmarksútborgunarfjárhæðinni.
• Krypto-útborgunarpoki er stilltur á reikningnum þeirra.
• KYC-staða þeirra er staðfest.

Dæmi: Lesa uppsöfnuð tekjur

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
}

Verðlagsstigin (í beinni)

Lesið beint úr þessum endapunkti — kóðið aldrei þessi gildi beint inn, þau geta breyst hjá okkur. Búðu til verðflokkavalið fyrir notendur þína í stað reits fyrir frjálsan upphæð: hvert verð sem sýnt er er nákvæmlega sú upphæð sem þarf að senda við greiðslugerð, og þær fríðindi sem opnast við hvert verð sýna notendum nákvæmlega hvað verðið felur í sér, svo þeir geti valið verð sem þeir skilja í stað þess að giska á tölu.

Beiðnir eru takmarkaðar á lykil á mínútu. Öllu staðfestu svari fylgja hausarnir X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset; ef farið er yfir takmörkin er skilað kóðanum 429 Too Many Requests með Retry-After haus.

Valfrjálst, fyrir hvern maka. Þangað til þú bætir við færslu samþykkja lyklar þínir beiðnir frá hvaða IP-tölu sem er — fyrsta færslan setur alla lykla þess maka eingöngu á leyfilegan lista.

Hver webhook er undirritaður með HMAC-SHA256 með leyndarorði sem er gefið út einu sinni við stofnun — staðfestu undirskriftina áður en þú treystir gögnum webhook-sins. Atburðir eru sendir aðeins til samstarfsaðila sem á viðkomandi auglýsingaraðila.