ഡെവലപ്പർ ഡോക്യുമെൻ്റേഷൻ

ഓരോ അഭ്യർത്ഥനയും, ബെയറർ സ്കീം ഉപയോഗിച്ച്, ഓതറൈസേഷൻ ഹെഡറിലെ ഒരു രഹസ്യ കീ ഉപയോഗിച്ച് പ്രാമാണീകരിക്കുന്നു.

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

നിങ്ങളുടെ API കീകൾ നിങ്ങളുടെ സ്വന്തം ഉപയോക്താക്കൾക്കായി പരസ്യം ചെയ്യുന്നവരുടെ അക്കൗണ്ടുകൾ സൃഷ്ടിക്കുകയാണെങ്കിൽ (കണക്ട് മോഡ് — മുകളിലുള്ള പ്രാമാണീകരണം കാണുക), ആ പരസ്യം ചെയ്യുന്നവർ അവരുടെ പരസ്യങ്ങൾക്കായി നൽകുന്ന പണത്തിൽ നിന്ന് നിങ്ങൾക്ക് ഒരു വിഹിതം ലഭിക്കും. താഴെ നൽകിയിട്ടുള്ള വിഹിതം ഈ എൻഡ്‌പോയിന്റിൽ നിന്ന് തത്സമയം വായിക്കുന്നതാണ്, ഒരിക്കലും ഹാർഡ്‌കോഡ് ചെയ്തിട്ടില്ല, കൂടാതെ ഈ പേജിന്റെ താഴെയുള്ള റെഫറൽ കമ്മീഷനിൽ നിന്ന് ഇത് പൂർണ്ണമായും വേറിട്ടതുമാണ്.

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

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

ഇത് എങ്ങനെ പ്രവർത്തിക്കുന്നു

1. നിങ്ങളുടെ കണക്ട്-മോഡ് പരസ്യം ചെയ്യുന്നവരിൽ ഒരാൾ നിങ്ങളുടെ ഇന്റഗ്രേഷൻ വഴി ഒരു പരസ്യത്തിന് പണം നൽകുന്നു.
2. പരസ്യം അവലോകനം ചെയ്യുകയും അംഗീകരിക്കുകയും ചെയ്യുന്നു — സ്വയമേവയോ അല്ലെങ്കിൽ ഞങ്ങളുടെ മോഡറേഷൻ ടീം വഴിയോ.
3. നിങ്ങളുടെ ഷെയർ, താഴെ പറയുന്ന റഫറൽ പ്രോഗ്രാമിന് സമാനമായ രീതിയിൽ, നിങ്ങളുടെ വാലറ്റിലേക്ക് ഓട്ടോമാറ്റിക്കായി പണമായി നൽകുന്നതിനായി ക്യൂ ചെയ്തിരിക്കുന്നു.

പണമടയ്‌ക്കേണ്ട വ്യവസ്ഥകൾ

• നിങ്ങളുടെ പങ്കാളിത്ത അക്കൗണ്ടിൽ ഒരു ക്രിപ്റ്റോ പേഔട്ട് വാലറ്റ് കോൺഫിഗർ ചെയ്തിരിക്കുന്നു.
• നിങ്ങളുടെ ഭാഗത്തുനിന്ന് കെവൈസി ആവശ്യമില്ല — നിങ്ങളുടെ പാർട്ണർ അക്കൗണ്ട് ഉണ്ടാക്കുമ്പോൾ തന്നെ പരിശോധിച്ച് ഉറപ്പുവരുത്തിയിട്ടുണ്ട്.

ഉദാഹരണം: ശേഖരിക്കപ്പെട്ട ഷെയറുകൾ വായിക്കുക

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
}

ഓരോ പരസ്യം ചെയ്യുന്നവർക്കും ഒരു കൂട്ടം ബിൽറ്റ്-ഇൻ എഐ ടൂളുകൾ ലഭിക്കുന്നു — ഒരു പരസ്യ ഉള്ളടക്ക, വിഷ്വൽ ജനറേറ്റർ, ഒരു സംഭാഷണ സഹായി, ഒരു ബഡ്ജറ്റ് ഉപദേശകൻ, ഒരു എക്സ്റ്റേണൽ എസ്.ഇ.ഒ ഓഡിറ്റർ എന്നിവ. ഇതിനുള്ള പണമടവ്, വാർഷിക ഫ്ലാറ്റ് നിരക്കിന് പുറമെ എഐ ക്രെഡിറ്റുകൾ ഉപയോഗിച്ചാണ്.

ഉദാഹരണം — പരസ്യ ഉള്ളടക്കം ഉണ്ടാക്കുക

