Tencent Ads Standard Delivery Creation Guide
Paste the following prompt into your AI chat to install this skill:
Please install @tencent-adm/tencentads-delivery-standard-create according to the guide at https://skillhub.cn/install/skillhub.md.
About this skill
Creating a standard ad group in Tencent Ads is a multi-step, highly sequential process. Each step's output is the input for the next, spanning multiple API interactions and business decisions. Using raw APIs or CLI commands directly introduces complexity around parameter validation and cross-platform scripting differences.
## Core Workflow and Scripted Execution
This skill encapsulates the entire procedure into 7 ordered steps. Its core capability lies in using dedicated scripts (built on tencentads-cli) to handle all API calls, data transformation, and business rule validation, allowing the Agent to focus solely on making decisions from the returned data.
- Step 1 (Obtain the Quadruple): The entry point. The
get-rules.mjsscript queries all available quadruple combinations for the account (marketing_goal,marketing_sub_goal,marketing_target_type,marketing_carrier_type). The Agent must filter the correct set based on the user's described intent (e.g., "e-commerce sales", "lead generation"). Guessing is forbidden; choices must be made from the exact enumerations returned by the script. - Step 1A (Asset-Based Inference, Optional): If the quadruple cannot be uniquely determined but the user provides a product name or ID, this step can use
get-assets-by-rules.mjsto query the account's asset list and precisely identify the quadruple via asset matching, avoiding user confirmation dialogs. - Step 2 (Obtain Promoted Product & Carrier): Calls
get-assets.mjsto fetch the specific asset ID (asset_id) and carrier ID (carrier_id). The script automatically handles routing for different asset types (e.g., ONEID, consumer products). - Subsequent Steps (3-6): Include placement settings, conversion configuration (following different paths based on the bid mode:
CPC/CPMvs.oCPM/oCPC), targeting setup, and finally, creating the ad group viacreate-adgroup.mjs. Each step often requires a business selection based on the previous step's result.
## Key Rules and Applicability Boundaries
Adhering to this skill has strict rules; violating them will disrupt the flow or cause errors:
* Strict Sequential Execution: Steps 1 and 2 are foundational and must be completed first. Subsequent steps are heavily dependent on their outputs and cannot be skipped.
* Bid Mode Dictates the Path: CPC/CPM bid modes allow for a simplified Step 3 (enabling automatic placements directly) and bypassing conversion queries in Step 4. In contrast, oCPM/oCPC requires the full execution of Steps 3 and 4.
* Cross-Platform Parameter Passing Pitfalls: The script invocation format node scripts/.mjs '' requires different JSON parameter quoting rules across terminals (Bash, CMD, PowerShell). The skill documentation explicitly lists the correct syntax for each environment, with Windows PowerShell 5.x requiring special handling.
* Error Handling: Each script call is retried at most once. If it fails twice, the step must be skipped, and processing must continue with available data to avoid infinite retry loops.
This skill is suited for scenarios requiring standardized, repeatable creation of Tencent standard ad groups. It is not applicable for creating Smart Delivery (AIM+) ads (which have different identifiers and parameter structures) or for scenarios requiring deviation from the standard flow for rapid or custom setups. All API operations are encapsulated within scripts and should not be bypassed by calling tencentads-cli api directly.
Use Cases
- An ad optimizer managing multiple Tencent Ads accounts needs to quickly create standard ad groups matching different clients' marketing objectives; manual backend operations are inefficient and error-prone.
- An e-commerce operations team needs to batch-create ad groups for multiple products before a major promotion, requiring strict adherence to company-standard delivery configurations (placements, targeting rules) that are difficult to ensure consistently through manual one-by-one creation.
- A technical developer needs to integrate Tencent Ads creation capabilities into a proprietary marketing management platform, replacing manual operations with script calls to automate the ad group creation workflow.
- An ad agency providing delivery services to clients needs to ensure each ad group accurately matches the client's marketing objective (e.g., app downloads, lead generation) and bid mode (oCPM/CPC) to avoid delivery failures due to configuration errors.
Best For
- A delivery optimizer managing 3+ Tencent Ads accounts daily, needing to standardize ad group creation processes to reduce delivery accidents caused by manual errors or configuration omissions.
- A backend developer in a marketing technology team, needing to call Tencent Ads APIs to create ad groups while handling complex parameter combinations and script integration across different asset types and bid modes.
- An operations director managing e-commerce ad delivery, needing to ensure the team creates ad groups for different products using unified standards, including accurate passing of key configurations like placements and conversion goals.
- A technical lead at an agency providing Tencent Ads management services to SME clients, needing to establish a reliable ad group creation process to handle diverse client requirements.
Related Skills
AI agent tool for generating HTML proposals for client visit business scenarios, featuring deep research and dynamic mainline mapping.
Bid Proposal Verification Tool is used to verify the consistency between bid proposals and tender documents, checking table of contents, page numbers, attachments, and seals, based on Shibot Technology's bid data API.
An AI engine built on extensive bidding data to precisely search for tender projects and potential clients using natural language or structured criteria.
Automates bid document, response table, and material list generation from bid files and enterprise data using Shibuo Technology API.