Doiciméadú forbróra

Fíoraítear gach iarratas le heochair rúnda san eite Ceadúnaithe, ag úsáid scéim an iompróra.

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

Má chruthaíonn do chuid eochracha API cuntais fhógróirí do do chuid úsáideoirí féin (mód Ceangail — féach ar Fhíordheimhniú thuas), tuillfidh tú sciar den mhéid a íocann na fógróirí sin as a gcuid fógraí. Léitear an roinnt thíos beo ón deireadhphointe céanna seo, ní chuirtear isteach i gcód riamh í, agus tá sí ar leithligh go hiomlán ón gcoimisiún atreoraithe níos faide síos ar an leathanach seo.

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

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

An chaoi a n-oibríonn sé

1. Íocann duine de d'fhógróirí i mód Connect as fógra trí d'chomhtháthú.
2. Déantar an fógra a athbhreithniú agus a cheadú — go huathoibríoch, nó ag ár bhfoireann measarthachta.
3. Tá do sciar curtha sa scuaine le haghaidh íocaíocht uathoibríoch isteach i do sparán, an mheicníocht chéanna leis an gclár atreoraithe thíos.

Coinníollacha íocaíochta

• Tá sparán íocaíochta criptea cumraithe ar do chuntas comhpháirtí.
• Níl aon KYC ag teastáil uaitse — tá cuntas do pháirtí gáiríofa cheana féin ó cruthaíodh é.

Sampla: scaireanna carntha a léamh

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
}

Faigheann gach cuntas fógraí sraith d'uirlisí intleachta saorga ionsuite — gineadóir ábhair fógraí agus ábhair amhairc, cúntóir comhráiteach, comhairleoir buiséid, agus iniúchóir SEO seachtrach — a íoctar astu le creidmheasanna IS, sa bhreis ar an bpraghas bliantúil comhréidh.

Sampla — giniúint ábhar fógraíochta

Is iad an chatagóir chéanna agus an cur síos gnó céanna a chumhachtaíonn an gineadóir íomhánna thíos freisin.

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
}

Gineadh léargas meaitseála don fhógra céanna:

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
}

Scaoil aonad fógra réamhdhéanta ar do shuíomh féin — gan aon chéim tógála, gan iframe. Rindreálann an script go díreach isteach sa leathanach laistigh de Shadow DOM aonraithe, ionas nach sceitheann a stíleanna riamh isteach i do shuíomh, agus nach sceitheann stíleanna do shuímh riamh isteach ann.

Cuir le do leathanach é

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

De réir réamhshocraithe, taispeánann sé seo rangú iomlán poiblí an chatagóir — gach fógraí ar an ardán, ní hamháin na cinn a thug tú isteach. Chun na fógraí amháin a thaispeáint ó na fógraí a chruthaigh tú trí mhodh Connect (na cinn a ghineann do sciar), cuir data-partner le d'aitheantas comhpháirtí (faigh é ar leathanach na bhForbróirí ar do phainéal ionstraimí féin):

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

Má chuimsíonn do chuid fógraí roinnt catagóirí, fág data-category ar lár go hiomlán — le data-partner amháin, taispeánann an giuirléid gach ceann de do chuid fógraí ar fud na gcatagóirí go léir i ngríde amháin, seachas a bheith ag teastáil bloc giuirléide amháin do gach catagóir:

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

Ar mhaith leat aonad i stíl bonn leathanaigh in éineacht leis an gceann i do chuid ábhair, agus gach ceann acu ag taispeáint fógraí éagsúla? Cuir an dara bloc giuirléide leis an data-layout="compact" (fógra aonair, in-chomhdhlúthaithe ina phiolla bheag) agus an data-offset socraithe de réir an líon fógraí a thaispeánann do chéad ghiuirléid cheana féin:

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

Airíonna

Conas a shroicheann coimisiún atreoraithe comhpháirtí iad i ndáiríre — an céatadán, an sásra íocaíochta, agus na réamhriachtanais.

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
}

Coinníollacha íocaíochta

• Sroicheann tuarastal iomlán iníoctha an fhógróra an t-íosmhéid íocaíochta.
• Tá sparán íocaíochta críptí cumraithe ar a gcuntas.
• Tá a stádas KYC fíoraithe.

Sampla: ag léamh tuillimh charnaithe

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
}

Leibhéil praghsála (bheo)

Léigh beo ón gcríochphointe seo — ná crua-chódáil na luachanna seo choíche, mar is féidir leo athrú ar ár dtaobh. Tóg roghnóir sraithe do do chuid úsáideoirí féin in ionad réimse méide saor in aisce: is é an praghas a thaispeántar an méid cruinn atá le seoladh cheana féin agus an íocaíocht á cruthú, agus insíonn na buntáistí díghlasáilte a thaispeántar anseo d'úsáideoirí go díreach cad a fhaigheann siad as an bpraghas sin, ionas go roghnaíonn siad praghas a thuigeann siad in ionad a bheith ag buille faoi thuairim faoi uimhir.

Tá teorainn le hiarratais in aghaidh an eochrach, in aghaidh na nóiméide. I ngach freagra fíoraithe, bíonn na ceannteidil X-RateLimit-Limit, X-RateLimit-Remaining, agus X-RateLimit-Reset i gceist; má sháraítear an teorainn, tugtar an cód earráide 429 Too Many Requests ar ais, mar aon leis an gceanntás Retry-After.

Roghnach, in aghaidh an chomhpháirtí. Go dtí go gcuireann tú iontráil leis, glacann do chuid eochracha le hiarratais ó aon seoladh IP — le chéad iontráil, athraítear eochracha uile an chomhpháirtí sin go modh liosta ceada amháin.

Sínítear gach webhook le HMAC-SHA256 ag úsáid rúin a eisítear uair amháin, tráth an chruthaithe — fíoraigh an síniú sula gcuirtear muinín sa lastas. Seachadtar imeachtaí go dtí an comhpháirtí amháin a bhfuil an fógraí gaolmhar ina sheilbh aige.