Antontan-taratasy ho an'ny mpamorona

Ny fangatahana tsirairay dia voamarina amin'ny lakile miafina ao amin'ny lohateny Authorization, amin'ny fampiasana ny schema Bearer.

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

Raha mamorona kaonty mpanao dokam-barotra ho an'ny mpampiasa anao manokana ny lakile API-nao (maody Connect — jereo ny fanamarinana etsy ambony), dia mahazo ampahany amin'ny vola aloan'ireo mpanao dokam-barotra ho an'ny dokambarotra ataon'izy ireo ianao. Ny fizarana eto ambany dia vakiana mivantana avy amin'ity endpoint ity ihany, tsy mampiasa kaody mafy mihitsy, ary tena misaraka tanteraka amin'ny komisiona fampanoroana hita any ambany kokoa amin'ity pejy ity.

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

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

Ny fomba fiasany

1. Ny iray amin'ireo mpanao dokam-barotra amin'ny Connect-mode dia mandoa vola ho an'ny doka amin'ny alalan'ny fampidirana nataonao.
2. Ny dokam-barotra dia dinihina sy ekena — ho azy, na ataon'ny ekipanay mpandrindra.
3. Ny ampahany anao dia efa ao anaty filaharana ho fandoavana mandeha ho azy any amin'ny kitapom-bolanao, mekanisma mitovy amin'ny programa fampanoroana etsy ambany.

Fepetra fandoavana

• Efa voarafitra ao amin'ny kaontinao mpiara-miombon'antoka ny poketra fandoavam-bola amin'ny crypto.
• Tsy ilaina ny KYC avy aminao — efa nodinihina ny kaonty mpiara-miasa aminao tamin'ny famoronana azy.

Ohatra: famakiana ny isan'ny anjara mitambatra

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
}

Kaonty mpanao dokam-barotra tsirairay dia mahazo andiana fitaovana AI efa tafiditra — mpamokatra votoaty sy sary ho an'ny dokam-barotra, mpanampy fifampiresahana, mpanolotsaina momba ny teti-bola, ary mpanara-maso SEO ivelany — izay aloa amin'ny kredita AI, ankoatra ny vidin'ny taona raikitra.

Ohatra — mamorona votoatin'ny dokam-barotra

Ny sokajy sy ny famaritana ny orinasa mitovy ihany koa no mampandeha ny mpamokatra sary etsy ambany.

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
}

Mamoròna sary mifanaraka amin'ilay dokam-barotra mitovy:

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
}

Ampidiro ao amin'ny tranokalanao ny singa dokam-barotra efa vonona — tsy misy dingana fananganana, tsy misy iframe. Ny script dia mamoaka mivantana ao anatin'ny pejy ao anatin'ny Shadow DOM voahilika, ka tsy hivoaka any amin'ny tranokalanao ny fomba fampiasa azy, ary tsy hiditra ao amin'ny dokam-barotra koa ny fomba fampiasan'ny tranokalanao.

Ampio ao amin'ny pejinao

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

Amin'ny mahazatra dia mampiseho ny laharan'ny besinimaro feno ho an'ny sokajy ity — ny mpanao dokam-barotra rehetra ao amin'ny sehatra, fa tsy ireo izay nampidirinao fotsiny. Mba hampisehoana fotsiny ireo dokam-barotra avy amin'ireo mpanao dokam-barotra noforoninao tamin'ny alalan'ny maody Connect (ireo miteraka ny ampahany anao), ampio ny data-partner miaraka amin'ny ID mpiara-miasa aminao (hita ao amin'ny pejin'ny mpamorona ao amin'ny tontonana fitantananao):

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

Raha miparitaka amin'ny sokajy maromaro ny mpanao dokam-barotrao, esory tanteraka ny data-category — amin'ny fampiasana data-partner irery, mampiseho ny dokam-barotrao rehetra amin'ny sokajy rehetra ao anatin'ny grida iray ny widget, fa tsy mila blôka widget iray isaky ny sokajy:

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

Te hanana singa amin'ny fomba footer eo anilàn'ny singa ao anatin'ny votoaty ve ianao, ka samy mampiseho dokam-barotra samihafa? Ampio blôka widget faharoa miaraka amin'ny data-layout="compact" (dokam-barotra tokana, azo aforitra ho toy ny pilina kely) ary apetraho ny data-offset araka ny isan'ny dokam-barotra efa asehon'ny widget voalohany:

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

Toetra

Ny fomba tena ahazoan'ny mpiara-miombon'antoka ny komisiona avy amin'ny fanoroana — ny isan-jato, ny fomba fandoavana, ary ny fepetra mialoha.

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
}

Fepetra fandoavana

• Ny fitambaran'ny vola tokony haloan'ny mpanao dokam-barotra dia mahatratra ny fetra farany ambany amin'ny fandoavana.
• Voarafitra ao amin'ny kaontiny ny poketra fandoavana amin'ny vola kripto.
• Voamarina ny satan'ny KYC-n'izy ireo.

Ohatra: famakiana ny vola miditra voaangona

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
}

Sokajin-vidiny (mivantana)

Mamaky mivantana avy amin'ity endpoint ity — aza manoratra mivantana ireo sanda ireo ao amin'ny kaody, satria mety hiova eo amin'ny lafinay. Mamoròna mpifidy ambaratonga ho an'ny mpampiasa anao fa tsy saha fanefana maimaim-poana: ny vidiny rehetra aseho dia efa ny vola marina halefa rehefa mamorona fandoavam-bola, ary ny tombontsoa misokatra aseho eto dia milaza amin'ny mpampiasa izay azony amin'io vidiny io, ka misafidy vidiny azony izy ireo fa tsy maminavina isa.

Voafetra ny fangatahana isaky ny lakile isan-minitra. Ny valiny voamarina rehetra dia mitondra lohateny X-RateLimit-Limit, X-RateLimit-Remaining ary X-RateLimit-Reset; raha mihoatra ny fetra dia mamerina ny sata 429 Too Many Requests miaraka amin'ny lohateny Retry-After.

Safidy isaky ny mpiara-miasa. Mandra-pampidiranao fampidirana, manaiky fangatahana avy amin'ny adiresy IP rehetra ny lakileo — ny fampidirana voalohany dia manova ny lakileo rehetra an'ilay mpiara-miasa ho lisitra fankatoavana ihany.

Ny webhook tsirairay dia nosoniavina tamin'ny HMAC-SHA256 mampiasa tsiambaratelo navoaka indray mandeha tamin'ny fotoana famoronana — hamarino ny sonia alohan'ny hianteherana amin'ny entana. Ny hetsika dia alefa fotsiny amin'ny mpiara-miasa izay tompon'ny mpanao dokam-barotra mifandray.