ဖွံ့ဖြိုးသူစာရွက်စာတမ်းများ

တောင်းဆိုမှုတိုင်းကို Authorization ဟက်ဒါတွင် Bearer စကီးမဖြင့် လျှို့ဝှက်ကီးဖြင့် အတည်ပြုသည်။

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

သင့် API key များက သင့်ကိုယ်ပိုင်အသုံးပြုသူများအတွက် ကြော်ငြာရှင်အကောင့်များ ဖန်တီးပေးပါက (Connect mode — အထက် Authentication ကို ကြည့်ပါ) ထိုကြော်ငြာရှင်များက သူတို့ကြော်ငြာများအတွက် ပေးချေသော ငွေမှ သင့်အတွက် အစုရှယ်ယာ ရရှိပါမည်။ အောက်တွင် ဖော်ပြထားသည့် ခွဲဝေမှုကို ဤ endpoint မှ တိုက်ရိုက် ဖတ်ယူထားပြီး မည်သည့်အခါမျှ hardcoded မထားပါ၊ ထို့အပြင် ဤစာမျက်နှာအောက်တွင် ဖော်ပြထားသည့် referral commission နှင့်လည်း လုံးဝ သီးခြားဖြစ်ပါသည်။

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

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

ဒါဘယ်လိုအလုပ်လုပ်သလဲ

1. သင့် Connect-mode ကြော်ငြာရှင်တစ်ဦးသည် သင့်ပေါင်းစည်းမှုမှတဆင့် ကြော်ငြာတစ်ခုအတွက် ငွေပေးချေသည်။
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
}

ကြော်ငြာရှင်အကောင့်တိုင်းတွင် built-in AI ကိရိယာများ စုံလင်စွာ ပါဝင်ပြီး၊ ကြော်ငြာအကြောင်းအရာနှင့် ရုပ်ထွက်ဖန်တီးပေးသည့် ကိရိယာ၊ စကားပြောအကူအညီပေးသည့် ကိရိယာ၊ ဘတ်ဂျက်အကြံပေးကိရိယာနှင့် ပြင်ပ SEO စစ်ဆေးကိရိယာတို့ ပါဝင်သည်။ ဤအားလုံးကို နှစ်စဉ် သတ်မှတ်ထားသော စျေးနှုန်းအပြင် AI ခရက်ဒစ်ဖြင့် ပေးဆောင်ရမည်။

ဥပမာ — ကြော်ငြာအကြောင်းအရာ ဖန်တီးခြင်း

