வெளியீட்டாளர் வருவாய் தணிக்கை API

பொது வெளியீட்டாளர் வருவாய் தணிக்கைகளை இயக்குங்கள், Sulvo அறிக்கைகளைப் பெறுங்கள், CLI மற்றும் MCP சேவையகம் பயன்படுத்தும் அதே API இடைமுகம் வழியாக அங்கீகரிக்கப்பட்ட வெளியீட்டாளர் விளம்பர இருப்பை நிர்வகியுங்கள்.

ஹோஸ்ட் செய்யப்பட்ட அடிப்படை URL

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-auditsCLI மற்றும் MCP அமைப்பு

அடிப்படைகள்

அடிப்படை URL-கள்

பொது தணிக்கைச் சேவை முகவரிக்கு திட்டமிட்டே அங்கீகாரம் தேவையில்லை. Sulvo கணக்கு அறிக்கைகள் மற்றும் விளம்பர இருப்பு கோரிக்கைகளுக்கு டாஷ்போர்டில் உருவாக்கப்பட்ட API விசை பயன்படுத்தப்படுகிறது.

பொது தணிக்கை API

POST

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits

Sulvo கணக்கு API

Bearer API விசை

https://surge.sulvo.com/api

ஹோஸ்ட் செய்யப்பட்ட MCP சேவை முகவரி

MCP

https://publisher-revenue-audit.sulvo.com/mcp

பொது சேவை முகவரி

வருவாய்த் தணிக்கையை இயக்குங்கள்

வெளியீட்டாளர் டொமைனைப் பற்றிய பொதுவில் கிடைக்கும் ஆதாரங்களின் மேலோட்டமான மதிப்பீட்டிற்கு இந்தச் சேவை முகவரியைப் பயன்படுத்துங்கள். பதில் வருவாய் இழப்புக்கான ஆதாரமோ, உறுதியான வருவாய் உயர்வோ அல்ல; வெளியீட்டாளர் தரப்பு அறிக்கைகளுடன் கண்டறிதல்களைச் சரிபாருங்கள்.

cURL

curl -X POST https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits \
  -H "content-type: application/json" \
  -d '{
    "tool": "run_publisher_revenue_audit",
    "input": {
      "domain": "example.com",
      "vertical": "news",
      "options": {
        "format": "json",
        "compact": true,
        "maxPages": 2,
        "enablePageSpeed": true
      }
    }
  }'

புலம்	குறிப்புகள்
input.domain	தேவையான வெளியீட்டாளர் டொமைன் அல்லது பொதுவில் அணுகக்கூடிய ஹோஸ்ட். நெறிமுறை குறிப்பிடப்படாத டொமைன்கள் தானாக HTTPS-ஆக மாற்றப்படும். தனிப்பட்ட இலக்குகள், மூல IP முகவரிகள், உள் ஹோஸ்ட்கள், வழக்கமற்ற போர்ட்கள் நிராகரிக்கப்படும்.
input.vertical	விருப்பத்தேர்வு. news, sports, entertainment, technology, education, gaming அல்லது other ஆகியவற்றை ஏற்கும்.
input.metrics	விருப்பத்தேர்வு. வெளியீட்டாளர் வழங்கும் டாஷ்போர்டு தகவல்கள், எடுத்துக்காட்டாக நிரப்பு விகிதம், வியூபிலிட்டி, சராசரி CPM, ஒவ்வொரு அமர்வுக்கான வருவாய், மாதாந்திர பக்கப் பார்வைகள் அல்லது மாதாந்திர அமர்வுகள்.
input.options	விருப்பத்தேர்வு வெளியீடு மற்றும் சேகரிப்பு கட்டுப்பாடுகள், இதில் format, compact, maxPages, includeEvidence, enableBrowser, includeScreenshots, enablePageSpeed, pageSpeedStrategy, concurrency, whiteLabel, partnerId ஆகியவை அடங்கும்.

அங்கீகாரம்

கணக்கு API-களுக்கு Sulvo API விசையைப் பயன்படுத்துங்கள்

Sulvo டாஷ்போர்டில், கணக்கு அமைப்புகள் பகுதியில் API விசையை உருவாக்குங்கள். Sulvo கணக்கு API கோரிக்கைகளில் அதை Bearer டோக்கனாக அனுப்புங்கள்.

Authorization ஹெடர்

Authorization: Bearer $SULVO_API_KEY

reports:read

