Dokumentacioni i zhvilluesit

Çdo kërkesë autentikohet me një çelës sekret në kokën e Autorizimit, duke përdorur skemën Bearer.

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

Nëse çelësat tuaj të API-së krijojnë llogari reklamuesish për përdoruesit tuaj (mënyra Connect — shih Autentifikimin më lart), ju fitoni një pjesë të asaj që këta reklamues paguajnë për reklamat e tyre. Ndërndarja më poshtë lexohet drejtpërdrejt nga i njëjti endpoint, kurrë e koduar në mënyrë statike, dhe është krejtësisht e ndarë nga komisioni i referimit më poshtë në këtë faqe.

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

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

Si funksionon

1. Një nga reklamuesit tuaj në modalitetin Connect paguan për një reklamë përmes integrimit tuaj.
2. Reklama rishikohet dhe miratohet — automatikisht, ose nga ekipi ynë i moderimit.
3. Pjesa juaj është në radhë për pagesë automatike në portofolin tuaj, i njëjti mekanizëm si programi i referimit më poshtë.

Kushtet e pagesës

• Një portofol për pagesa kriptomonedhash është konfiguruar në llogarinë tuaj të partnerit.
• Nuk kërkohet KYC nga ana juaj — llogaria juaj e partnerit është tashmë e verifikuar që në krijim.

Shembull: lexim i aksioneve të grumbulluara

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
}

Çdo llogari e reklamuesit përfiton një grup mjetesh të integruara të inteligjencës artificiale — një gjenerator përmbajtjeje dhe vizualesh për reklama, një asistent bisedues, një këshilltar buxheti dhe një auditor i jashtëm SEO — të paguara me kredite AI, përveç çmimit fiks vjetor.

Shembull — gjeneroni përmbajtje reklame

E njëjta kategori dhe përshkrimi i biznesit gjithashtu ushqejnë gjeneratorin e imazheve më poshtë.

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
}

Gjeneroni një pamje përkatëse për të njëjtën reklamë:

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
}

Shto një njësi reklame të gatshme në faqen tënde — pa asnjë hap ndërtimi, pa iframe. Skripti shfaqet drejtpërdrejt në faqe brenda një Shadow DOM të izoluar, kështu që stilet e tij kurrë nuk rrjedhin në faqen tënde, dhe stilet e faqes tënde kurrë nuk rrjedhin në të.

Shto atë në faqen tënde

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

Si parazgjedhje, kjo tregon renditjen publike të plotë për kategorinë — çdo reklamues në platformë, jo vetëm ata që i sollët ju. Për të shfaqur vetëm reklamat nga reklamuesit që keni krijuar përmes modalitetit Connect (ata që gjenerojnë pjesën tuaj), shtoni data-partner me ID-në e partnerit tuaj (gjejeni në faqen e Zhvilluesve të panelit tuaj):

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

Nëse reklamuesit tuaj përfshijnë disa kategori, hiqni plotësisht data-category — me vetëm data-partner, widget-i tregon çdo reklamë tuajën në të gjitha kategoritë në një rrjetë, në vend që të keni nevojë për një bllok widget-i për çdo kategori:

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

Dëshironi një njësi në stil footer pranë asaj në përmbajtje, secila duke shfaqur reklama të ndryshme? Shtoni një bllok të dytë widget me data-layout="compact" (një reklamë e vetme, e palosshme në një pilulë të vogël) dhe data-offset të vendosur në numrin e reklamave që widget-i juaj i parë tashmë shfaq:

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

Atributet

Si i arrin me të vërtetë një partneri komisioni i referimit — përqindja, mekanizmi i pagesës dhe parakushtet.

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
}

Kushtet e pagesës

• Të ardhurat totale të pagueshme të reklamuesit arrijnë shumën minimale të pagesës.
• Një portofol për pagesa kriptomonedhash është konfiguruar në llogarinë e tyre.
• Statusi i tyre KYC është verifikuar.

Shembull: lexim i të ardhurave të akumuluara

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
}

Nivelet e çmimeve (live)

Lexoni drejtpërdrejt nga ky pikë fundor — mos i kodoni kurrë këto vlera në mënyrë statike, ato mund të ndryshojnë nga ana jonë. Ndërto një zgjedhës niveli për përdoruesit tuaj në vend të një fushe për shumën e lirë: çdo çmim i shfaqur është tashmë shuma e saktë për t'u dërguar kur krijohet pagesa, dhe përfitimet e zhbllokuara të shfaqura këtu u tregojnë përdoruesve saktësisht çfarë u siguron ai çmim, kështu që ata zgjedhin një çmim që e kuptojnë në vend që të hamendësojnë një numër.

Kërkesat janë të kufizuara për çelës, për minutë. Çdo përgjigje e autentifikuar përmban kokërat X-RateLimit-Limit, X-RateLimit-Remaining dhe X-RateLimit-Reset; tejkalimi i kufirit kthen kodin e gabimit 429 Too Many Requests me kokërën Retry-After.

Opsionale, për partner. Deri sa të shtoni një hyrje, çelësat tuaj pranojnë kërkesa nga çdo IP — hyrja e parë i vendos të gjitha çelësat e atij partneri vetëm në listën e lejuar.

Çdo webhook nënshkruhet me HMAC-SHA256 duke përdorur një sekret të lëshuar një herë, në kohën e krijimit — verifikoni nënshkrimin para se t'i besoni ngarkesës. Ngjarjet dorëzohen vetëm partnerit që zotëron reklamuesin përkatës.