Annual Ads

დეველოპერის დოკუმენტაცია

შექმენით პირდაპირ Annual Ads-ის პლატფორმაზე — შექმენით რეკლამის განმთავსებლები, გამოაქვეყნეთ რეკლამები, დაამუშავეთ გადახდები და თვალი ადევნეთ რეიტინგს, სრულად API-ის მეშვეობით.

სრული ფასების ცხრილის ნახვა

თქვენ ინარჩუნებთ 70%-ს თქვენი Connect-რეჟიმის რეკლამის დამკვეთები რეკლამაში იხდიან — თანხა ავტომატურად გადმოირიცხება თქვენს საფულეში. იხილეთ ქვემოთ, როგორ მუშაობს ეს.

საბაზისო URL

https://api.adhub365.com
OpenAPI 3

ავთენტიფიკაცია

ყველა მოთხოვნა ავთენტიფიცირდება საიდუმლო გასაღებით ავტორიზაციის სათაურში, Bearer სქემის გამოყენებით.

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

სანდბოქსი და პროდუქცია

სანდბოქსისა და საწარმოო გასაღებები სრულად არიან იზოლირებული ერთმანეთისგან — სანდბოქსის გასაღებს არასდროს შეუძლია წაიკითხოს ან ჩაწეროს საწარმოო გასაღებით შექმნილი მონაცემები და პირიქით.

მზერის არე

თითოეული გასაღები შეზღუდულია იმ სფეროებით, რომლებშიც ის გაიცა — გასაღებს არასდროს აქვს მეტი წვდომა, ვიდრე იმ პარტნიორულ ანგარიშს, რომელმაც ის შექმნა.

API გასაღებები დამტკიცებულ პარტნიორულ ანგარიშებს ეთმობა ყოველწლიური რეკლამების გუნდის მიერ.

შექმენით პარტნიორის ანგარიში

რეკლამის შემოსავლების გაზიარება

თუ თქვენი API გასაღებები თქვენივე მომხმარებლებისთვის რეკლამის განმთავსებლის ანგარიშებს ქმნის (Connect რეჟიმი — იხილეთ ავთენტიფიკაცია ზემოთ), თქვენ იღებთ წილს იმ თანხიდან, რასაც ეს რეკლამის განმთავსებლები თავიანთი რეკლამებისთვის იხდიან. ქვემოთ მოცემული განაწილება პირდაპირ ამავე ბოლო წერტილიდან იკითხება, არასდროს არის სტატიკურად ჩაწერილი და სრულად დამოუკიდებელია ამავე გვერდზე მოცემული რეფერალური საკომისიოსგან.

GET https://api.adhub365.com/v1/partner-program
{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

70%

შენ გეკუთვნის

გადახდა ავტომატურად ხდება თქვენს კონფიგურირებულ გასატან საფულეში — თანხის გატანის მოთხოვნა არ არის საჭირო.

30%

წლიური განცხადებებისკენ გადადის

მოიცავს მოდერაციას, ჰოსტინგს და რეკლამების რანჟირების ინფრასტრუქტურას.

როგორ მუშაობს

  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
}

საბოლოო წერტილები

ანგარიშები

POST/v1/partner/advertisers

შექმენით რეკლამის განმთავსებლის ანგარიში თქვენი ერთ-ერთი მომხმარებლის სახელით (Connect რეჟიმი).

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, მაქს. 5 მბ). პირველი გადახდის წინ აუცილებელია — იხილეთ ქვემოთ გადახდების ჯგუფი.

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

რეკლამის საერთო ნახვები და დაწკაპუნებები — გასული/დარჩენილი დღეები მოდიან უკვე არსებული activated_at/expires_at ველებიდან 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

თქვენი 70%-იანი წილი იმ თანხიდან, რასაც Connect რეჟიმში შექმნილმა რეკლამის დამკვეთებმა თავიანთი რეკლამებისთვის გადაიხადეს, სტატუსების მიხედვით დაყოფილი.

