Tencent Ads Creative Management

Problem Solved

In Tencent ad campaigns, managing dynamic creatives (component-based creatives) for display ads is a complex process. Advertisers need to handle various creative components such as images, videos, and text, but face several challenges:

• Tedious parameter validation: Creative creation involves mandatory field checks, creative count limits, and component dependency constraints, which are error-prone when done manually.
• Cross-platform compatibility: Passing JSON parameters across different operating systems and terminals requires specific quote wrapping methods, often leading to parse failures.
• Fragmented asset management: Uploading, querying, and authorizing assets involves multiple APIs, making the process disjointed.
• Product template integration: For dynamic product ads (MPA/DPA), generating assets from product catalogs requires a separate but intricate workflow.

This skill aims to address these issues through scripted tools, providing an automated and standardized creative management workflow.

How the Skill Works

Based on the Tencent Marketing Ads API v3.0, the skill implements core functions via a series of Node.js scripts. Key steps include:

Asset Preparation

If assets like image_id or video_id are already available, use them directly; otherwise, upload or query assets using scripts:

• Upload assets: Use scripts/upload-image.mjs or scripts/upload-video-svp.mjs, supporting images (jpg/png/gif ≤10MB) and videos (mp4/mov/avi ≤100MB).
• Query assets: Offers two modes:
• Media library mode: Use scripts/get-integrated-media.mjs for availability filtering, report sorting, etc.
• Component mode: Use scripts/get-integrated-components.mjs to query by component granularity, directly obtaining component_id.

Generate Assets from Product Templates

For dynamic product ads, generate assets from product catalog templates:

• Query templates: Use scripts/dynamic-product-templates/get-dynamic-ad-image-templates.mjs or get-dynamic-ad-video-templates.mjs.
• Generate assets: Use generate-dynamic-ad-image.mjs or generate-dynamic-ad-video.mjs; the returned image_id or video_id can be used in creative components.

Create Creatives

The core process involves three steps:

1. Query ad group context: Use scripts/query-adgroup-context.mjs to retrieve ad group information like marketing_asset_outer_spec.
2. Query creative formats and constraints: Use scripts/get-creative-templates.mjs and scripts/get-component-depends.mjs to determine available creative templates and component dependency rules. For example, filling live_promoted_type depends on live_promoted_type_list.
3. Obtain and build components: Fetch component_id via scripts/get-component-list.mjs or scripts/get-components.mjs, following selection rules (user-specified > unique available > ask user). Then, use scripts/build-creative-params.mjs to preprocess parameters and finally call scripts/create-creative.mjs to create the creative.

Other operations like updating or deleting creatives use corresponding scripts update-creative.mjs and delete-creative.mjs.

Considerations

When using this skill, note the following:

• Serial execution constraint: Creative operations under the same ad group must be executed serially, not concurrently, to avoid conflicts.
• Do not modify user intent: User-specified parameter values must be passed as-is; if unsupported by scripts, explicitly report an error instead of using default values.
• Cross-platform JSON passing: When passing JSON parameters across terminals (e.g., Linux, Windows CMD, PowerShell), follow the correct quote wrapping rules to prevent parse errors. For instance, in Windows PowerShell 5.x, use the --% stop-parsing symbol.
• Component selection rules: After fetching component lists, strictly avoid picking the first one randomly; decide based on user specification, unique availability, or user inquiry.
• Optional component rule: Without user permission, do not add components with required=false (e.g., floating zones, labels) on your own.
• Asset authorization management: Use scripts like scripts/grant-assets.mjs for cross-account asset authorization, but note that revocation is irreversible.

This skill is suitable for advertisers and operations teams needing efficient management of Tencent ad dynamic creatives, but ensure the environment is configured correctly (e.g., Node.js ≥ 20) and business rules are understood.