Teuliadur an diorroer

Pep goulenn a vez gwiriekaet gant un alc'hwez kuzh en talbenn Aotren, en ur implijout ar steuñv Bearer.

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

Ma krou ho alc'hwezioù API kontoù bruderien evit hoc'h implijerien hoc'h-unan (mod Connect — gwelet an Testeniekaat a-us), e c'hounezit ul lodenn eus ar pezh a bae ar bruderien-se evit o bruderezhioù. Lennet e vez al lodennadur a-is war-eeun adalek an hevelep poent-termen, biskoazh kodet en diazez, hag emren-krenn eo diouzh ar gomision dave a-isoc'h war ar bajenn-mañ.

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

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

Penaos ez a en-dro

1. Unan eus ho bruderien e mod Connect a bae evit ur bruderezh dre hoc'h enframmadur.
2. Adwelet ha degemeret eo ar bruderezh — ent emgefreek, pe gant hor skipailh moderadur.
3. Ho lodenn a zo lakaet er renkenn evit bezañ paeet ent emgefreek war ho yalc'h, ar memes mekanism hag evit ar programm erbediñ a-is.

Divizoù paeañ

• Ur yalc'had paeañ kripto a zo kefluniet war ho kont keveler.
• N'eus ket ezhomm eus KYC a-berzh deoc'h — gwiriet e vez kont ho par diouzhtu pa vez krouet.

Skouer : lenn ar lodennoù dastumet

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
}

Pep kont bruder a resev un heuliad ostilhoù IA enframmet — ur c'henelerez danvez bruderezh ha skeudennoù, un eiler eskemm, un alier budjed, hag un enseller SEO diavaez — paeet gant kredadoù IA, ouzhpenn ar priz bloaziek plat.

Skouer — krouiñ danvez bruderezh

Ar memes rummad hag an deskrivadur aferioù a vez implijet ivez evit ar c'henerator skeudennoù a-is.

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
}

Krouiñ ur skeudenn a glot gant ar bruderezh heñvel :

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
}

Lakait un unvez bruderezh prest da implijout war ho lec'hienn hoc'h-unan — hep pazenn sevel, hep iframe. Ar skript a vez diskouezet war-eeun er bajenn e-barzh ur Shadow DOM digenvez, evel-se ne dreuz ket morse e stiloù war ho lec'hienn, ha ne dreuz ket re ho lec'hienn warnañ kennebeut.

Ouzhpennit anezhañ d'ho pajenn

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

Dre ziouer e tiskouez kement-mañ renkadur hollek foran ar rummad — an holl vruderien war ar savenn, ha n'eo ket hepken ar re hoc'h eus degaset. Evit diskouez nemet bruderezhioù ar vruderien hoc'h eus krouet dre ar mod Kevreañ (ar re a c'henel ho lodenn), ouzhpennit data-partner gant ID ho keveler (da gavout war bajenn an Diorroerien eus ho taolenn-stur deoc'h-c'hwi):

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

Ma'z eus ho bruderien e meur a rummad, lezit a-gostez data-category penn-da-benn — gant data-partner hepken e tiskouez ar widget hoc'h holl vruderezhioù en holl rummadoù en ur gaelenn hepken, e-lec'h kaout ezhomm eus ur bloc'had widget dre rummad :

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

C'hoant ho peus kaout un unanenn doare footer e-kichen an hini en ho kendalc'h, ha pep hini anezho o tiskouez bruderezhioù disheñvel ? Ouzhpennit un eil bloc'had widget gant data-layout="compact" (ur bruderezh hepken, a c'haller plegañ en ur bilenn vihan) ha data-offset lakaet da dalvezout da niver a vruderezhioù a ziskouez ho widget kentañ dija :

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

Perzhioù

Penaos e vez paeet e gwirionez ur gomision kasadenn d'ur c'heveler — ar dregantad, an doare paeañ, hag an a-raok-divizoù.

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
}

Divizoù paeañ

• Korvoderioù hollek paeüs ar bruder a dizh ar sammad paeañ bihanañ.
• Ur yalc'had paeañ kripto a zo kefluniet war o c'hont.
• Gwiriet eo o statud KYC.

Skouer : lenn ar gounidoù dastumet

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
}

Liveoù prizioù (war-eeun)

Lennet war-eeun adalek an tenn-mañ — na skrivit ket ar talvoudoù-mañ en kod, gallout a reont cheñch a-berzhimp. Savet ur choazer liveoù evit ho implijerien hoc'h-unan e-lec'h ur vaezenn sammad digoust : pep priz diskouezet eo dija ar sammad resis da gas pa vez krouet ar paeamant, hag ar spletoù digoret diskouezet amañ a lavar d'an implijerien resis petra a c'hounezont gant ar priz-se, evel-se e tibabont ur priz a gomprenont e-lec'h divinout un niverenn.

Bevennet eo ar goulennoù dre alc'hwez, dre vunutenn. Pep respont gwiriet a zoug an talbennoù X-RateLimit-Limit, X-RateLimit-Remaining, hag X-RateLimit-Reset; pa vez tremenet ar vevenn e vez distroet ur statud 429 Re a c'houlennoù gant an talbenn Retry-After.

Direnket, dre geveler. Betek ma ouzhpennit un enmont, e vez degemeret ar goulennoù gant ho alc'hwezioù eus forzh peseurt chomlec'h IP — an enmont kentañ a laka holl alc'hwezioù ar c'heveler-se da vezañ war roll an aotreet hepken.

Pep webhook a zo sinet gant HMAC-SHA256 en ur implijout ur sekred roet ur wech hepken, da vare ar c'hrouiñ — gwiriekait ar sinadur a-raok fiziout er garg. An darvoudoù ne vezont kaset nemet d'ar c'heveler a zo perc'henn war ar bruder a denn dezho.