ad-revenue:read

მომხმარებელთა ჟურნალი

GET/v1/partner/access-log

ამ გასაღების ზარების სრული ისტორია — მეთოდი, პათი, IP, დროის ნიშნული.

იქ

საჯარო წერტილები

GET/v1/rankings?category={id}&geo={scope}

მხოლოდ წაკითხვის რეჟიმის რეიტინგი კატეგორიისა და გეოგრაფიული არეალისთვის.

საჯარო
GET/v1/tiers

კონფიგურირებული ფასების 7 დონე (მაჩვენებელი, გახსნილი უპირატესობები).

საჯარო
GET/v1/referral-program

რეფერალური კასკადისა და ლიდერების ჯგუფისთვის ამჟამად მოქმედი საკომისიოს პროცენტები.

საჯარო
GET/v1/partner-program

რეკლამიდან მიღებული შემოსავლის ამჟამინდელი განაწილება (Connect რეჟიმი) თქვენსა და Annual Ads-ს შორის.

საჯარო
GET/v1/search?q={query}

ბუნებრივი ენის ძიება — ასწორებს მოთხოვნას, როგორიცაა "მებაღეობის ინსტრუმენტების მწარმოებლები კენიაში", შესაბამის კატეგორიასა და გეოგრაფიულ არეალში და შემდეგ აბრუნებს ამ რეიტინგს, ზუსტად მის რეალურ თანმიმდევრობაში.

საჯარო

აფილირებული და რეფერალური რეკლამა

advertiser_type, promotion_type, link_type და promoted_brand არის არასავალდებულო ველები POST და PATCH /v1/partner/ads-ზე — Annual Ads არ შემოიფარგლება მხოლოდ იმ ბიზნესით, რომელიც საკუთარ თავს რეკლამირებს. როდესაც link_type არის affiliate_link ან referral_invitation_link, ან promotion_type არის affiliate_offer ან referral_opportunity, affiliate_terms_accepted უნდა იყოს true, წინააღმდეგ შემთხვევაში მოთხოვნა უარყოფილი იქნება 422 კოდით. სათაურის სიგრძე შეზღუდულია 35 სიმბოლოთი, ხოლო აღწერილობის — 80-ით — ორივე შეზღუდვა სერვერის მხარეს მოქმედებს და არა მხოლოდ მართვის პანელის ინტერფეისში.

ხელოვნური ინტელექტის ინსტრუმენტები

ყველა რეკლამის განმთავსებლის ანგარიშს აქვს ჩაშენებული ხელოვნური ინტელექტის ინსტრუმენტების ნაკრები — რეკლამის შინაარსისა და ვიზუალის გენერატორი, საუბრების ასისტენტი, ბიუჯეტის მრჩეველი და გარე SEO აუდიტორი — რომელთა საფასური, ფიქსირებული წლიური ტარიფის გარდა, იხდება ხელოვნური ინტელექტის კრედიტებით.

მათზე წვდომა რეკლამის განმთავსებლის საკუთარი მართვის პანელის ავტორიზაციის საშუალებით (სესიის წვდომის ტოკენით) ხდება და არა პარტნიორის API გასაღებით — მესამე მხარის ინტეგრაციას არ შეუძლია მათი გამოძახება რეკლამის განმთავსებლის სახელით.
POST/v1/advertisers/{id}/ai/assistant

Ask Annual Ads — მცურავი საუბრის ასისტენტი, მხოლოდ საინფორმაციო და მხოლოდ ანგარიშის მონაცემების წაკითხვის შესაძლებლობით.

საჯარო
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

რეალური სტატისტიკური პროექცია — და არა გენერაციული ვარაუდი — კონკრეტული რანგის შენარჩუნების ალბათობისა 30/90/365 დღის ვადაში.

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>

