Tencent Ads Delivery Standard Update

Core Problem & Skill Positioning

In Tencent Ads operations, advertisers or optimizers frequently need to adjust parameters of already-created ads or smart delivery projects. For example, modifying bids and daily budgets due to budget strategy changes, or updating targeting segments because of poor performance. These changes often involve financial fields (like bid, budget) and high-risk fields (like targeting, status), and may target single or multiple ads/projects. Manual adjustment is inefficient and prone to errors in unit conversion (yuan/fen), missing parameters, or incorrect formatting, which can lead to incidents like overspending from a wrong bid or mismatched traffic from flawed targeting.

This skill provides a structured, safety-checked automation channel for these updates. It is not just an API wrapper but institutionalizes high-risk configuration changes into controlled, auditable steps through a predefined SOP—especially the mandatory pre-update check and post-update verification. Its core solution is to answer: "How to safely and accurately batch-update ad properties?"

Workflow & Core Capabilities

The skill supports two modes, selected based on the number of targets:
- Single Ad/Project Update: Uses update-adgroup-general.mjs for fine-grained operations on one entity with detailed logs.
- Batch Update: Uses update-adgroup-batch.mjs for heterogeneous updates across multiple ads/projects (each can update different fields), even across accounts.

The core capability lies in the complete six-step workflow, with critical safety designs in the first three steps:

1. Intent Recognition: Determines whether to use single or batch update based on user instructions (e.g., "lower bid by 10%" vs. "pause ads A and B").
2. Parameter Construction: Parses natural language into API fields. Key points include:
   • All monetary units are in fen (e.g., bid_amount: 5000 represents 50 yuan).
   • Supports relative adjustment expressions (e.g., bid_amount_adjustment: "-10%"), which are calculated to absolute values during the check.
   • Automatically matches targeting enums (e.g., age as [{"min":25,"max":30}]), simplifying user configuration.
3. Pre-update Check: This is the key safety barrier. When changes involve money, status, or targeting fields, the Agent must restate the changes (e.g., "Adjusting Ad X's bid from 10000 fen (100 yuan) to 12000 fen (120 yuan)") and await explicit confirmation. This step effectively prevents misoperations.
4. Script Execution: Calls the corresponding MJS script to make the API request.
5. Verification Check: The script automatically queries the API to fetch the latest field values post-update.
6. Reflection & Comparison: The Agent compares the verified data with the user-confirmed target values to ensure the change took effect and handles any discrepancies.

Boundaries & Important Constraints

• Field Support Differences: Standard ads and smart delivery projects support different field sets. For instance, bid_adjustment (per-site bid) is only for smart projects, while rta_id is only for standard ads. The ad type must be identified before use.
• Amount & Format: All financial fields (bid_amount, daily_budget, auto_acquisition_budget, etc.) are in fen. The Agent is responsible for converting user input in yuan to fen.
• Relative Adjustment Expressions: The _adjustment fields support percentages (+20%), multipliers (*2), and absolute adjustments (+50 fen), but are not supported when the current value is 0.
• Targeting Update Complexity: Modifying targeting is overwriting, not merging. Passing an empty object {} sets targeting to "unlimited" and requires special confirmation. Some targeting dimensions (e.g., geo, device model) require a prior lookup call to get the correct codes.
• One-Click Boost / Traffic Surge Tool (冲量宝) Logic: When enabled, the budget or bid-over-percent cannot be modified directly. The skill automatically executes a "close then reopen" sequence (via setting re_open_auto_acquisition=1), consistent with the Tencent Ads frontend, but may cause a brief pause in delivery.
• Periodic Achievement Projects: Modifying their periodic budget (smart_delivery_period_budget) has special constraints (e.g., can only be increased) and requires reference to specialized documentation.