דאָקומענטאַציע פֿאַר אַנטוויקלער

יעדער בקשה ווערט אויטענטיפֿיצירט מיט אַ געהיימן שליסל אין דעם Authorization־העדער, ניצנדיק די Bearer־סקעם.

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

אויב אייערע API־שליסלען שאַפֿן אַדווערטייזער־אַקאַונטן פֿאַר אייערע אייגענע באַניצער (קאָנעקט־מאָדוס — זע אויבן Authentication), פאַרדינט איר אַ טייל פֿון וואָס די אַדווערטייזערס באַצאָלן פֿאַר זייערע אַדס. דער אונטן אָנגעוויזענער טיילונג ווערט לייב געלייענט פֿון דעם זעלבן ענדפּוינט, קיינמאָל האַרד־קאָדירט, און איז גאָר אָפּגעטיילט פֿון דער רעפֿעראַל־קאָמיסיע וואָס געפינט זיך ווייטער אונטן אויף דער זעלביקער זייַט.

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
}

יעדער אַדווערטייזער־קאָנטאָ באקומט אַ זאַמלונג פֿון איינגעבויטע 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-מאָדוס (די וואָס גענערירן אײַער טייל), לייגט צו data-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 ווײַזט דער ווידזשעט אַלע אייערע אַדווערטײַזערס אין אַ גריד איבער אַלע קאַטעגאָריעס, אַנשטאָט צו דאַרפֿן איין ווידזשעט־בלאָק פֿאַר יעדער קאַטעגאָריע:

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

פּרײַז־שטאַפּלען (לעבעדיק)

לייענט לעבעדיק פֿון דעם ענדפּוינט — קיינמאָל נישט האַרקאָדירן די ווערטן, זיי קענען זיך טוישן אויף אונדזער זײַט. בויען אַ שטאַפּל־אויסקלייבער פֿאַר אייערע אייגענע באַניצערס אַנשטאָט אַ פֿעלד פֿאַר אַ פֿרײַע סומע: יעדער פּרײַז וואָס ווערט געוויזן איז שוין די פּינטלעכע סומע צו שיקן בײַם שאַפֿן דער צאָלונג, און די אויפגעשלאָסענע בענעפֿיטן וואָס ווערן דאָ געוויזן דערציילן די באַניצערס פּינטלעך וואָס דער פּרײַז זיי גיט, אַזוי זיי קלײַבן אַ פּרײַז וואָס זיי פֿאַרשטיין אַנשטאָט צו ראַטן אַ נומער.

די בקשות זענען באַגרענעצט פּער שליסל, פּער מינוט. יעדער אויטענטיפֿיצירטער ענטפֿער טראָגט די העדערס X-RateLimit-Limit, X-RateLimit-Remaining און X-RateLimit-Reset; ווען מען גייט איבער דעם לימיט, ווערט צוריקגעגעבן 429 Too Many Requests מיט אַ Retry-After העדער.

אָפּטיאָנאַל, פּער פּאַרטנער. ביז איר לייגט אַן אַרײַנשרײַב, אײַערע שליסלען אָננעמען בקשות פֿון יעדן IP — דער ערשטער אַרײַנשרײַב שטעלט אַלע שליסלען פֿון דעם פּאַרטנער אויף נאָר־ערלויבעניש־ליסטע.

יעדער וועב־הוק איז אונטערגעשריבן מיט HMAC-SHA256 מיט אַ סוד וואָס ווערט אַרויסגעגעבן נאָר איין מאָל בײַ דער שאַפֿונג — באַשטעטיקן דעם אונטערשריפֿט איידער מען פֿאַרלאָזט זיך אויף דעם פּייַלאָוד. געשעענישן ווערן געשיקט בלויז צום פּאַרטנער וואָס באַזיצט דעם פֿאַרבונדענעם אַדווערטייזער.