Nyaraka za msanidi programu

Kila ombi linathibitishwa kwa kutumia ufunguo wa siri katika kichwa cha idhini, kwa kutumia mpangilio wa Bearer.

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

Ikiwa funguo zako za API zinaunda akaunti za watangazaji kwa watumiaji wako wenyewe (hali ya Kuunganisha — angalia Uthibitishaji hapo juu), unapata sehemu ya kile watangazaji hao wanacholipa kwa matangazo yao. Mgawanyo ulio hapa chini unasomwa moja kwa moja kutoka kwenye kiunganishi hiki, haujawahi kuwekwa moja kwa moja kwenye msimbo, na ni tofauti kabisa na kamisheni ya rufaa iliyo chini zaidi kwenye ukurasa huu.

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

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

Jinsi inavyofanya kazi

1. Mmoja wa watangazaji wako wa Connect-mode hulipia tangazo kupitia muunganisho wako.
2. Tangazo linapitiwa na kuidhinishwa — kiotomatiki, au na timu yetu ya udhibiti.
3. Sehemu yako imewekwa kwenye foleni kwa malipo ya moja kwa moja kwenye pochi yako, kwa utaratibu uleule kama programu ya rufaa hapa chini.

Masharti ya malipo

• Waleti ya malipo ya crypto imewekwa kwenye akaunti yako ya mshirika.
• Hakuna KYC inahitajika upande wako — akaunti yako ya mshirika tayari imepitiwa ukaguzi wakati ilipotengenezwa.

Mfano: kusoma hisa zilizokusanywa

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
}

Kila akaunti ya mtangazaji hupata seti ya zana za AI zilizojengewa ndani — kizalishaji cha maudhui ya matangazo na picha, msaidizi wa mazungumzo, mshauri wa bajeti, na mkaguzi wa SEO wa nje — zinazolipwa kwa mikopo ya AI, juu ya bei thabiti ya kila mwaka.

Mfano — tengeneza maudhui ya tangazo

Kategoria ile ile na maelezo ya biashara pia huendesha kizalishaji cha picha hapa chini.

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
}

Tengeneza picha inayolingana kwa tangazo lile lile:

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
}

Weka kitengo cha tangazo kilichotayarishwa tayari kwenye tovuti yako — hakuna hatua ya ujenzi, hakuna iframe. Skripti inaonyeshwa moja kwa moja kwenye ukurasa ndani ya Shadow DOM iliyotengwa, hivyo mitindo yake haitavujia kwenye tovuti yako, na mitindo ya tovuti yako haitavujia ndani yake.

Ongeza kwenye ukurasa wako

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

Kwa chaguo-msingi, hii inaonyesha orodha kamili ya umma kwa kategoria — kila mtangazaji kwenye jukwaa, si tu wale uliowaleta. Ili kuonyesha matangazo tu kutoka kwa watangazaji uliowatengeneza kupitia hali ya Connect (wale wanaotengeneza sehemu yako), ongeza data-partner na kitambulisho cha mshirika wako (kipate kwenye ukurasa wa Waendelezaji kwenye dashibodi yako):

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

Ikiwa watangazaji wako wanajumuisha kategoria kadhaa, acha kabisa data-category — kwa kutumia tu data-partner, widget inaonyesha kila tangazo lako katika kategoria zote kwenye gridi moja, badala ya kuhitaji bloku moja ya widget kwa kila kategoria:

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

Unataka kitengo cha mtindo wa footer kando na kitengo chako kilicho ndani ya maudhui, kila kimoja kikiwa kinaonyesha matangazo tofauti? Ongeza bloku ya widget ya pili na data-layout="compact" (matangazo moja, yanayoweza kupunguzwa kuwa kidonge kidogo) na data-offset ikiwa imewekwa kulingana na idadi ya matangazo ambayo widget yako ya kwanza tayari inaonyesha:

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

Sifa

Jinsi kamisheni ya rufaa ya mshirika inavyowafikia kwa kweli — asilimia, utaratibu wa malipo, na masharti ya awali.

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
}

Masharti ya malipo

• Jumla ya malipo ya mtangazaji imefikia kiwango cha chini cha malipo.
• Waleti ya malipo ya sarafu fiche imewekwa kwenye akaunti yao.
• Hali yao ya KYC imethibitishwa.

Mfano: kusoma mapato yaliyokusanywa

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
}

Viwango vya bei (hai)

Soma moja kwa moja kutoka kwa kiunganisho hiki cha mwisho — usiweke thamani hizi moja kwa moja kwenye msimbo, zinaweza kubadilika upande wetu. Tengeneza chaguo la ngazi kwa watumiaji wako badala ya uwanja wa kiasi cha bure: kila bei inayoonekana tayari ni kiasi halisi cha kutuma unapounda malipo, na manufaa yaliyofunguliwa yanayoonyeshwa hapa yanawaambia watumiaji hasa wanachopata kwa bei hiyo, hivyo wanachagua bei wanayoielewa badala ya kukisia nambari.

Maombi yanapunguzwa kwa kila ufunguo kwa dakika. Kila jibu lililothibitishwa lina vichwa vya habari X-RateLimit-Limit, X-RateLimit-Remaining, na X-RateLimit-Reset; kuvuka kikomo hurejesha 429 Too Many Requests na kichwa cha habari Retry-After.

Hiari, kwa kila mshirika. Hadi utakapoongeza kumbukumbu, funguo zako zitakubali maombi kutoka kwa anwani yoyote ya IP — kumbukumbu ya kwanza hubadilisha funguo zote za mshirika huyo kuwa zinatumika tu kwenye orodha ya kuruhusiwa.

Kila webhook imetiwa sahihi kwa kutumia HMAC-SHA256 na siri iliyotolewa mara moja wakati wa uundaji — thibitisha sahihi kabla ya kuamini mzigo. Matukio hutolewa tu kwa mshirika anayemiliki mtangazaji husika.