AdButler

com.adbutler由 adbutler.com 发布官方发布者v2.8.0更新于 Oct 24, 2026

Manage AdButler campaigns, zones, ad items, VAST, and reports from Claude, ChatGPT, and Cursor.

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

AdButler MCP 服务器让 AI 助手通过数百个工具管理 AdButler 广告账户，涵盖广告主、广告系列、区域、创意、VAST 视频、定向和报告。

可以做什么
列出、创建、更新、归档和删除广告主、广告系列与渠道，包括永久删除已归档项和批量操作目录广告项。管理将广告项关联到广告系列的广告系列分配，并列出渠道区域分配。获取广告系列的转化标签和可用区域。通过后备元工具搜索、描述并调用任意 AdButler v2 API 端点。运行引导式工作流提示，用于广告系列上线、零售媒体、报告、VAST 视频、程序化、定向、合同、渠道和草稿。
适用场景
当你通过 AdButler 投放广告，并希望助手在对话中而非仪表盘中创建或审查广告系列、区域、创意、定向和报告时使用。引导式提示适合广告系列上线或配置程序化交易等端到端设置。
运行要求
需要 AdButler 账户和 API 密钥（ADBUTLER_API_KEY，在 AdButler 仪表盘的 Settings → API Keys 中创建）。可使用 mcp.adbutler.com 的托管端点，以 Authorization Bearer 头或 api_key 查询参数传入密钥；也可通过 npx 在 Node.js 上运行本地 npm 包。需要访问 AdButler 的网络连接。
安装前请注意
该密钥拥有账户的完整控制权，许多工具会写入、归档或永久删除广告主、广告系列和渠道。在托管服务器上，在对话中输入的密钥仅在本次会话有效，建议改用连接头配置。托管服务器会收集每次调用的使用分析（工具名、账户 ID、截断的密钥指纹、错误文本），自行安装的副本则不收集任何数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AdButler，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.adbutler%2Fmcp-server/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "adbutler": {
      "type": "http",
      "url": "https://mcp.adbutler.com/mcp"
    }
  }
}

README

AdButler MCP Server

[npm] [License: MIT]

Manage your entire AdButler account from any AI assistant — Claude, ChatGPT, Cursor, Windsurf, Cline, and any other Model Context Protocol client.

This MCP server exposes the full AdButler v2 API — 600+ tools covering advertisers, campaigns, zones, creatives, placements, VAST video ads, programmatic / RTB, reporting, targeting, drafts, contracts, product catalogs, and more — plus 9 pre-built workflow prompts that walk an AI through common tasks like launching a campaign or setting up retail media.

What you can ask

"Create a new campaign for Pepsi targeting users in Canada with a $5,000 lifetime budget, and assign it to my Homepage Banner zone."

"Show me the top 10 underperforming ad items in the last 7 days by CTR."

"Set up a VAST 4.2 pre-roll campaign with a 30-second skippable creative and three companion banners."

"Walk me through creating a new programmatic deal."

"Audit my ad units — which zones have no active placements?"

The AI translates these into the right sequence of AdButler API calls, runs them, and shows you the result.

Install

You have two options. Most users want the hosted version — zero setup, just paste a URL.

Option A — Hosted (recommended)

Use AdButler's hosted MCP server. No install, no Node, no npm.

The hosted server speaks both modern Streamable HTTP (/mcp) and legacy SSE (/sse) transports. New clients should prefer Streamable HTTP; SSE remains for backward compatibility.

ClientConfiguration
Claude Desktop / CodeAdd an MCP server with URL https://mcp.adbutler.com/mcp (or /sse for older clients) and header Authorization: Bearer YOUR_ADBUTLER_API_KEY
CursorSettings → Features → Model Context Protocol → Add server with the URL + auth header above
Any MCP clientStreamable HTTP: https://mcp.adbutler.com/mcp  ·  SSE: https://mcp.adbutler.com/sse — pass your API key via Authorization: Bearer … or ?api_key=…

