ಪ್ರಕಾಶಕರ ಆದಾಯ ಆಡಿಟ್ 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	ಅಮಾನ್ಯ ಚಟುವಟಿಕೆ ವರದಿಗಾರಿಕೆ. ಸಾಮಾನ್ಯ date/domain ಕ್ವೆರಿ ಅಗತ್ಯವಿಲ್ಲ.
GET	/api/v1/reports/direct-bidder-analysis	ನೇರ ಬಿಡ್ಡರ್ ವರದಿ. directBidder ಅಗತ್ಯವಿದೆ; start/end ಅನ್ನು ಸಹ ಸೇರಿಸಬಹುದು.
GET	/api/v1/inventory/ad-units-by-domain	ಡೊಮೇನ್ ಪ್ರಕಾರ ಗುಂಪು ಮಾಡಿದ ಜಾಹೀರಾತು ಘಟಕ ಇನ್ವೆಂಟರಿ.

ಸಾಮಾನ್ಯ ಕ್ವೆರಿ ಪ್ಯಾರಾಮೀಟರ್‌ಗಳು: start, end, ಮರುಮರು ನೀಡಬಹುದಾದ domains, ಮರುಮರು ನೀಡಬಹುದಾದ adRoots ಮತ್ತು adProvider. ನೇರ ಬಿಡ್ಡರ್ ವಿಶ್ಲೇಷಣೆಗೆ directBidder ಕೂಡ ಅಗತ್ಯ.

ಸುಧಾರಿತ ವರದಿಗಳು

ನಿಗದಿತ ಅಥವಾ ತಕ್ಷಣ ಕಳುಹಿಸುವ ಇಮೇಲ್ ವರದಿಗಳನ್ನು ರಚಿಸಿ

ಸುಧಾರಿತ ವರದಿಗಳನ್ನು ತಕ್ಷಣ ನಡೆಸಬಹುದು ಅಥವಾ ವೇಳಾಪಟ್ಟಿಯಂತೆ ಮರುಕಳಿಸಬಹುದು. ಅವುಗಳನ್ನು ಪ್ರತಿಕ್ರಿಯೆಯೊಳಗೆ ನೀಡದೆ ಇಮೇಲ್ ಮೂಲಕ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.

ಸುಧಾರಿತ ವರದಿ ಉಳಿಸಿ

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, custom name ಮತ್ತು 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 ಕ್ಲೈಂಟ್‌ಗಳಿಗೆ ಅದೇ ಆಡಿಟ್, ವರದಿ ಮತ್ತು ಇನ್ವೆಂಟರಿ ಕಾರ್ಯಪ್ರವಾಹಗಳನ್ನು ಒದಗಿಸುತ್ತವೆ.

ಸೆಟಪ್ ನೋಡಿ