ডেভেলপাৰৰ নথিপত্ৰ

প্ৰতিটো অনুৰোধ Authorization হেডাৰত থকা এটা গোপন কী-ৰ দ্বাৰা Bearer স্কীম ব্যৱহাৰ কৰি প্ৰমাণীকৰণ কৰা হয়।

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
}

প্ৰতিটো বিজ্ঞাপনদাতাৰ একাউণ্টত কিছুমান বিল্ট-ইন এআই সঁজুলি থাকে — যেনে এটা বিজ্ঞাপনৰ বিষয়বস্তু আৰু ভিজুৱেল জেনেৰেটৰ, এটা কথোপকথনমূলক সহায়ক, এটা বাজেট উপদেষ্টা, আৰু এটা বাহ্যিক এছইঅ' অডিটৰ — যাৰ বাবে ফ্লেট বাৰ্ষিক মূল্যৰ উপৰিও এআই ক্ৰেডিটৰ জৰিয়তে পৰিশোধ কৰিব লাগে।

উদাহৰণ — বিজ্ঞাপনৰ সমল সৃষ্টি কৰক

একেটা শ্ৰেণী আৰু ব্যৱসায়ৰ বিৱৰণে তলৰ ছবি সৃষ্টিকাৰকটোও চালিত কৰে।

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
}

পৰিশোধৰ চৰ্ত

• বিজ্ঞাপনদাতাৰ মুঠ পৰিশোধযোগ্য উপাৰ্জন ন্যূনতম পৰিশোধৰ পৰিমাণত উপনীত হয়।
• তেওঁলোকৰ একাউণ্টত এটা ক্ৰিপ্টো পে'আউট ৱালেট কনফিগাৰ কৰা হৈছে।
• তেওঁলোকৰ KYC স্থিতি পৰীক্ষিত হৈছে।

উদাহৰণ: সঞ্চিত উপাৰ্জন পঢ়া

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 ভুল ঘূৰাই দিয়া হয়।

বৈকল্পিক, প্ৰতিজন অংশীদাৰৰ বাবে। আপুনি এটা এণ্ট্ৰি যোগ নকৰালৈকে, আপোনাৰ কীসমূহে যিকোনো IP-ৰ পৰা অহা অনুৰোধ গ্ৰহণ কৰে — প্ৰথমটো এণ্ট্ৰিয়ে সেই অংশীদাৰৰ সকলো কীসমূহ কেৱল এলাৱলিস্ট-ৰ বাবে সেট কৰে।

প্ৰতিটো ৱেবহুক, সৃষ্টিৰ সময়ত এবাৰ জাৰি কৰা এক গোপন ক'ড ব্যৱহাৰ কৰি HMAC-SHA256-ৰ দ্বাৰা স্বাক্ষৰিত হয় — পেলোডটোক বিশ্বাস কৰাৰ আগতে স্বাক্ষৰটো পৰীক্ষা কৰক। ইভেন্টসমূহ কেৱল সেই অংশীদাৰকহে প্ৰেৰণ কৰা হয় যিজন সংশ্লিষ্ট বিজ্ঞাপনদাতাৰ মালিক।