மேம்படுத்துநர் ஆவணங்கள்

ஒவ்வொரு கோரிக்கையும், பெய்ரர் திட்டத்தைப் பயன்படுத்தி, அங்கீகாரத் தலைப்பில் உள்ள ஒரு இரகசியத் திறவுகோலால் சரிபார்க்கப்படுகிறது.

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. உங்கள் பங்கு, கீழே உள்ள பரிந்துரைத் திட்டத்தைப் போன்றே, உங்கள் வாலெட்டிற்கு தானாகவே செலுத்தப்படுவதற்காக வரிசைப்படுத்தப்பட்டுள்ளது.

பணம் செலுத்தும் நிபந்தனைகள்

• உங்கள் கூட்டாளர் கணக்கில் ஒரு கிரிப்டோ செலுத்துகை பணப்பை கட்டமைக்கப்பட்டுள்ளது.
• உங்கள் தரப்பில் KYC எதுவும் தேவையில்லை — உங்கள் கூட்டாளர் கணக்கு உருவாக்கப்படும்போதே ஏற்கனவே சரிபார்க்கப்பட்டுவிட்டது.

உதாரணம்: சேகரிக்கப்பட்ட பங்குகளைப் படித்தல்

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
}

ஒவ்வொரு விளம்பரதாரர் கணக்கிற்கும், நிலையான வருடாந்திர விலையின் கூடுதலாக AI கிரெடிட்டுகள் மூலம் செலுத்தப்படும், உள்ளமைக்கப்பட்ட AI கருவிகளின் ஒரு தொகுப்பு கிடைக்கிறது — ஒரு விளம்பர உள்ளடக்கம் மற்றும் காட்சி ஜெனரேட்டர், ஒரு உரையாடல் உதவியாளர், ஒரு வரவுசெலவு ஆலோசகர், மற்றும் ஒரு வெளிப்புற SEO தணிக்கையாளர்.

உதாரணம் — விளம்பர உள்ளடக்கத்தை உருவாக்கு

கீழே உள்ள பட உருவாக்கிகளுக்கும் அதே வகை மற்றும் வணிக விளக்கமே பயன்படுகிறது.

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
}

தயார்நிலை விளம்பர அலகை உங்கள் தளத்தில் செருகவும் — உருவாக்கும் படியில்லை, iframe-ம் தேவையில்லை. இந்த ஸ்கிரிப்ட் ஒரு தனிப்படுத்தப்பட்ட ஷேடோ 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
}

விலைப் படிகள் (நேரலை)

இந்த எண்ட் பாயிண்டிலிருந்து நேரடியாகப் படிக்கவும் — இந்த மதிப்புகளை ஹார்ட்கோடு செய்ய வேண்டாம், அவை எங்கள் தரப்பில் மாறக்கூடும். இலவச அளவு புலத்திற்குப் பதிலாக உங்கள் பயனர்களுக்காக ஒரு அடுக்கு தேர்வானை உருவாக்குங்கள்: காட்டப்படும் ஒவ்வொரு விலையும் பணம் செலுத்தும்போது அனுப்ப வேண்டிய சரியான தொகையாகும், மேலும் இங்கே காட்டப்படும் திறக்கப்பட்ட நன்மைகள் அந்த விலைக்குப் பயனர்களுக்கு என்ன கிடைக்கும் என்பதைத் துல்லியமாகத் தெரிவிக்கின்றன, எனவே அவர்கள் ஒரு எண்ணை யூகிக்காமல் தங்களுக்குப் புரியும் விலையைத் தேர்ந்தெடுக்கிறார்கள்.

விண்ணப்பங்கள் ஒவ்வொரு கீ-க்கும், ஒவ்வொரு நிமிடத்திற்கும் வரம்பிடப்பட்டுள்ளன. ஒவ்வொரு சரிபார்க்கப்பட்ட பதிலும் X-RateLimit-Limit, X-RateLimit-Remaining, மற்றும் X-RateLimit-Reset ஹெட்டர்களைக் கொண்டுள்ளது; வரம்பை மீறினால், Retry-After ஹெட்டருடன் 429 Too Many Requests என்ற பிழைத்தகவல் திருப்பியனுப்பப்படும்.

விருப்பத்தேர்வு, ஒவ்வொரு கூட்டாளருக்கும். நீங்கள் ஒரு பதிவைச் சேர்க்கும் வரை, உங்கள் சாவிகள் எந்தவொரு IP-யிடமிருந்தும் கோரிக்கைகளை ஏற்கும் — முதல் பதிவு அந்தக் கூட்டாளரின் அனைத்து சாவிகளையும் அனுமதிப்பட்டியல்-மட்டும் பயன்முடிக்கு மாற்றுகிறது.

ஒவ்வொரு வெப்ஹூக்கும், உருவாக்கும் நேரத்தில் ஒருமுறை வழங்கப்படும் இரகசியத்தைப் பயன்படுத்தி HMAC-SHA256 கொண்டு கையொப்பமிடப்படுகிறது — பேலோடை நம்புவதற்கு முன்பு கையொப்பத்தைச் சரிபார்க்கவும். தொடர்புடைய விளம்பரதாரரைச் சொந்தமாகக் கொண்ட கூட்டாளிக்கு மட்டுமே நிகழ்வுகள் வழங்கப்படுகின்றன.