அறிக்கை ஏற்றுமதிகளுக்கும் சேமிக்கப்பட்ட அறிக்கைகளின் பட்டியலுக்கும் தேவை.

reports:write

மேம்பட்ட அறிக்கைகளை உருவாக்க, புதுப்பிக்க, இயக்க அல்லது நீக்கத் தேவை.

inventory:write

விளம்பர அலகுகளை உருவாக்கவும் நீக்கவும் தேவை. கணக்கு அங்கீகரிக்கப்பட்டதாகவும், விளம்பர இருப்பின் உரிமையாளராகவும் இருக்க வேண்டும்.

அறிக்கைகள்

அறிக்கைகளைப் பெறும் சேவை முகவரிகள்

அறிக்கைகளைப் படிக்கும் கோரிக்கைகள் Sulvo கணக்கு API அடிப்படை முகவரியின் கீழ் GET முறையைப் பயன்படுத்துகின்றன. தேதி மட்டும் வழங்கப்பட்ட மதிப்புகள் முழு UTC நாள் வரம்பாகக் கருதப்படும்.

அறிக்கை கோரிக்கை

curl "https://surge.sulvo.com/api/v1/reports/by-date?start=2026-06-01&end=2026-06-07&domains=example.com" \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "accept: application/json"

Method	Path	Notes
GET	/api/v1/reports/by-date	தினசரி செயல்திறன் சுருக்கம். date, domain, ad root, provider வடிப்பான்களை ஆதரிக்கும்.
GET	/api/v1/reports/by-date-and-ad-unit	விளம்பர அலகு வாரியாகத் தொகுக்கப்பட்ட தினசரி செயல்திறன்.
GET	/api/v1/reports/by-domain-and-ad-unit	டொமைன் மற்றும் விளம்பர அலகு வாரியான செயல்திறன் விவரம்.
GET	/api/v1/reports/bot-filtering	கணக்கின் போக்குவரத்துத் தரத்தை மதிப்பாய்வு செய்வதற்கான பாட் வடிகட்டல் அறிக்கை.
GET	/api/v1/reports/bot-scores	தேதி மற்றும் தொடர்புடைய பரிமாணங்கள் வாரியான பாட் மதிப்பெண் அறிக்கை.
GET	/api/v1/reports/invalid-activity	தவறான செயல்பாடு குறித்த அறிக்கை. வழக்கமான தேதி அல்லது டொமைன் வினவல் தேவையில்லை.
GET	/api/v1/reports/direct-bidder-analysis	நேரடி ஏலதாரர் பகுப்பாய்வு அறிக்கை. directBidder தேவை; start/end சேர்க்கலாம்.
GET	/api/v1/inventory/ad-units-by-domain	டொமைன் வாரியாகத் தொகுக்கப்பட்ட விளம்பர அலகு இருப்பு.

பொதுவான வினவல் அளவுருக்கள்: start, end, மீண்டும் வழங்கக்கூடிய domains, மீண்டும் வழங்கக்கூடிய adRoots, மற்றும் adProvider. நேரடி ஏலதாரர் பகுப்பாய்வுக்கு directBidder தேவை.

மேம்பட்ட அறிக்கைகள்

அட்டவணைப்படி அல்லது உடனடி மின்னஞ்சல் அறிக்கைகளை உருவாக்குங்கள்

மேம்பட்ட அறிக்கைகளை உடனடியாக இயக்கலாம் அல்லது அட்டவணைப்படி மீண்டும் இயக்கலாம். அவை API பதிலில் நேரடியாக வழங்கப்படாமல் மின்னஞ்சல் வழியாக அனுப்பப்படும்.

மேம்பட்ட அறிக்கையைச் சேமிக்கவும்

curl -X POST https://surge.sulvo.com/api/v2/reports/save-advanced-report \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "reportType": "dimensions",
    "toAddress": "publisher@example.com",
    "immediateRun": true,
    "domains": ["example.com"],
    "dimensions": ["country", "device"],
    "start": "2026-06-01",
    "end": "2026-06-07"
  }'

Method	Path	Notes
GET	/api/v2/reports/advanced-reports	அங்கீகரிக்கப்பட்ட கணக்கில் சேமிக்கப்பட்ட மேம்பட்ட அறிக்கைகளைப் பட்டியலிடுங்கள்.
POST	/api/v2/reports/save-advanced-report	மேம்பட்ட அறிக்கையை உருவாக்கவும் அல்லது புதுப்பிக்கவும். reportType, toAddress, immediateRun ஆகியவை, மேலும் adRoots அல்லது domains ஆகியவற்றில் குறைந்தது ஒரு இலக்கும் தேவை.
DELETE	/api/v2/reports/delete-advanced-report/{reportId}	id மூலம் சேமிக்கப்பட்ட மேம்பட்ட அறிக்கையை நீக்குங்கள்.