താഴെ കാണുന്ന ഇമേജ് ജനറേറ്ററിനും ഇതേ വിഭാഗവും ബിസിനസ് വിവരണവുമാണ് അടിസ്ഥാനമാക്കിയിരിക്കുന്നത്.

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
}

അതേ പരസ്യത്തിന് ഒരു യോജിച്ച ദൃശ്യം ഉണ്ടാക്കുക:

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
}

നിങ്ങളുടെ സ്വന്തം സൈറ്റിലേക്ക് റെഡിമെയ്ഡ് ആഡ് യൂണിറ്റ് ചേർക്കുക — ബിൽഡ് ഘട്ടമില്ല, ഇഫ്രെയിമില്ല. ഈ സ്ക്രിപ്റ്റ് ഒരു പ്രത്യേക ഷാഡോ ഡോമിനുള്ളിൽ (Shadow DOM) പേജിലേക്ക് നേരിട്ട് റെൻഡർ ചെയ്യുന്നു, അതിനാൽ അതിൻ്റെ സ്റ്റൈലുകൾ നിങ്ങളുടെ സൈറ്റിലേക്ക് ഒരിക്കലും കലരുകയില്ല, നിങ്ങളുടെ സൈറ്റിൻ്റെ സ്റ്റൈലുകൾ അതിലേക്കും കലരുകയില്ല.

അത് നിങ്ങളുടെ പേജിൽ ചേർക്കുക

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

ഡിഫോൾട്ടായി ഇത് കാറ്റഗറിയുടെ പൂർണ്ണമായ പബ്ലിക് റാങ്കിംഗ് കാണിക്കുന്നു — നിങ്ങൾ കൊണ്ടുവന്നവർ മാത്രമല്ല, പ്ലാറ്റ്‌ഫോമിലെ എല്ലാ പരസ്യം ചെയ്യുന്നവരെയും. കണക്ട് മോഡ് വഴി നിങ്ങൾ സൃഷ്ടിച്ച പരസ്യം ചെയ്യുന്നവരിൽ നിന്നുള്ള പരസ്യങ്ങൾ മാത്രം കാണിക്കുന്നതിന് (നിങ്ങളുടെ ഷെയർ ഉണ്ടാക്കുന്നവർ), നിങ്ങളുടെ പാർട്ണർ ഐഡി ഉപയോഗിച്ച് data-partner ചേർക്കുക (അത് നിങ്ങളുടെ സ്വന്തം ഡാഷ്‌ബോർഡിലെ ഡെവലപ്പേഴ്സ് പേജിൽ കണ്ടെത്തുക):

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

നിങ്ങളുടെ പരസ്യം ചെയ്യുന്നവർ പല വിഭാഗങ്ങളിലായി വ്യാപിച്ചിരിക്കുന്നുവെങ്കിൽ, 'data-category' എന്നത് പൂർണ്ണമായും ഒഴിവാക്കുക — 'data-partner' മാത്രം ഉപയോഗിക്കുന്നതിലൂടെ, ഓരോ വിഭാഗത്തിനും ഒരു വിഡ്ജറ്റ് ബ്ലോക്ക് ആവശ്യമില്ലാതെ, നിങ്ങളുടെ എല്ലാ വിഭാഗങ്ങളിലുമുള്ള പരസ്യങ്ങളും ഒരൊറ്റ ഗ്രിഡിൽ വിഡ്ജറ്റ് കാണിക്കും:

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

നിങ്ങളുടെ ഉള്ളടക്കത്തിലെ യൂണിറ്റിന് സമാന്തരമായി, ഓരോന്നും വ്യത്യസ്ത പരസ്യങ്ങൾ കാണിക്കുന്ന ഒരു ഫൂട്ടർ-സ്റ്റൈൽ യൂണിറ്റ് വേണോ? 'data-layout="compact"' (ഒരു ചെറിയ പില്ലിലേക്ക് ചുരുക്കാവുന്ന ഒറ്റ പരസ്യം) എന്നതും, നിങ്ങളുടെ ആദ്യത്തെ വിഡ്ജറ്റിൽ ഇതിനകം എത്ര പരസ്യങ്ങൾ കാണിക്കുന്നുണ്ടോ അതിനനുസരിച്ച് 'data-offset' സെറ്റ് ചെയ്യുകയും ചെയ്യുന്ന രണ്ടാമത്തെ വിഡ്ജറ്റ് ബ്ലോക്ക് ചേർക്കുക:

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

വിശേഷണങ്ങൾ

