विकासकर्ता कागजात

प्रत्येक अनुरोधलाई Authorization हेडरमा Bearer स्कीम प्रयोग गरी गोप्य कुञ्जीद्वारा प्रमाणीकरण गरिन्छ।

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

यदि तपाईंका API कुञ्जीहरूले तपाईंका आफ्नै प्रयोगकर्ताहरूका लागि विज्ञापनदाता खाताहरू सिर्जना गर्छन् (Connect मोड — माथिको प्रमाणीकरण हेर्नुहोस्), तपाईं ती विज्ञापनदाताहरूले आफ्ना विज्ञापनहरूका लागि तिर्ने रकमको एक हिस्सा कमाउनुहुन्छ। तल दिइएको विभाजन यही एन्डपोइन्टबाट प्रत्यक्ष पढिने हो, कहिल्यै हार्डकोड गरिएको होइन, र यो पृष्ठको तलतिरको रेफरल कमिसनबाट पूर्ण रूपमा अलग छ।

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
}

तयार विज्ञापन युनिट आफ्नो साइटमा ड्रप गर्नुहोस् — कुनै निर्माण चरण छैन, कुनै iframe छैन। स्क्रिप्ट पृथक 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>

डिफल्ट रूपमा यसले श्रेणीको पूर्ण सार्वजनिक र्याङ्किङ देखाउँछ — प्लेटफर्मका सबै विज्ञापनदाताहरू, केवल तपाईंले ल्याउनुभएका मात्र होइन। केवल Connect मोडमार्फत तपाईंले सिर्जना गर्नुभएका विज्ञापनदाताहरूका विज्ञापनहरू मात्र देखाउन (जसले तपाईंको हिस्सा उत्पन्न गरिरहेका छन्), आफ्नो पार्टनर ID सहित data-partner थप्नुहोस् (यो तपाईंको आफ्नै ड्यासबोर्डको Developers पृष्ठमा पाउन सकिन्छ):

<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 ले हस्ताक्षर गरिएको हुन्छ — पेलोडमा विश्वास गर्नु अघि हस्ताक्षर प्रमाणित गर्नुहोस्। घटनाहरू सम्बन्धित विज्ञापनदाताको स्वामित्वमा रहेको साझेदारलाई मात्र पठाइन्छ।