அறிக்கை வகைகள்

adUnit, dimensions, customData

பரிமாணங்கள்

country, device, os

அதிர்வெண்

daily, weekly, biweekly, monthly

விளம்பர இருப்பு

அங்கீகரிக்கப்பட்ட விளம்பர அலகுகளை உருவாக்கவும் நீக்கவும்

விளம்பர இருப்பில் மாற்றங்களைச் செய்ய, அங்கீகரிக்கப்பட்ட Sulvo கணக்கும் inventory:write அனுமதி வரம்பைக் கொண்ட கணக்கு உரிமையாளர் உருவாக்கிய API விசையும் தேவை.

விளம்பர அலகை உருவாக்குங்கள்

curl -X PUT https://surge.sulvo.com/api/v2/inventory/unit \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "domain": "example.com",
    "type": "display",
    "size": { "width": 300, "height": 250 }
  }'

Method	Path	Notes
PUT	/api/v2/inventory/unit	domain, type, விருப்பத்தேர்வான size, placement, தனிப்பயன் பெயர், focusedAd அமைப்புகளுடன் ஒரு விளம்பர அலகை உருவாக்குங்கள்.
PUT	/api/v2/inventory/interstitial-units	ஒரு டொமைனுக்கான டெஸ்க்டாப் மற்றும்/அல்லது மொபைல் இடைநிலை விளம்பர அலகுகளை உருவாக்குங்கள்.
PUT	/api/v2/inventory/auto-sticky-units	ஒரு டொமைனுக்கான ஒட்டும் டிஸ்ப்ளே அலகுகள் மற்றும்/அல்லது மொபைல் ஒட்டும் அலகுகளை உருவாக்குங்கள்.
DELETE	/api/v2/inventory/unit/{adId}	அங்கீகரிக்கப்பட்ட கணக்குக்குச் சொந்தமான விளம்பர அலகை நீக்குங்கள்.

ஆதரிக்கப்படும் விளம்பர அலகு வகைகள்

displaynative_multisticky_displaysticky_mobilesticky_display_customsticky_mobile_customsticky_videointerstitial_desktopinterstitial_mobileofferwall

பிழைகள்

பிழைகளைக் கையாளுதல்

2xx அல்லாத தணிக்கைப் பதில்களும் Sulvo கணக்கு API தோல்விகளும் ஏஜென்ட் மற்றும் CLI கிளையன்ட்களுக்காக வடிவமைக்கப்பட்ட JSON பதில்களைத் திருப்புகின்றன.

401

கணக்கு API கோரிக்கைகளுக்கான API விசை விடுபட்டுள்ளது, செல்லாதது அல்லது காலாவதியானது. பொது தணிக்கைச் சேவை முகவரிக்கு விசை தேவையில்லை.

403

விசை அங்கீகரிக்கப்பட்டது, ஆனால் தேவையான அனுமதி வரம்பு இல்லை, கணக்கு அங்கீகரிக்கப்படவில்லை அல்லது வளம் வேறொரு கணக்குக்குச் சொந்தமானது.

503 / 504

பொது தணிக்கைச் சேவை முழுத் திறனில் உள்ளது அல்லது தணிக்கைக்கான நேரம் முடிந்தது. பின்னர் மீண்டும் முயற்சிக்கவும்; Retry-After இருந்தால் அதைப் பின்பற்றவும்.

தணிக்கைப் பிழைப் பதில் அமைப்பு

{
  "error": {
    "code": "audit_capacity_exceeded",
    "message": "Audit capacity is currently exhausted. Retry later."
  }
}

தொகுப்பாக வழங்கப்படும் கிளையன்டை விரும்புகிறீர்களா?

npm தொகுப்பும் MCP அமைப்பும் இந்தச் சேவை முகவரிகளை உங்களுக்காக அழைத்து, இணக்கமான AI கிளையன்ட்களுக்கு அதே தணிக்கை, அறிக்கை மற்றும் விளம்பர இருப்புப் பணிச்சூழல்களை வழங்குகின்றன.

அமைப்பைப் பாருங்கள்