વિકાસકર્તા દસ્તાવેજીકરણ

દરેક વિનંતી Authorization હેડરમાં Bearer સ્કીમનો ઉપયોગ કરીને ગુપ્ત કી સાથે પ્રમાણિત કરવામાં આવે છે.

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

જો તમારી API કીઓ તમારા પોતાના વપરાશકર્તાઓ માટે જાહેરાતદાતા એકાઉન્ટ્સ બનાવે (Connect મોડ — ઉપરોક્ત Authentication જુઓ), તો તમે તે જાહેરાતદાતાઓ તેમના જાહેરાતો માટે જે ચૂકવણી કરે છે તેમાંથી એક હિસ્સો મેળવો છો. નીચે દર્શાવેલ વહેંચણી આ જ એન્ડપોઇન્ટમાંથી લાઇવ વાંચવામાં આવે છે, ક્યારેય હાર્ડકોડ કરવામાં આવતી નથી, અને તે આ પૃષ્ઠ પર આગળની રેફરલ કમિશનથી સંપૂર્ણપણે અલગ છે.

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

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

તે કેવી રીતે કામ કરે છે

1. તમારા કનેક્ટ-મોડ જાહેરાતદાતાઓમાંનો એક તમારા ઇન્ટિગ્રેશન દ્વારા જાહેરાત માટે ચૂકવણી કરે છે.
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 ઉમેરો (તે તમારી પોતાની ડેશબોર્ડના ડેવલપર્સ પેજ પર મળશે):

<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 હેડર્સ હોય છે; મર્યાદા પાર થવા પર Retry-After હેડર સાથે 429 Too Many Requests આપવામાં આવે છે.

વૈકલ્પિક, દરેક ભાગીદાર માટે. જ્યારે સુધી તમે કોઈ એન્ટ્રી ઉમેરતા નથી, તમારી કીઝ કોઈપણ IP પરથી વિનંતીઓ સ્વીકારશે — પ્રથમ એન્ટ્રી તે ભાગીદારની તમામ કીઝને ફક્ત મંજૂર કરેલી યાદી (allowlist-only) માટે સેટ કરે છે.

દરેક વેબહૂકને સર્જન સમયે એકવાર જ જારી થયેલા ગુપ્ત કી વડે HMAC-SHA256થી સહી કરવામાં આવે છે — પેલોડ પર વિશ્વાસ કરતા પહેલા સહીની ચકાસણી કરો. ઇવેન્ટ્સ ફક્ત સંબંધિત એડવર્ટાઇઝરનો માલિકી ધરાવતા પાર્ટનરને જ મોકલવામાં આવે છે.