Option B — Local stdio (npm)

Run the server locally as a Node process. Useful if you want to keep your API key out of any external service or run against a self-hosted AdButler.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "adbutler": {      "command": "npx",      "args": ["-y", "@adbutler/mcp-server"],      "env": {        "ADBUTLER_API_KEY": "your_api_key_here"      }    }  }}
Claude Code
bash
claude mcp add adbutler --env ADBUTLER_API_KEY=your_api_key_here -- npx -y @adbutler/mcp-server
Cursor / Windsurf / Cline

Add to the client's MCP config:

json
{  "mcpServers": {    "adbutler": {      "command": "npx",      "args": ["-y", "@adbutler/mcp-server"],      "env": { "ADBUTLER_API_KEY": "your_api_key_here" }    }  }}

Get your AdButler API key

AdButler Dashboard → Settings → API Keys → create a new key. It's the same key the AdButler v2 REST API uses.

Authentication

The AdButler MCP works for both new and existing customers. What you see depends on whether you've already configured an API key.

Already an AdButler customer? (existing API key)

Use one of these:

Option 1 — set the API key in your connection config (recommended: persists across sessions)

Pass the key at connect time and every session authenticates automatically — the key never has to be shared in the chat.

  • Claude Code — claude mcp add adbutler --transport http https://mcp.adbutler.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
  • Claude Desktop — edit claude_desktop_config.json → add headers: { "Authorization": "Bearer YOUR_API_KEY" } next to the server URL
  • Cursor — MCP server settings → Headers → add Authorization: Bearer YOUR_API_KEY
  • claude.ai custom connectors (no custom-header support) — use the URL form: https://mcp.adbutler.com/mcp?api_key=YOUR_API_KEY
  • Any client — Authorization: Bearer … header or ?api_key=… query param, on /mcp (Streamable HTTP) or /sse (legacy SSE)

Reconnect — all 600+ tools become available immediately.

Option 2 — configure inside the chat (current session only on hosted)

Connect to the hosted MCP without auth and you'll see four onboarding tools. Then in the chat say:

"Configure my AdButler API key: your_api_key_here"

Your AI will call the setup_api_key tool, validate the key against your account, and unlock all the AdButler tools. You may need to disconnect and reconnect to refresh your client's tool list after.

⚠️ On the hosted server, a key configured this way lasts only until the session ends — a new chat, a client restart, or a server-side reconnect will ask for it again. If you find yourself pasting the key into the chat repeatedly (and your AI warning you about sharing secrets in conversation), switch to Option 1: configure the key once in the connection settings and it persists.

Troubleshooting: "my API key won't stay configured"

This means the key is being entered in-chat (Option 2) against the hosted server, where it is deliberately session-scoped — the hosted server is multi-tenant and never writes your key to disk. The fix is one-time setup in your client's connection config (Option 1 above): header for Claude Code / Claude Desktop / Cursor, ?api_key= URL parameter for claude.ai custom connectors. After that, reconnects and new chats authenticate automatically.

New to AdButler? (no account yet)

Connect to the hosted MCP without auth. The chat will guide you through a free trial signup using create_trial_account → check your email → verify_trial_email with the code. The API key is configured automatically.

Local stdio install

If you're running locally via npx, set ADBUTLER_API_KEY in the env block of your client's MCP config (see Option B above). The setup tools also work — and on local the key is remembered between sessions.

What's included

9 workflow prompts

Pre-built skill prompts that guide the AI through complete workflows end-to-end. Invoke them as MCP prompts (/launch-campaign etc.) from your client.

PromptWhat it does
launch-campaignWalks an end-to-end campaign launch — advertiser → campaign → ad items → creatives → targeting → placements
retail-media-setupSets up sponsored products / retail media for an e-commerce site
reportingGenerates a custom report with the right dimensions and filters
vast-videoBuilds a VAST video ad with linear + companion creatives
programmaticConfigures programmatic deals, bidders, and demand sources
targetingBuilds geo / platform / data-key / list targets
contractsCreates IO contracts and assigns them to campaigns
channelsBundles zones into a channel and assigns campaigns
draftsStages a complete campaign as drafts before going live

