Ngā tuhinga mō te kaiwhakawhanake

Ka whakamanahia ia tono mā te kī huna i roto i te upoko whakaaetanga, mā te whakamahi i te anga Bearer.

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

Mēnā ka waihanga ō kī API i ngā pūkete kaiwhakatairanga mō ō ake kaiwhakamahi (aratau Hono — tirohia te Whakamana i runga ake nei), ka whiwhi koe i tētahi wāhanga o ngā utu e utua ana e aua kaiwhakatairanga mō ā rātou pānui. Ko te wehenga kei raro nei ka pānuitia ora mai i taua tauranga mutunga kotahi tonu, kāore i tuhia ki te waehere, ā, he tino motuhake i te komihana tuku kei raro iho i tēnei whārangi.

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

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

Me pēhea e mahi ai

1. Ko tētahi o ō kaiwhakatairanga i te aratau Hono e utu ana mō tētahi pānui mā tō hononga.
2. Ka arotakea, ka whakaaetia te pānui — aunoa rānei, mā tō mātou rōpū whakahaere rānei.
3. Kei te rārangi tō wāhanga kia tukuna aunoa ki tō putea, he pūnaha ano tēnei pērā i te hōtaka tūtohu kei raro nei.

Ngā tikanga utu

• Kua whirihorahia he pūkete utu moni matihiko ki tō pūkete hoa.
• Kāore he KYC e hiahiatia ana i tō taha — kua arotakihia kē tō pūkete hoa i te wā i hangaia ai.

Tauira: te pānui i ngā wāhanga kua kohia

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
}

Ka whiwhi ia pūkete kaihokohoko pānui i tētahi huinga taputapu AI kua whakaurua — he kaihanga ihirangi pānui me ngā whakaahua, he kaiāwhina kōrero, he kaitohutohu tahua, me tētahi kaiarotake SEO o waho — ka utua mā ngā nama AI, i tua atu i te utu ā-tau tūturu.

Tauira — waihanga ihirangi pānui

Ka whakamahia hoki te kāwai me te whakaahuatanga pakihi kotahi nei hei whakakaha i te kaihanga whakaahua kei raro nei.

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
}

Waihangahia he whakaahua ōrite mō taua pānui:

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
}

Tukua he wāhanga pānui kua oti kē ki tō paetukutuku ake — kāore he hipanga hanga, kāore he iframe. Ka whakaatahia te tuhinga hōtaka tika ki roto i te whārangi i roto i tētahi Shadow DOM motuhake, nō reira kāore ngā āhua o tō paetukutuku e kuhu ki roto, ā, kāore hoki ngā āhua o tō paetukutuku e kuhu ki waho.

Tāpiri ki tō whārangi

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

I te taunoa, ka whakaatu tēnei i te rārangi tūmatanui katoa mō te kāwai — ia kaiwhakatairanga kei runga i te papanga, ehara i ngā mea i whakauruhia e koe anake. Hei whakaatu anake i ngā pānui a ngā kaiwhakatairanga i waihangatia e koe mā te aratau Hono (ko ēnei e whakaputa ana i tō wāhanga), tāpirihia te 'data-partner' me tō tuakiri hoa (kia kitea i te whārangi Kaiwhakawhanake o tō papatohu ake):

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

Mēnā e hipoki ana ō kaiwhakatairanga i ngā kāwai maha, whakakore noa i te data-category katoa — mā te data-partner anake, ka whakaatu te widget i ō whakatairanga katoa puta noa i ngā kāwai katoa i roto i tētahi anga kotahi, kaua e hiahiatia kia kotahi te poraka widget mō ia kāwai:

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

Kei te hiahia koe i tētahi wāhanga āhua footer i te taha o tō wāhanga kei roto i te ihirangi, ā, kia whakaatu ia i ngā pānui rerekē? Tāpirihia tētahi poraka widget tuarua me te data-layout="compact" (he pānui kotahi, ka taea te whakaiti ki tētahi pīni iti) me te data-offset kua tautuhia kia rite ki te tokomaha o ngā pānui e whakaatuhia ana e tō widget tuatahi:

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

Ngā āhuatanga

Me pēhea e tae ai te komihana tūtohu a tētahi hoa ki a rātou — te ōrau, te pūnaha utu, me ngā here o mua.

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
}

Ngā tikanga utu

• Kua eke ngā moni utu katoa a te kaiwhakatairanga ki te taumata utu iti rawa.
• Kua whirihorahia he pūkete utu moni matihiko ki tō rātou pūkete.
• Kua whakauhia tō rātou tūnga KYC.

Tauira: te pānui i ngā whiwhinga kua kohia

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
}

Ngā taumata utu (e ora ana)

Pānuitia ngā raraunga ora mai i tēnei tauranga mutunga — kaua e tuhi tūturu i ēnei uara, ka taea e mātou te whakarerekē i a rātou. Hangaia he kaiwhiri taumata mō ō kaiwhakamahi ake, kaua e whakamahi i tētahi mara mō te nui kore utu: ko ia utu e whakaaturia ana he tika tonu te nui hei tuku i te wā e waihanga ana i te utu, ā, ko ngā painga kua whakatuwheratia e whakaatu ana ki ngā kaiwhakamahi he aha rawa ngā mea ka whiwhi rātou i taua utu, kia taea ai e rātou te kōwhiri i tētahi utu e mārama ana rātou, kaua e whakapae i tētahi tau.

Ka herea ngā tono ia kī ia meneti. Ia whakautu kua whakamanahia ka kawe i ngā upoko X-RateLimit-Limit, X-RateLimit-Remaining, me X-RateLimit-Reset; mēnā ka whiti te here, ka whakahoki i te hapa 429 Too Many Requests me te upoko Retry-After.

He kōwhiringa, mō ia hoa. Ā tae noa ki te wā ka tāpiri koe i tētahi urunga, ka whakaae ō kī ki ngā tono mai i ngā wāhitau IP katoa — mā te urunga tuatahi e huri ai ngā kī katoa o taua hoa kia rārangi whakaaetia anake.

Ka hainatia ia webhook mā te HMAC-SHA256, mā te whakamahi i tētahi kupu huna i tukuna kotahi i te wā i hangaia ai — me whakamana te haina i mua i te whakawhirinaki ki te uta. Ka tukuna ngā kaupapa ki te hoa anake e rangatira ana i te kaiwhakatairanga e hāngai ana.