مستقیماً د کلنیو اعلانونو پر پلیټ فارم جوړونه وکړئ — اعلان ورکوونکي جوړ کړئ، اعلانونه خپاره کړئ، تادیات فعال کړئ، او درجه تعقیب کړئ، په بشپړ ډول د API له لارې.
د نرخونو بشپړ جدول وګورئتاسو 70٪ ساتئ ستاسو د کنیکټ-موډ اعلان ورکوونکي د خپلو اعلانونو لپاره څه ورکوي — پیسې په اتوماتيک ډول ستاسو بټوې ته ځي. لاندې وګورئ چې دا څنګه کار کوي.
هر غوښتنه د بېرېر سکیم په کارولو سره، د اجازې په سرلیک (Authorization header) کې د یوې پټې کیلي په واسطه تصدیق کیږي.
Annual AdsPOST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/jsonد API کیلي ګانې د کلنیو اعلانونو ټیم لخوا منظور شویو شریکو حسابونو ته صادرېږي.
د شریک حساب جوړ کړئ| POST | /v1/partner/advertisersد خپل یوه کارونکي په استازیتوب د اعلان ورکوونکي حساب جوړ کړئ (د نښلولو حالت). | advertisers:write |
| GET | /v1/partner/advertisers/{id}د دې ملګري لخوا جوړ شوی د اعلان ورکوونکي حساب ولټوئ. | advertisers:read |
| POST | /v1/partner/adsیوه اعلان جوړ کړئ. دا په مسودې حالت کې پیل کیږي. د advertiser_type، promotion_type، link_type، او promoted_brand اختیاري فیلډونه د وابسته، راجع، جوړونکي، یا انفرادي اعلاناتو تشریح کوي — لاندې یادښت وګورئ. | ads:write |
| GET | /v1/partner/ads/{id}اشتهار ولټوئ | ads:read |
| PATCH | /v1/partner/ads/{id}د اداریې محتوا تازه کړئ — سرلیک، توضیحات، لینک، د اعلان ورکوونکي ډول، د ترویج ډول، د لینک ډول، او ترویج شوی برانډ. کټګوري، جغرافیه، او هر هغه څه چې د درجه بندۍ انجن یې لولي، دلته هیڅکله نشي بدلیدلی. | ads:write |
| POST | /v1/partner/ads/{id}/imageاعلان انځور په مستقیم ډول اپلوډ کړئ (JPEG/PNG/WebP، اعظمي ۵MB). د لومړۍ تادیې څخه مخکې اړین دی — لاندې د تادیاتو ډله وګورئ. | ads:write |
| POST | /v1/partner/ads/{id}/image-urlد فایل اپلوډولو پرځای د یوې اعلان انځور د یوې URL له لارې تنظیم کړئ — سرور یې پخپله راوړي او بیا یې خپروي. هماغه شرط: د لومړۍ تادیې څخه مخکې اړین دی. | ads:write |
| GET | /v1/partner/ads/{id}/rankد اعلان لپاره اوسنی رتبه، کټګوري، او جغرافیایي ساحه. | ads:read |
| GET | /v1/partner/ads/{id}/statsد یو اعلان لپاره ټول لیدونه او کلیکونه — تېر شوي/پاتې ورځې د `GET /{id}` په فعاله_ات/په پای_رسېدو_ات فیلډونو څخه راځي، او درجه بندي د `GET /{id}/rank` څخه راځي. | ads:read |
| POST | /v1/partner/paymentsد لومړنۍ پیرودنې یا ټاپ اپ لپاره د کریپټو تادیې پیل وکړئ. یوه لومړنۍ تادیه د 422 له امله ناکامه کیږي، مګر دا چې اعلان دمخه انځور ولري — پورته uploadAdImage/setAdImageUrl وګورئ. | payments:write |
| GET | /v1/partner/payments/{id}د تادیې وضعیت وګورئ. | payments:read |
| POST | /v1/partner/referralsد راجع کولو لینک جوړ کړئ. | referrals:write |
| GET | /v1/partner/referrals/{code}/earningsد معرفۍ مجموعي عاید، د وضعیت له مخې ویشل شوی. | referrals:read |
| GET | /v1/partner/ad-revenue/earningsستاسو د هغو اعلانونو ۷۰٪ برخه چې تاسو په کنیکټ موډ کې جوړ کړي، د هغو پیسو څخه چې د هغوی اعلانونو لپاره ورکړل شوې، د وضعیت له مخې ویشل شوې. | ad-revenue:read |
| GET | /v1/partner/access-logد دې کیلي لپاره د اړیکو بشپړ تاریخچه — میتود، پته، آی پي، د وخت نښه. | هلته |
| GET | /v1/rankings?category={id}&geo={scope}د یوې کټګورۍ او جغرافیایي ساحې لپاره یوازې د لوستلو وړ درجه بندي. | عامه |
| GET | /v1/tiersد قیمت ټاکلو ۷ ترتیب شوي پړاوونه (آستانه، خلاص شوي امتیازات). | عامه |
| GET | /v1/referral-programد راجع کولو لړۍ او د مشرانو پول لپاره اوس مهال فعال د کمېشن سلنه. | عامه |
| GET | /v1/partner-programد اعلاناتو د عاید اوسنی وېش (کنیکټ موډ) ستاسو او کلنیو اعلاناتو ترمنځ. | عامه |
| GET | /v1/search?q={query}طبیعي ژبې لټون — یو پوښتنه لکه "په کینیا کې د فرنیچر اعلان کوونکي" مناسبې کټګورۍ او جغرافیایي ساحې ته لارښوونه کوي، بیا هغه درجه بندي په خپل دقیق اصلي ترتیب سره راګرځوي. | عامه |
وابسته او راجع کولو اعلانات
advertiser_type، promotion_type، link_type، او promoted_brand د POST او PATCH /v1/partner/ads په برخه کې اختیاري ساحې دي — کلنۍ اعلانونه یوازې د هغو سوداګریو پورې محدود نه دي چې د ځان لپاره اعلانونه کوي. کله چې link_type affiliate_link یا referral_invitation_link وي، یا promotion_type affiliate_offer یا referral_opportunity وي، affiliate_terms_accepted باید true (ریښتونی) وي، که نه نو غوښتنه د 422 کوډ سره رد کیږي. سرلیک د ۳۵ تورو او توضیحات د ۸۰ تورو پورې محدود دي — دا دواړه د سرور له لوري پلي کیږي، نه یوازې د ډشبورډ په UI کې.
د هر اعلان کوونکي حساب ته یو ځانګړی جوړ شوی د مصنوعي ځيرکتيا (AI) وسایلو سیټ ورکول کیږي — چې د اعلان د محتوا او انځورونو جنریټر، یو خبرو اترو مرستیال، د بودیجې سلاکار، او یو بهرنی د SEO پلټونکی پکې شامل دي — چې د کلنۍ ټاکلې بیې سربیره، د AI کریډیټونو په واسطه یې پیسې ورکول کیږي.
| POST | /v1/advertisers/{id}/ai/assistantاسک انویل انډز — یو ځوړند خبري مرستیال، یوازې معلوماتي، د حساب پر معلوماتو یوازې لوستل. | عامه |
| POST | /v1/advertisers/{id}/ai/creative-studioد یوې لنډې سوداګریزې تشریح څخه د اعلان سرلیک، توضیحات او کلیدي کلمې جوړې کړئ. | 2 کریډیټ(ونه) |
| POST | /v1/advertisers/{id}/ai/creative-studio/imageد همدې سوداګرۍ له توضیحاتو څخه یو لیست ویژول (PNG) جوړ کړئ، چې کوربه شوی او اعلان ته د نښلولو لپاره چمتو وي. | 8 کریډیټ(ونه) |
| POST | /v1/advertisers/{id}/ai/budget-advisorد یو ټاکل شوي رتبه د ۳۰/۹۰/۳۶۵ ورځو لپاره د ساتلو د امکاناتو یو حقیقي احصایوي اټکل — نه کله هم یو تخمینی اټکل. | 1 کریډیټ(ونه) |
| POST | /v1/advertisers/{id}/ai/seo-auditد اعلان کوونکي خپل بهرني وېبپاڼې تحلیل کړئ او د SEO د ښه والي لپاره مشخص وړاندیزونه وکړئ. | 2 کریډیټ(ونه) |
همدا کټګوري او د سوداګرۍ تفصیل لاندې د انځور جوړوونکي ته هم ځواک ورکوي.
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>په ډیفالټ سره دا د کټګورۍ بشپړ عامه درجه بندي ښیي — په پلیټ فارم کې هر اعلان کوونکی، نه یوازې هغه چې تاسو راوستي دي. د دې لپاره چې یوازې د هغو اعلان کوونکو اعلانونه وښایاست چې تاسو د کنیکټ موډ له لارې جوړ کړي دي (هغه چې ستاسو برخه تولیدوي)، د خپل شریک ای ډي سره '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>data-category | د ښودلو لپاره د کټګورۍ پېژندکode. اړین — مګر دا چې 'data-partner' تنظیم شوی وي، په دې حالت کې د دې پرته پریښودل د هرې کټګورۍ په اوږدو کې د هغه شریک اعلانونه ښیي. |
data-geo | جیوپراخوالی: محلي، سیمه ییز، یا نړیوال. په ډیفالټ نړیوال دی. |
data-count | د ښودلو اعلانونو شمېر. ډیفالټ ۴ دی. |
data-columns | د جالۍ د ستنو شمېر. ډیفالټ ۲ دی. |
data-layout | جال، لېست، یا کمپکټ. په ډیفالټ ډول په جال حالت کې وي. کمپکټ یو اعلان ښیي (د ډیټا-شماره په پام کې نه نیول کیږي) چې یوه تڼۍ لري ترڅو هغه په یوه کوچنۍ ګولیزه بڼه راټول کړي او بېرته یې راولي — دا د فوټر په څېر یوه یونیټ ده، چې هیڅکله پخپله سکریپټ لخوا په ثابت ځای کې نه ځای پرځای کیږي، تاسو کولی شئ د کانټینر ډیوي (div) په خپله پاڼه کې د خپلې خوښې سره سم ځای پرځای او سټایل کړئ. |
data-offset | د غوره اعلانونو د پرېښودلو شمېر. ډیفالټ یې ۰ دی. دا په ورته پاڼه کې دوهم ویجیټ ته (د بېلګې په توګه، په فوټر کې یو کوچنی او یو بل پورته په جالۍ بڼه) اجازه ورکوي چې د یو شان اعلان د دوه ځله تکرارولو پرځای، مختلف اعلانونه وښیي — هغه شمېر اعلانونه چې بل ویجیټ یې لا دمخه ښيي، ورته ورکړئ. |
data-partner | ستاسو د شریک پېژندک (ID) (دا په خپل ډشبورډ کې د پراختیا کونکو (Developers) په پاڼه کې ومومئ). اختیاري — له دې پرته، ویجټ د هغې کټګورۍ لپاره بشپړ عامه درجه بندي ښیي، په پلاتفورم کې هر اعلان کوونکی. د دې سره، یوازې هغه اعلانونه چې تاسو د نښلونې (Connect) حالت له لارې راوستي دي — هغه چې په حقیقت کې ستاسو برخه تولیدوي. |
د هر کیلي لپاره په دقیقه کې د غوښتنو شمېر محدود دی. هر تایید شوی ځواب د X-RateLimit-Limit, X-RateLimit-Remaining, او X-RateLimit-Reset هیډرونه لري؛ له حد څخه د تېرېدو په صورت کې د Retry-After هیډر سره 429 Too Many Requests (ډېرې غوښتنې) بېرته راګرځول کیږي.
اختیاري، د هر ملګري لپاره. تر هغه وخته چې تاسو یوه ننوتنه ور اضافه نه کړئ، ستاسو کیلي ګانې د هر IP څخه غوښتنې مني — لومړۍ ننوتنه د هغه ملګري ټولې کیلي ګانې یوازې اجازې لیست ته بدلوي.
هر ویب هوک د جوړېدو پر مهال د یو ځل لپاره د صادر شوي راز په کارولو سره د HMAC-SHA256 په واسطه لاسلیک کیږي — د پېلوډ (payload) ته له باور کولو مخکې لاسلیک تایید کړئ. پیښې یوازې هغه شریک ته رسول کیږي چې اړوند اعلان کوونکی یې خپل وي.
payment.succeeded | تادیه تایید شوه. |
payment.refunded | پیسې بېرته ورکول کیږي. |
ad.activated | یوه اعلان فعال کیږي، په اتوماتيک ډول یا د مدیر له کتنې وروسته. |
invoice.issued | فاتوره صادره کیږي. |
referral.payout.completed | د راجع کولو کمېشن د تادیې وړ حالت ته رسېږي. |
referral.payout.failed | د ریفرل تادیې بیچ په پرووایډر کې ناکام شي — عایدات د تادیې وړ ته بیرته راګرځي او بیا هڅه کیږي. |
rank.changed | د اعلان درجه بدلیږي — په شمول کله چې د بل اعلان کوونکي تادیه د دې لامل شي. |
ad.expiring_soon | د اعلان له پای ته رسېدو ۳۰، ۷، یا ۱ ورځ مخکې. |
partner_ad_revenue.payout.completed | د اعلاناتو د عاید د شریکولو تادیه د تادیه وړ حالت ته رسېږي. |
partner_ad_revenue.payout.failed | د اعلاناتو د عاید د ونډې د تادیې یوه ډله په چمتو کوونکي کې ناکامه کیږي — ونډې بېرته د تادیې وړ ته راګرځي او بیا هڅه کیږي. |
د جاوا سکریپټ/ټایپ سکریپټ او پایتون رسمي SDKs، چې له همدې API مشخصاتو څخه جوړ شوي، پلان شوي خو تر اوسه نه دي خپاره شوي — تر هغه وخته پورې HTTP API ته مستقیمه غوښتنه وکړئ.
لا تر اوسه کوم SDK نشته — دا په مستقیم ډول HTTP API ته غوښتنه کوي او نن ورځ په هره ژبه کې کار کوي.
cURL
curl -X POST https://api.adhub365.com/v1/partner/ads \
-H "Authorization: Bearer sk_sandbox_..." \
-H "Content-Type: application/json" \
-d '{"advertiser_id":"adv_9f2a...","category_id":"cat_furniture","geo_scope":"local","title":"..."}'JavaScript
await fetch("https://api.adhub365.com/v1/partner/ads", {
method: "POST",
headers: {
Authorization: "Bearer sk_sandbox_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
advertiser_id: "adv_9f2a...",
category_id: "cat_furniture",
geo_scope: "local",
title: "...",
}),
});Python
import requests
requests.post(
"https://api.adhub365.com/v1/partner/ads",
headers={"Authorization": "Bearer sk_sandbox_..."},
json={
"advertiser_id": "adv_9f2a...",
"category_id": "cat_furniture",
"geo_scope": "local",
"title": "...",
},
)