3 fallback meta-tools (search, describe, call)

When you need an endpoint that no specific tool wraps — or when the user asks about a field (e.g. "priority", "frequency cap") rather than a resource — three escape-hatch tools cover the gap:

ToolWhat it does
search_adbutler_apiKeyword-search the full AdButler OpenAPI spec for matching endpoints
describe_adbutler_apiGet the full schema (params, body, response) for one endpoint
call_adbutler_apiInvoke any endpoint by method+path, with the session's auth applied automatically

These complement (don't replace) the specific tools below — the LLM continues to prefer specific tools when they obviously match.

600+ tools across the full AdButler API

DomainToolsExamples
Display ads100+list_advertisers, create_campaign, create_image_ad_item, create_native_ad_item, create_placement, create_schedule, create_campaign_assignment
VAST 2/3/4 video156vast_create_creative, vast_create_linear_media, vast_create_companion, vast_create_placement, vast_create_schedule, plus full VAST 4.2 sub-resource coverage
Zones & publishing50+create_zone, create_zone_catalog, create_zone_email, create_native_template, create_publisher, ORTB native assets
Targeting37create_geo_target, create_platform_target, create_data_key, create_data_list, create_postal_code_target
Reporting39get_display_report, get_vast_report, get_event_logs, custom report configs, scheduled reports
Programmatic / RTB25create_demand_source, create_demand_endpoint, create_bidder, create_pmp_deal
Product catalogs20create_product_db_catalog, bulk_upload_products, ad item ↔ catalog item linking
Drafts48Stage campaigns/ad items/placements/schedules as drafts; publish atomically
Contracts43Insertion orders, contract documents, signature requests, payments
Account & security27Users, roles, redirect domains, beacon signing keys, SFTP connections
Ad serving2serve_ad, live_website_preview

100% coverage of the AdButler v2 OpenAPI spec (604/604 endpoints).

Telemetry

The hosted server at mcp.adbutler.com collects usage analytics so we can understand which tools are popular, prioritize improvements, and diagnose failures. We capture, per tool call:

  • Tool name (e.g. list_zones, create_campaign) — never tool arguments
  • Account ID (derived once per session from /self)
  • API-key fingerprint (SHA-256, truncated to 16 hex chars) — identifies which key was used without storing the key itself
  • Transport (HTTP or SSE), MCP client name and version (e.g. Claude Desktop), call duration, success/error status
  • On errors: upstream HTTP status code, a categorical error class (e.g. forbidden, network), and the error message text (truncated to 1000 characters)

We never collect: tool arguments, response bodies, your raw API key, IP addresses, request bodies. The instrumentation only sees the tool name, timing, and (on failure) the error message produced by the MCP server or AdButler API.

Self-installed copies — npm package, stdio, your own deployment — collect zero data. The instrumentation only fires when the ANALYTICS_INGEST_URL environment variable is set, which is only true for the hosted endpoint at mcp.adbutler.com.

If you'd prefer to opt out of analytics on the hosted server, run your own copy via stdio or self-host the SSE/HTTP server.

Development

Local source for contributors:

bash
git clone https://github.com/adbutler/mcp-servercd mcp-servernpm installnpm run buildADBUTLER_API_KEY=your_key node dist/index.js

Inspect with the official MCP inspector:

bash
npx @modelcontextprotocol/inspector node dist/index.js

Resources

License

MIT

来源：README.md，提交 29d527f

工具

200

list_advertisers

List all advertisers in your AdButler account

输入参数limitoffset

get_advertiser

Get details of a specific advertiser by ID

输入参数id必填

create_advertiser

Create a new advertiser

输入参数name必填emailmetadatapasswordcan_add_ad_itemscan_change_password

update_advertiser

Update an existing advertiser

输入参数id必填nameemailmetadatapasswordcan_add_ad_itemscan_change_password

delete_advertiser

Delete an advertiser

输入参数id必填

archive_advertiser

Archive an advertiser (soft-delete, can be restored later)

输入参数id必填

list_archived_advertisers

List all archived advertisers

输入参数limitoffset

get_archived_advertiser

Get details of a specific archived advertiser

输入参数id必填

unarchive_advertiser

Restore an archived advertiser back to active status

输入参数id必填

list_all_campaigns

List all campaigns across all types

输入参数limitoffset

list_campaigns

List all standard campaigns

输入参数limitoffset

get_campaign

Get details of a specific standard campaign

输入参数id必填

create_campaign

Create a new standard campaign

输入参数name必填budgetcontractmetadataadvertiserroadblock_tagstargeting_sourcescheduling_sourcetrusted_redirect_domains

update_campaign

Update an existing standard campaign

输入参数id必填namebudgetcontractmetadataadvertiserroadblock_tagstargeting_sourcescheduling_sourcetrusted_redirect_domains

delete_campaign

Delete a standard campaign

输入参数id必填

archive_campaign

Archive a standard campaign (soft-delete, can be restored later)

输入参数id必填

list_archived_campaigns

List all archived standard campaigns

输入参数limitoffset

get_archived_campaign

Get details of a specific archived standard campaign

输入参数id必填

delete_archived_campaign

Permanently delete an archived standard campaign

输入参数id必填

unarchive_campaign

Restore an archived standard campaign back to active status

输入参数id必填

get_campaign_conversion_tag

Get conversion tag for a campaign

输入参数id必填

get_campaign_eligible_zones

Get eligible zones for a campaign

输入参数id必填

campaign_bulk_create_catalog_ad_items

Bulk create catalog ad items in a campaign

输入参数items必填campaign_id必填

campaign_bulk_delete_catalog_ad_items

Bulk delete catalog ad items from a campaign

输入参数items必填campaign_id必填

list_campaign_assignments

List all campaign assignments (ad items assigned to campaigns)

输入参数limitoffset

get_campaign_assignment

Get details of a specific campaign assignment

输入参数id必填

create_campaign_assignment

Create a new campaign assignment (assign an ad item to a campaign)

输入参数activeweightcampaign必填keywordsschedulegeo_targetlist_targetadvertisement必填data_key_targetplatform_targetkeywords_match_method

update_campaign_assignment

Update an existing campaign assignment

输入参数id必填activeweightkeywordsschedulegeo_targetlist_targetdata_key_targetplatform_targetkeywords_match_method

delete_campaign_assignment

Delete a campaign assignment

输入参数id必填

list_channels

List all channels

输入参数limitoffset

get_channel

Get details of a specific channel

输入参数id必填

create_channel

Create a new channel

输入参数name必填priorityuse_share_of_voice

update_channel

Update an existing channel

输入参数id必填namepriority

delete_channel

Delete a channel

输入参数id必填

archive_channel

Archive a channel (soft-delete, can be restored later)

输入参数id必填

list_archived_channels

List all archived channels

输入参数limitoffset

get_archived_channel

Get details of a specific archived channel

输入参数id必填

delete_archived_channel

Permanently delete an archived channel

输入参数id必填

unarchive_channel

Restore an archived channel back to active status

输入参数id必填

list_channel_zone_assignments

List all channel zone assignments

输入参数limitoffset

get_channel_zone_assignment

Get details of a specific channel zone assignment

输入参数id必填

create_channel_zone_assignment

Assign a zone to a channel

输入参数zone必填channel必填

delete_channel_zone_assignment

Remove a zone from a channel

输入参数id必填

list_all_zones

List all zones across all types (standard, email, catalog)

输入参数limitoffset

list_zones

List all standard zones

输入参数limitoffset

get_zone

Get details of a specific standard zone

输入参数id必填

create_zone

Create a new standard zone. Set dimensions to "dynamic" for a dynamic zone (width/height must be 0), or "fixed" (default) for a fixed-size zone.

输入参数name必填widthheightmetadatabid_floorpmp_dealspublisherdimensionsmin_payoutresponsiveburn_in_hoursrefresh_limit另有 15 个

update_zone

Update an existing standard zone

输入参数id必填namewidthheightmetadatabid_floorpmp_dealspublisherdimensionsmin_payoutresponsiveburn_in_hours另有 15 个

delete_zone

Delete a standard zone

输入参数id必填

get_zone_tag

Get the ad serving tag (embed code) for a zone

输入参数id必填

get_zone_conversion_tag

Get the conversion tracking tag for a standard zone

输入参数id必填

generate_bulk_zone_tags

Generate ad serving tags for multiple zones at once

输入参数zone_ids必填

archive_zone

Archive a standard zone (soft-delete, can be restored later)

输入参数id必填

list_archived_zones

List all archived standard zones

输入参数limitoffset

get_archived_zone

Get details of a specific archived standard zone

输入参数id必填

unarchive_zone

Restore an archived standard zone back to active status

输入参数id必填

list_email_zones

List all email zones

输入参数limitoffset

get_email_zone

Get details of a specific email zone

输入参数id必填

create_email_zone

Create a new email zone for serving ads in email newsletters

输入参数name必填width必填height必填metadatapublisheruid_rotaterotate_timerauction_tie_break

update_email_zone

Update an existing email zone

输入参数id必填namewidthheightmetadatapublisheruid_rotaterotate_timerauction_tie_break

delete_email_zone

Delete an email zone

输入参数id必填

get_email_zone_tag

Get the ad serving tag for an email zone

输入参数id必填

get_email_zone_conversion_tag

Get the conversion tracking tag for an email zone

输入参数id必填

archive_email_zone

Archive an email zone

输入参数id必填

list_archived_email_zones

List all archived email zones

输入参数limitoffset

get_archived_email_zone

Get details of a specific archived email zone

输入参数id必填

unarchive_email_zone

Restore an archived email zone back to active status

输入参数id必填

list_catalog_zones

List all catalog zones (for product/retail ad serving)

输入参数limitoffset

get_catalog_zone

Get details of a specific catalog zone

输入参数id必填

create_catalog_zone

Create a new catalog zone for product/retail ad serving

输入参数name必填bid_floorpublishercatalog_id必填auction_typebid_floor_cpcbid_floor_cpmadvertiser_cost_typeclick_cooldown_periodconversion_lookback_period

update_catalog_zone

Update an existing catalog zone

输入参数id必填nameauction_typebid_floor_cpcbid_floor_cpmadvertiser_cost_typeclick_cooldown_periodconversion_lookback_period

delete_catalog_zone

Delete a catalog zone

输入参数id必填

get_catalog_zone_tag

Get the ad serving tag for a catalog zone

输入参数id必填

list_publishers

List all publishers in your AdButler account

输入参数limitoffset

get_publisher

Get details of a specific publisher

输入参数id必填

create_publisher

Create a new publisher

输入参数name必填emaildomainmetadatatimezoneseller_typedefault_payoutcan_approve_adscan_admin_accountcan_change_passwordcan_view_wordpress_key

update_publisher

Update an existing publisher

输入参数id必填nameemaildomainmetadatatimezoneseller_typedefault_payoutcan_approve_adscan_admin_accountcan_change_passwordcan_view_wordpress_key

delete_publisher

Delete a publisher

输入参数id必填

archive_publisher

Archive a publisher (soft-delete, can be restored later)

输入参数id必填

list_archived_publishers

List all archived publishers

输入参数limitoffset

get_archived_publisher

Get details of a specific archived publisher

输入参数id必填

unarchive_publisher

Restore an archived publisher back to active status

输入参数id必填

list_ad_items

List all ad items (banners) across all types (image, custom HTML, rich media, native, catalog)

输入参数limitoffset

list_image_ad_items

List all image ad items

输入参数limitoffset

get_image_ad_item

Get details of a specific image ad item

输入参数id必填

create_image_ad_item

Create a new image ad item (banner)

输入参数name必填widthheightcreativelocationmetadatahtml_targetcreative_urlhtml_alt_texttracking_pixeltracking_pixelshtml_content_below另有 1 个

update_image_ad_item

Update an existing image ad item

输入参数id必填namewidthheightcreativelocationmetadatahtml_targetcreative_urlhtml_alt_texttracking_pixeltracking_pixels另有 2 个

delete_image_ad_item

Delete an image ad item

输入参数id必填

get_image_ad_item_conversion_tag

Get conversion tracking tag for an image ad item

输入参数id必填

list_custom_html_ad_items

List all custom HTML ad items

输入参数limitoffset

get_custom_html_ad_item

Get details of a specific custom HTML ad item

输入参数id必填

create_custom_html_ad_item

Create a new custom HTML ad item

输入参数name必填widthheightlocationmetadatacustom_html必填tracking_pixeltracking_pixelshtml_content_belowtrusted_redirect_domainsexpand_vertical_directionexpand_horizontal_direction

update_custom_html_ad_item

Update an existing custom HTML ad item

输入参数id必填namewidthheightlocationmetadatacustom_htmltracking_pixeltracking_pixelshtml_content_belowtrusted_redirect_domainsexpand_vertical_direction另有 1 个

delete_custom_html_ad_item

Delete a custom HTML ad item

输入参数id必填

get_custom_html_ad_item_conversion_tag

Get conversion tracking tag for a custom HTML ad item

输入参数id必填

list_rich_media_ad_items

List all rich media ad items

输入参数limitoffset

get_rich_media_ad_item

Get details of a specific rich media ad item

输入参数id必填

create_rich_media_ad_item

Create a new rich media ad item

输入参数name必填widthheightcreative必填locationmetadatatracking_pixeltracking_pixelshtml_content_belowtrusted_redirect_domainsexpand_vertical_directionexpand_horizontal_direction

update_rich_media_ad_item

Update an existing rich media ad item

输入参数id必填namecreativelocationmetadatatracking_pixeltracking_pixelshtml_content_belowtrusted_redirect_domainsexpand_vertical_directionexpand_horizontal_direction

delete_rich_media_ad_item

Delete a rich media ad item

输入参数id必填

get_rich_media_ad_item_conversion_tag

Get conversion tracking tag for a rich media ad item

输入参数id必填

list_native_ad_items

List all native ad items

输入参数limitoffset

get_native_ad_item

Get details of a specific native ad item

输入参数id必填

create_native_ad_item

Create a new native ad item using a native template

输入参数name必填widthheightlocationmetadatatemplate必填variables必填tracking_pixeltracking_pixelstrusted_redirect_domains

update_native_ad_item

Update an existing native ad item

输入参数id必填namelocationmetadatatemplatevariablestracking_pixeltracking_pixelstrusted_redirect_domains

delete_native_ad_item

Delete a native ad item

输入参数id必填

get_native_ad_item_conversion_tag

Get conversion tracking tag for a native ad item

输入参数id必填

list_catalog_ad_items

List all catalog ad items

输入参数limitoffset

get_catalog_ad_item

Get details of a specific catalog ad item

输入参数id必填

create_catalog_ad_item

Create a new catalog ad item

输入参数name必填locationmetadatacatalog_id必填tracking_pixeltracking_pixelscatalog_item_identifier必填

update_catalog_ad_item

Update an existing catalog ad item

输入参数id必填namelocationmetadatatracking_pixeltracking_pixelscatalog_item_identifier

delete_catalog_ad_item

Delete a catalog ad item

输入参数id必填

convert_native_to_image

Convert a native ad item to an image ad item

输入参数id必填

list_all_creatives

List all creatives across all types (image, rich media, video, audio)

输入参数limitoffset

list_creatives

List all image creatives

输入参数limitoffset

get_creative

Get details of a specific image creative

输入参数id必填

create_creative

Create a new image creative. The API uses multipart file upload — pass the media group ID and file attributes.

输入参数namegroup必填description

update_creative

Update an existing image creative

输入参数id必填namedescription

delete_creative

Delete an image creative

输入参数id必填

list_rich_media_creatives

List all rich media creatives

输入参数limitoffset

get_rich_media_creative

Get details of a specific rich media creative

输入参数id必填

create_rich_media_creative

Create a new rich media creative. The API uses multipart file upload (ZIP for HTML5).

输入参数namegroup必填descriptionindex_file_path

update_rich_media_creative

Update an existing rich media creative

输入参数id必填namedescription

delete_rich_media_creative

Delete a rich media creative

输入参数id必填

list_video_creatives

List all video creatives

输入参数limitoffset

get_video_creative

Get details of a specific video creative

输入参数id必填

create_video_creative

Create a new video creative. The API uses multipart file upload.

输入参数namegroup必填description

update_video_creative

Update an existing video creative

输入参数id必填namedescription

delete_video_creative

Delete a video creative

输入参数id必填

list_audio_creatives

List all audio creatives

输入参数limitoffset

get_audio_creative

Get details of a specific audio creative

输入参数id必填

create_audio_creative

Create a new audio creative. The API uses multipart file upload.

输入参数namegroup必填description

update_audio_creative

Update an existing audio creative

输入参数id必填namedescription

delete_audio_creative

Delete an audio creative

输入参数id必填

replace_image_creative_file

Replace the file on an image creative

输入参数id必填

replace_rich_media_creative_file

Replace the file on a rich media creative

输入参数id必填

replace_video_creative_file

Replace the file on a video creative

输入参数id必填

replace_audio_creative_file

Replace the file on an audio creative

输入参数id必填

list_placements

List all placements (assignments of ad items to zones)

输入参数limitoffset

get_placement

Get details of a specific placement

输入参数id必填

create_placement

Create a new placement (assign an ad item or campaign to a zone or channel)

输入参数costzoneactivepayoutweightchannelkeywordspriorityschedule必填geo_targetlist_targetserve_method另有 6 个

update_placement

Update an existing placement

输入参数id必填costzoneactivepayoutweightchannelkeywordspriorityschedulegeo_targetlist_target另有 7 个

delete_placement

Delete a placement (remove an ad item from a zone)

输入参数id必填

get_placement_conversion_tag

Get conversion tracking tag for a placement

输入参数id必填

list_native_templates

List all native ad templates

输入参数limitoffset

get_native_template

Get details of a specific native template

输入参数id必填

create_native_template

Create a new native ad template with HTML and variable placeholders

输入参数name必填raw_html必填variables必填

update_native_template

Update an existing native template. Variables uses add/remove format for updates.

输入参数id必填nameraw_htmlvariables

delete_native_template

Delete a native template

输入参数id必填

list_schedules

List all schedules (time-based delivery rules for ad items)

输入参数limitoffset

get_schedule

Get details of a specific schedule

输入参数id必填

create_schedule

Create a new schedule for time-based ad delivery. Schedules are automatically linked to ad items via placements.

输入参数end_atend_datestart_atquota_typestart_dateday_cap_typeday_cap_limitday_parting_idquota_lifetimedelivery_methodend_at_timezonestart_at_timezone另有 3 个

update_schedule

Update an existing schedule

输入参数id必填end_atend_datestart_atquota_typestart_dateday_cap_typeday_cap_limitday_parting_idquota_lifetimedelivery_methodend_at_timezone另有 4 个

delete_schedule

Delete a schedule

输入参数id必填

list_media_groups

List all media groups (collections of creatives)

输入参数limitoffset

get_media_group

Get details of a specific media group

输入参数id必填

create_media_group

Create a new media group

输入参数name必填

update_media_group

Update an existing media group

输入参数id必填name

delete_media_group

Delete a media group

输入参数id必填

list_data_keys

List all data keys (custom key-value targeting variables)

输入参数limitoffset

get_data_key

Get details of a specific data key

输入参数id必填

create_data_key

Create a new data key for custom targeting

输入参数name必填type必填

update_data_key

Update an existing data key

输入参数id必填nametype

delete_data_key

Delete a data key

输入参数id必填

list_data_key_targets

List all data key targets (targeting rules using data key values)

输入参数limitoffset

get_data_key_target

Get details of a specific data key target

输入参数id必填

create_data_key_target

Create a new data key target (targeting rule)

输入参数name必填target必填

update_data_key_target

Update an existing data key target

输入参数id必填nametarget

delete_data_key_target

Delete a data key target

输入参数id必填

list_day_partings

List all day parting rules (time-of-day targeting)

输入参数limitoffset

get_day_parting

Get details of a specific day parting rule

输入参数id必填

create_day_parting

Create a new day parting rule for time-of-day targeting. Ranges is an object with day names as keys and arrays of time range strings (e.g. "09:00:00-17:00:00") as values.

输入参数namerangesis_templateuse_member_timezone

update_day_parting

Update an existing day parting rule

输入参数id必填namerangesis_templateuse_member_timezone

delete_day_parting

Delete a day parting rule

输入参数id必填

list_geo_targets

List all geo targets (geographic targeting rules)

输入参数limitoffset

get_geo_target

Get details of a specific geo target

输入参数id必填

create_geo_target

Create a new geo target for geographic targeting. Areas is an array of objects with continent, country (2-letter code), region, city fields.

输入参数name必填unitareas必填rangeinclusive

update_geo_target

Update an existing geo target

输入参数id必填nameunitareasrangeinclusive

delete_geo_target

Delete a geo target

输入参数id必填

list_postal_code_targets

List all postal code targets

输入参数limitoffset

get_postal_code_target

Get details of a specific postal code target

输入参数id必填

create_postal_code_target

Create a new postal code target

输入参数label必填inclusivelocations必填

update_postal_code_target

Update an existing postal code target

输入参数id必填labelinclusivelocations

delete_postal_code_target

Delete a postal code target

输入参数id必填

list_list_targets

List all list targets (allowlist/blocklist targeting)

输入参数limitoffset

get_list_target

Get details of a specific list target

输入参数id必填

create_list_target

Create a new list target (inclusion/exclusion using a data list)

输入参数label必填data_listinclusive

update_list_target

Update an existing list target

输入参数id必填labeldata_listinclusive

delete_list_target

Delete a list target

输入参数id必填

list_platform_targets

List all platform targets (device/OS/browser targeting)

输入参数limitoffset

get_platform_target

Get details of a specific platform target

输入参数id必填

create_platform_target

Create a new platform target for device/OS/browser targeting

输入参数name必填platformdevice_targets

update_platform_target

Update an existing platform target

输入参数id必填nameplatformdevice_targets

delete_platform_target

Delete a platform target

输入参数id必填

list_data_targets

List all data targets

输入参数limitoffset

remove_list_target_usages

Remove all usages of a list target

输入参数id必填

get_display_report

Get display advertising report with impressions, clicks, and CTR

输入参数type必填zonesperiod必填presetdetailssummarytimezonebreakdowncampaignsfinancialspublishersadvertisers另有 4 个

get_vast_report

Get VAST video advertising report

输入参数type必填zonesperiod必填presetdetailssummarytimezonebreakdowncampaignsfinancialspublishersadvertisers

get_event_logs

Get event logs for account activity (changes, logins, etc.)

输入参数tofromlog_type必填

get_click_details_report

Get click details report

输入参数zonespresettimezonecampaignspublishersadvertisers

版本历史

2
  1. v2.8.0最新Oct 19, 2026
  2. v2.4.2Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。