ნაგულისხმევად, ეს აჩვენებს კატეგორიის სრულ საჯარო რეიტინგს — პლატფორმის ყველა რეკლამის განმთავსებელს და არა მხოლოდ იმებს, რომლებიც თქვენ მოიზიდეთ. იმისათვის, რომ აჩვენოთ მხოლოდ იმ რეკლამის განმთავსებლების რეკლამები, რომლებიც 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>

გსურთ კონტენტში არსებული რეკლამის ბლოკის გვერდით ფუტერის სტილის ბლოკის დამატება, რომლებიც სხვადასხვა რეკლამას აჩვენებენ? დაამატეთ მეორე ვიჯეტის ბლოკი 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საკატეგორიო ID-ის ჩვენება. სავალდებულოა — თუ data-partner არ არის მითითებული, ამ შემთხვევაში მისი გამოტოვება ყველა კატეგორიაში პარტნიორის რეკლამების ჩვენებას უზრუნველყოფს.
data-geoგეოგრაფიული მასშტაბი: ადგილობრივი, რეგიონული ან გლობალური. ნაგულისხმევად გლობალურია.
data-countსარეკლამო განცხადებების რაოდენობა. ნაგულისხმევი მნიშვნელობაა 4.
data-columnsსარაზგასწორების სვეტების რაოდენობა. ნაგულისხმევი მნიშვნელობაა 2.
data-layoutსარეკლამო ბლოკი, სია ან კომპაქტური. ნაგულისხმევად დაყენებულია "სარეკლამო ბლოკი". კომპაქტური აჩვენებს ერთ რეკლამას (data-count უგულებელყოფილია) ღილაკით, რომლითაც მისი შეკუმშვა პატარა ბლოკად და შემდეგ აღდგენაა შესაძლებელი — ფუტერის სტილის ერთეული, რომელიც სკრიპტის მიერ ფიქსირებულად არასდროს პოზიციონირდება. თქვენ თავად ათავსებთ და აფორმებთ კონტეინერის div-ს საკუთარ გვერდზე სურვილისამებრ.
data-offsetსაუკეთესო რეიტინგის მქონე რეკლამების გამოტოვების რაოდენობა. ნაგულისხმევი მნიშვნელობაა 0. საშუალებას აძლევს ერთსა და იმავე გვერდზე არსებულ მეორე ვიჯეტს (მაგ., ფუტერში არსებულ კომპაქტურს და გვერდზე უფრო მაღლა განთავსებულ ბადისებრს), რომ აჩვენოს განსხვავებული რეკლამები იმავე რეკლამის ორჯერ გამეორების ნაცვლად — მიუთითეთ იმ რეკლამების რაოდენობა, რომლებსაც მეორე ვიჯეტი უკვე აჩვენებს.
data-partnerთქვენი პარტნიორის ID (იპოვეთ ის თქვენი დაფის დეველოპერების გვერდზე). არასავალდებულოა — მის გარეშე ვიჯეტი აჩვენებს სრულ საჯარო რეიტინგს ამ კატეგორიისთვის, პლატფორმაზე არსებულ ყველა რეკლამის დამკვეთს. მისი გამოყენებით კი — მხოლოდ იმ რეკლამის დამკვეთების რეკლამებს, რომლებიც თქვენ Connect რეჟიმით მოიზიდეთ, ანუ ისინი, რომლებიც რეალურად გენერირებენ თქვენს წილს.

შემოსავლების განაწილება

როგორ მიიღებს პარტნიორი რეფერალური საკომისიოს — პროცენტი, გადახდის მექანიზმი და წინაპირობები.

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
}

ფასების საფეხურები (ცოცხალი)

წაიკითხეთ პირდაპირ ამ ბმულიდან — არასდროს ჩაწეროთ ეს მნიშვნელობები კოდში, რადგან ისინი შეიძლება ჩვენი მხრიდან შეიცვალოს. უფასო თანხის ველის ნაცვლად შექმენით საფასო კატეგორიების არჩევის ინსტრუმენტი: ნაჩვენები თითოეული ფასი უკვე არის გადასახდელი ზუსტი თანხა, ხოლო აქ მოცემული განბლოკილი შეღავათები მომხმარებლებს ზუსტად უჩვენებს, რას იღებენ ამ ფასად, ასე რომ, ისინი ირჩევენ ფასს, რომელიც ესმით, და არა იმარბენალებენ რიცხვზე.