ഒരു പങ്കാളിയുടെ റെഫറൽ കമ്മീഷൻ യഥാർത്ഥത്തിൽ അവരെ എങ്ങനെയാണ് എത്തുന്നത് — ശതമാനക്കണക്ക്, പണമടയ്ക്കാനുള്ള സംവിധാനം, മുൻവ്യവസ്ഥകൾ.

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
}

പണമടയ്‌ക്കേണ്ട വ്യവസ്ഥകൾ

• പരസ്യം നൽകുന്നയാളുടെ നൽകേണ്ട ആകെ വരുമാനം ഏറ്റവും കുറഞ്ഞ പേഔട്ട് തുകയിലെത്തുന്നു.
• അവരുടെ അക്കൗണ്ടിൽ ഒരു ക്രിപ്‌റ്റോ പേഔട്ട് വാലറ്റ് കോൺഫിഗർ ചെയ്തിരിക്കുന്നു.
• അവരുടെ കെവൈസി സ്റ്റാറ്റസ് പരിശോധിച്ച് ഉറപ്പുവരുത്തിയിരിക്കുന്നു.

ഉദാഹരണം: സമ്പാദിച്ച വരുമാനം വായിക്കുക

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
}

വില നിരക്കുകൾ (തത്സമയം)

ഈ എൻഡ്പോയിന്റിൽ നിന്ന് തത്സമയം വായിക്കുക — ഈ മൂല്യങ്ങൾ ഒരിക്കലും ഹാർഡ്കോഡ് ചെയ്യരുത്, അവ ഞങ്ങളുടെ വശത്ത് മാറിയേക്കാം. സൗജന്യ തുക നൽകാനുള്ള ഫീൽഡിന് പകരം നിങ്ങളുടെ ഉപയോക്താക്കൾക്കായി ഒരു ഘട്ടം തിരഞ്ഞെടുക്കാനുള്ള സംവിധാനം (tier picker) ഉണ്ടാക്കുക: ഇവിടെ കാണിച്ചിരിക്കുന്ന ഓരോ വിലയും പണമടയ്ക്കുമ്പോൾ അയയ്‌ക്കേണ്ട കൃത്യമായ തുകയാണ്, കൂടാതെ ഇവിടെ കാണിച്ചിരിക്കുന്ന ലഭ്യമാകുന്ന ആനുകൂല്യങ്ങൾ ആ വിലയ്ക്ക് എന്താണ് ലഭിക്കുന്നതെന്ന് ഉപയോക്താക്കളെ കൃത്യമായി അറിയിക്കുന്നു. അതിനാൽ, ഒരു സംഖ്യ ഊഹിക്കുന്നതിന് പകരം അവർക്ക് മനസ്സിലാകുന്ന ഒരു വില തിരഞ്ഞെടുക്കാൻ സാധിക്കുന്നു.

ഓരോ കീയ്ക്കും മിനിറ്റിൽ അഭ്യർത്ഥനകൾ പരിമിതപ്പെടുത്തിയിരിക്കുന്നു. ഓരോ പ്രാമാണീകരിച്ച പ്രതികരണത്തിലും X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset ഹെഡറുകൾ ഉണ്ടായിരിക്കും; പരിധി കവിയുമ്പോൾ, Retry-After ഹെഡറോടുകൂടി 429 Too Many Requests എന്ന സന്ദേശം തിരികെ ലഭിക്കും.

ഓപ്ഷണൽ, ഓരോ പങ്കാളിക്കും. നിങ്ങൾ ഒരു എൻട്രി ചേർക്കുന്നതുവരെ, നിങ്ങളുടെ കീകൾ ഏത് ഐപിയിൽ നിന്നുമുള്ള അഭ്യർത്ഥനകൾ സ്വീകരിക്കും — ആദ്യത്തെ എൻട്രി ആ പങ്കാളിയുടെ എല്ലാ കീകളെയും അലോവ്ലിസ്റ്റ്-മാത്രമായി മാറ്റുന്നു.

ഓരോ വെബ്ഹുക്കിനും, ഉണ്ടാക്കുന്ന സമയത്ത് ഒരിക്കൽ നൽകുന്ന ഒരു രഹസ്യം ഉപയോഗിച്ച് HMAC-SHA256 ഉപയോഗിച്ച് സൈൻ ചെയ്തിരിക്കുന്നു — പെയ്‌ലോഡ് വിശ്വസിക്കുന്നതിന് മുമ്പ് ഒപ്പ് പരിശോധിക്കുക. ബന്ധപ്പെട്ട പരസ്യം ചെയ്യുന്നയാളുടെ ഉടമസ്ഥതയിലുള്ള പങ്കാളിക്ക് മാത്രമേ ഇവന്റുകൾ നൽകുകയുള്ളൂ.