Хөгжүүлэгчийн баримт бичиг

Бүх хүсэлтийг Authorization толгой дээрх нууц түлхүүрээр Bearer схемийг ашиглан баталгаажуулдаг.

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

Хэрэв таны API түлхүүрүүд өөрийн хэрэглэгчдэдээ зориулан зар сурталчилгаачийн данс үүсгэдэг бол (Connect горим — дээрх Баталгаажуулалтыг үзнэ үү), та тэдгээр зар сурталчилгаачид зар сурталчилгаандаа төлдөг төлбөрийн тодорхой хувийг олж авна. Доорх хуваарилалт нь яг энэ л endpoint-аас шууд уншигддаг, хэзээ ч хатуу кодлогдоогүй бөгөөд энэ хуудасны доош талд дурдсан referral комиссоос бүрэн тусдаа байдаг.

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

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

Яаж ажилладаг

1. Таны Connect-режимд ажилладаг зар сурталчилгаачдын нэг нь таны интеграцийн дамжуулан зар сурталчилгаанд төлбөр төлдөг.
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
}

Зар сурталчилгаачны бүх дансанд суурилуулсан хиймэл оюун ухааны хэрэгслүүдийн багц олгогддог: зар сурталчилгааны агуулга, дүрслэлийг үүсгэгч, ярианы туслах, төсвийн зөвлөх, гадаад 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 шаардагдахгүй. Скрипт тусгаарлагдсан 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 горим ашиглан үүсгэсэн (таны хувь хэмжээг бүрдүүлж буй) зар сурталчилгаачдын зар сурталчилгааг л харуулахын тулд data-partner талбарт өөрийн түншийн ID-ээ (өөрөөний дашбордын Хөгжүүлэгчдийн хуудаснаас олж болно) нэмж оруулна:

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

Контентын доторх нэгжтэйгээ зэрэгцэн, өөр өөр зар сурталчилгаа харуулдаг footer хэв маягийн нэгж нэмэхийг хүсч байна уу? Хоёр дахь виджет блок нэмээд data-layout="compact" (нэг зар, жижиг "pill" хэлбэрт хураагдах) болон 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
}

Үнийн түвшинүүд (шууд)

Энэ endpoint-оос шууд уншаарай — эдгээр утгуудыг хэзээ ч статик кодоор бичээгүй бай, манай талаас өөрчлөгдөж болно. Үнэгүй дүнгийн талбарын оронд өөрийн хэрэглэгчдэд зориулсан шатлал сонгогч бүтээ: харуулж буй үнэ бүр нь төлбөр үүсгэх үед яг явуулах дүн бөгөөд энд харуулсан нээгдсэн давуу талууд нь хэрэглэгчдэд тухайн үнээр яг юу авахыг нь ойлгомжтойгоор тайлбарладаг тул тэд тоо таамаглахын оронд ойлгож буй үнээ сонгодог.

Хүсэлтүүд нь түлхүүр бүрт минутанд хязгаарлагддаг. Бүх баталгаажсан хариултууд X-RateLimit-Limit, X-RateLimit-Remaining болон X-RateLimit-Reset толгой мэдээллийг агуулдаг; хязгаарыг давсан тохиолдолд Retry-After толгойтой 429 Too Many Requests алдаа буцаана.

Сонголттой, хамтрагч бүрийн хувьд. Та бичлэг нэмэх хүртэл таны түлхүүрүүд ямар ч IP хаягаас ирж буй хүсэлтийг хүлээн авна — эхний бичлэг тухайн хамтрагчийн бүх түлхүүрүүдийг зөвшөөрөгдсөн жагсаалтын горимд шилжүүлнэ.

Бүх вэбхук үүсэх үед нэг удаа олгогдсон нууцаар HMAC-SHA256-аар гарын үсэг зурдаг — ачааг итгэхээсээ өмнө гарын үсгийг шалгаарай. Үйл явдлууд зөвхөн холбогдох зар сурталчилгаачийн эзэмшдэг түншид хүргэгддэг.