အမျိုးအစားနှင့် စီးပွားရေးဖော်ပြချက်တူညီသည့်အချက်အလက်များက အောက်တွင်ပါရှိသည့် ပုံဖန်တီးကိရိယာကိုလည်း အင်အားဖြည့်ပေးသည်။

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 mode မှတဆင့် သင်ဖန်တီးထားသော ကြော်ငြာရှင်များမှ ကြော်ငြာများကိုသာ ပြသရန် (သင့်ဝေငှမှုကို ဖန်တီးနေသူများ) data-partner ကို သင့် partner ID ဖြင့် ထည့်ပါ။ (သင့်ကိုယ်ပိုင် ဒက်ရှ်ဘုတ်၏ 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 တစ်ခုတည်းဖြင့် widget သည် အမျိုးအစားအားလုံးမှ ကြော်ငြာအားလုံးကို တစ်ခုတည်းသော grid တစ်ခုတွင် ပြသမည်ဖြစ်ပြီး၊ အမျိုးအစားတစ်ခုချင်းစီအတွက် widget block တစ်ခုစီလိုအပ်ခြင်းမရှိတော့ပါ။

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

အကြောင်းအရာအတွင်းရှိ ယူနစ်နှင့်အတူ ဖွဲ့စည်းပုံတူ ဖူတာပုံစံ ယူနစ်တစ်ခုကို ထပ်မံထည့်ပြီး၊ တစ်ခုချင်းစီတွင် မတူညီသော ကြော်ငြာများ ပြသလိုပါသလား။ ဒေတာ-layout="compact" (ကြော်ငြာတစ်ခုသာ၊ သေးငယ်သော pill ပုံစံအဖြစ် ဖွင့်/ပိတ်နိုင်) နှင့် data-offset ကို ပထမ widget မှ ပြသထားသည့် ကြော်ငြာအရေအတွက်အတိုင်း သတ်မှတ်ထားသော ဒုတိယ widget block တစ်ခုကို ထည့်ပါ။

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

စျေးနှုန်းအဆင့်များ (တိုက်ရိုက်)

ဤ endpoint မှ တိုက်ရိုက် ဖတ်ပါ — ဤတန်ဖိုးများကို hardcode မလုပ်ပါနှင့်၊ ကျွန်ုပ်တို့ဘက်မှ ပြောင်းလဲနိုင်ပါသည်။ အခမဲ့ပမာဏကွက်လပ်အစား သင့်အသုံးပြုသူများအတွက် အဆင့်ရွေးစနစ်တစ်ခု တည်ဆောက်ပါ။ ပြသထားသော စျေးနှုန်းတိုင်းမှာ ငွေပေးချေမှုဖန်တီးသည့်အခါ တိတိကျကျ ပို့ရမည့် ပမာဏဖြစ်ပြီး၊ ဒီမှာ ဖော်ပြထားသော အကျိုးကျေးဇူးများက ထိုစျေးနှုန်းဖြင့် ဘာတွေရရှိမလဲဆိုတာ အသုံးပြုသူများအား တိတိကျကျ သိရှိစေပါသည်။ ထို့ကြောင့် သူတို့သည် နံပါတ်ခန့်မှန်းရန်မလိုဘဲ နားလည်ထားသော စျေးနှုန်းကို ရွေးချယ်နိုင်ပါသည်။

တစ်မိနစ်လျှင် key တစ်ခုအတွက် တောင်းဆိုမှုများကို ကန့်သတ်ထားသည်။ အတည်ပြုပြီးသော တုံ့ပြန်ချက်တိုင်းတွင် X-RateLimit-Limit၊ X-RateLimit-Remaining နှင့် X-RateLimit-Reset ခေါင်းစဉ်များ ပါဝင်သည်။ ကန့်သတ်ချက်ကျော်လွန်ပါက Retry-After ခေါင်းစဉ်ပါဝင်သည့် 429 Too Many Requests ကို ပြန်လည်ထုတ်ပေးသည်။

တစ်ဖက်ဆက်ဆံသူအတွက် ရွေးချယ်နိုင်သည်။ မှတ်တမ်းတစ်ခုထည့်မည့်အထိ သင့်ကီးများသည် မည်သည့် IP မှမဆို တောင်းဆိုချက်များကို လက်ခံမည်။ ပထမဆုံးမှတ်တမ်းထည့်လိုက်သည်နှင့် ထိုဖက်ဆက်ဆံသူ၏ ကီးများအားလုံးကို ခွင့်ပြုစာရင်း (allowlist) သာ လက်ခံရန် ပြောင်းလဲမည်။

webhook တစ်ခုချင်းစီကို ဖန်တီးချိန်တွင် တစ်ကြိမ်သာ ထုတ်ပေးသော လျှို့ဝှက်ချက်ဖြင့် HMAC-SHA256 ဖြင့် လက်မှတ်ရေးထိုးထားပြီး၊ payload ကို ယုံကြည်မီ လက်မှတ်ကို အတည်ပြုပါ။ ဖြစ်ရပ်များကို သက်ဆိုင်ရာ ကြော်ငြာရှင်ကို ပိုင်ဆိုင်ထားသော မိတ်ဖက်ထံသို့သာ ပို့ဆောင်ပါသည်။