დონეფასიხსნის
Bronze$50.00

Basic visibility

Silver$300.00

Clickable link unlocked

დაწკაპუნებადი ბმული
Gold$500.00

Animation unlocked

დაწკაპუნებადი ბმულიანიმაცია
Platinum$1,000.00

Enhanced exposure

დაწკაპუნებადი ბმულიანიმაცია
Diamond$2,500.00

Premium placement

დაწკაპუნებადი ბმულიანიმაცია
Elite$5,000.00

Top-tier visibility

დაწკაპუნებადი ბმულიანიმაცია
Legendary$10,000.00

Maximum visibility & branding

დაწკაპუნებადი ბმულიანიმაცია

სიჩქარის ლიმიტები

მოთხოვნები შეზღუდულია გასაღების მიხედვით, წუთში. ყველა ავთენტიფიცირებული პასუხი შეიცავს X-RateLimit-Limit, X-RateLimit-Remaining და X-RateLimit-Reset ჰედერებს; ლიმიტის გადაჭარბების შემთხვევაში ბრუნდება 429 Too Many Requests კოდი და Retry-After ჰედერი.

IP-ების დასაშვები სია

არასავალდებულოა, პარტნიორის მიხედვით. სანამ ჩანაწერს არ დაამატებთ, თქვენი გასაღებები ნებისმიერი IP-დან მოთხოვნებს იღებენ — პირველი ჩანაწერი ამ პარტნიორის ყველა გასაღებს მხოლოდ დაშვებულთა სიაში მყოფთათვის გახდის ხელმისაწვდომს.

ვებჰუკები

ყველა ვებჰუკი ხელმოწერილია HMAC-SHA256-ით, შექმნის მომენტში ერთჯერადად გაცემული საიდუმლო გასაღების გამოყენებით — ტვირთის (payload) სანდოდ მიჩნევის წინ შეამოწმეთ ხელმოწერა. მოვლენები მიეწოდება მხოლოდ იმ პარტნიორს, რომელიც შესაბამისი რეკლამის დამკვეთის მფლობელია.

payment.succeededგადახდა დადასტურებულია.
payment.refundedხორციელდება თანხის დაბრუნება.
ad.activatedრეკლამა აქტიურდება ავტომატურად ან ადმინისტრატორის მიერ შემოწმების შემდეგ.
invoice.issuedგამოიწერება ფაქტურა.
referral.payout.completedრეფერალური საკომისიო ხდება ანაზღაურებადი.
referral.payout.failedპროვაიდერთან რეფერალური გადახდის პარტია წარუმატებელია — შემოსავალი ბრუნდება გასაცემ თანხებში და პროცესი ხელახლა სრულდება.
rank.changedრეკლამის რანგი იცვლება — მათ შორის, როდესაც ამას სხვა რეკლამის დამკვეთის გადახდა იწვევს.
ad.expiring_soonრეკლამის გასვლამდე 30, 7 ან 1 დღით ადრე.
partner_ad_revenue.payout.completedრეკლამის შემოსავლის გაზიარების გადახდა გადახდილი სტატუსს იღებს.
partner_ad_revenue.payout.failedპროვაიდერზე რეკლამის შემოსავლის გაზიარების გადახდის პარტია წარუმატებელია — წილები ბრუნდება გასაცემში და პროცესი ხელახლა სრულდება.

პროგრამული უზრუნველყოფის შემუშავების ნაკრებები

ამავე API სპეციფიკაციიდან გენერირებული ოფიციალური JavaScript/TypeScript და Python SDK-ები დაგეგმილია, მაგრამ ჯერ არ გამოქვეყნებულა — მანამდე გამოიყენეთ 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": "...",
    },
)