Dogfennaeth datblygwr

Mae pob cais yn cael ei ddilysu gyda allwedd gyfrinachol yn y penawd Awdurdodi, gan ddefnyddio'r cynllun Claf.

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

Os yw eich allweddi API yn creu cyfrifon hysbysebwyr ar gyfer eich defnyddwyr eich hun (modd Cysylltu — gweler Dilysu uchod), rydych yn ennill cyfran o'r hyn y mae'r hysbysebwyr hynny'n ei dalu am eu hysbysebion. Mae'r rhaniad isod yn cael ei ddarllen yn fyw o'r un penbwynt hwn, byth wedi'i galedgodio, ac mae'n gwbl ar wahân i'r comisiwn atgyfeirio ymhellach i lawr y dudalen hon.

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

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

Sut mae'n gweithio

1. Mae un o'ch hysbysebwyr modd Cysylltu yn talu am hysbyseb drwy eich integreiddiad.
2. Adolygir a chymeradwyir yr hysbyseb — yn awtomatig, neu gan ein tîm cymedroli.
3. Mae eich cyfran wedi'i rhoi yn y ciw i'w dalu'n awtomatig i'ch waled, yr un mecanwaith â'r rhaglen atgyfeirio isod.

Amodau talu

• Mae waled taliad crypto wedi'i ffurfweddu ar eich cyfrif partner.
• Nid oes angen KYC ar eich rhan chi — mae eich cyfrif partner eisoes wedi'i wirio wrth ei greu.

Enghraifft: darllen cyfranddaliadau wedi'u cronni

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
}

Mae pob cyfrif hysbysebu yn derbyn set o offer AI adeiledig — generadur cynnwys a delweddau ar gyfer hysbysebion, cynorthwyydd sgwrsiol, cynghorydd cyllideb, ac archwilydd SEO allanol — sy'n cael eu talu â chredydau AI, ar ben y pris blynyddol sefydlog.

Enghraifft — cynhyrchu cynnwys hysbyseb

Mae'r un categori a disgrifiad busnes hefyd yn pweru'r generadur delweddau isod.

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
}

Cynhyrchwch ddelwedd gydweddiadol ar gyfer yr un hysbyseb:

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
}

Gollwng uned hysbyseb barod i'w defnyddio ar eich gwefan eich hun — dim cam adeiladu, dim iframe. Mae'r sgript yn rendro'n uniongyrchol i'r dudalen o fewn Shadow DOM ar wahân, felly nid yw ei arddulliau byth yn llifo i'ch gwefan chi, ac nid yw arddulliau eich gwefan chi byth yn llifo iddi.

Ychwanegu at eich tudalen

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

Yn ddiofyn, mae hyn yn dangos safle cyhoeddus llawn y categori — pob hysbysebwr ar y platfform, nid dim ond y rhai rydych chi wedi'u hychwanegu. I ddangos dim ond yr hysbysebion gan yr hysbysebwyr rydych chi wedi'u creu drwy'r modd Cysylltu (y rhai sy'n cynhyrchu eich cyfran), ychwanegwch data-partner gyda'ch ID partner (dewch o hyd iddo ar dudalen Datblygwyr eich dangosfwrdd eich hun):

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

Os yw'ch hysbysebwyr yn ymestyn ar draws sawl categori, hepgorwch data-category yn gyfan gwbl — gyda data-partner yn unig, mae'r widget yn dangos pob un o'ch hysbysebion ar draws yr holl gategorïau mewn un grid, yn lle bod angen un bloc widget ar gyfer pob categori:

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

Eisiau uned arddull troedyn ochr yn ochr â'ch uned yn y cynnwys, a phob un yn dangos hysbysebion gwahanol? Ychwanegwch ail floc gwead gyda data-layout="compact" (hysbyseb sengl, y gellir ei chrebachu i bilsen fach) a data-offset wedi'i osod i faint o hysbysebion mae eich gwead cyntaf eisoes yn eu dangos:

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

Priodweddau

Sut mae comisiwn atgyfeirio partner yn cyrraedd y partner — y canran, y mecanwaith talu, a'r rhagofynion.

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
}

Amodau talu

• Mae cyfanswm enillion taladwy'r hysbysebwr yn cyrraedd y swm talu isaf.
• Mae waled taliad crypto wedi'i ffurfweddu ar eu cyfrif.
• Mae eu statws KYC wedi'i wirio.

Enghraifft: darllen enillion cronedig

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
}

Haenau prisio (byw)

Darllenwch yn fyw o'r pen pwynt hwn — peidiwch byth â chaledgodio'r gwerthoedd hyn, gallant newid ar ein hochr ni. Adeiladwch ddewisydd haenau ar gyfer eich defnyddwyr eich hun yn lle maes swm am ddim: mae pob pris a ddangosir eisoes yn swm union i'w anfon wrth greu'r taliad, ac mae'r manteision sydd wedi'u datgloi a ddangosir yma yn dweud wrth ddefnyddwyr yn union beth mae'r pris hwnnw'n ei gynnig iddynt, fel eu bod yn dewis pris y maent yn ei ddeall yn lle dyfalu rhif.

Mae ceisiadau wedi'u cyfyngu fesul allwedd, fesul munud. Mae pob ymateb wedi'i ddilysu yn cario'r penawdau X-RateLimit-Limit, X-RateLimit-Remaining, ac X-RateLimit-Reset; bydd mynd dros y terfyn yn dychwelyd 429 Too Many Requests gyda phennawd Retry-After.

Dewisol, fesul partner. Hyd nes y byddwch yn ychwanegu cofnod, mae eich allweddi'n derbyn ceisiadau o unrhyw IP — mae'r cofnod cyntaf yn newid holl allweddi'r partner hwnnw i fod yn rhestr-ganiatáu-yn-unig.

Mae pob gwe-grog yn cael ei arwyddo gyda HMAC-SHA256 gan ddefnyddio cyfrinair a gyhoeddir unwaith, adeg ei greu — gwiriwch y llofnod cyn ymddiried yn y llwyth. Caiff digwyddiadau eu danfon yn unig i'r partner sy'n berchen ar yr hysbysebwr cysylltiedig.