Tencent Advertiser Account Management

Problem Background and Needs

In Tencent advertising campaigns, advertisers often need to manage multiple bidding ad accounts, such as querying account information, adjusting daily budgets, or monitoring fund statuses. Manual operations for these tasks are tedious and may introduce errors in batch processing. Traditional methods rely on web interfaces, lacking scripting support and making integration into automated workflows difficult.

Core Capabilities and Workflow

This skill provides the following core capabilities by calling Tencent advertising APIs via Node.js scripts:

• Querying advertiser account lists: Using the get-account-list.mjs script, based on bidding advertiser accounts associated with the current user, supporting fuzzy search by company name (up to 2 keywords, length 2~50 characters) and pagination (default 10 per page, total page limit of 13000).
• Daily budget management: Query daily budgets with get-daily-budget.mjs and modify them using update-daily-budget.mjs, with optional parameters like use_min_daily_budget to control minimum budget rules.
• Fund account information queries: get-funds.mjs queries balances, locked amounts, and daily consumption for various fund accounts, while get-wallet.mjs retrieves shared wallet information (balance, bound accounts, etc.), both requiring account_id.
• Daily balance reports and wallet queries: get-daily-balance-report.mjs fetches daily settlement data (including daily closing balance) for fund accounts, and get-wallet-basic-info.mjs queries basic wallet information by wallet ID.

The workflow typically involves these steps:

1. Environment setup: Install tencentads-cli (Node.js ≥ 20) and configure the tencentads-auth skill to set API Key credentials.
2. Script execution: Run scripts from the skill root directory, for example, to query account lists:
   node scripts/get-account-list.mjs '{"corporation_name_fuzzy_list":["example company"]}'
   Note that JSON parameter passing must follow cross-platform rules (e.g., single quotes on Linux, double quotes with escaping on Windows CMD).
3. Result handling: Parse the JSON data returned by scripts for display or further operations.

Applicable Scenarios and Notes

This skill is suitable for automating the management of Tencent advertiser accounts, but note the following boundaries and limitations:

• Only supports bidding advertiser accounts: All scripts handle only bidding-type accounts, excluding agents or other account types.
• Pagination limit: When querying account lists, page * page_size must be ≤ 13000; exceeding this causes API errors.
• JSON parameter passing rules: Different terminals (e.g., Bash, CMD, PowerShell) have specific requirements for JSON quoting; incorrect passing leads to JSON.parse exceptions.
• Authentication dependency: All operations rely on credentials configured by tencentads-auth. If authentication errors occur, complete the authentication process first.
• Enum value queries: All enum values must not be guessed; they must be confirmed via get-enum-options.mjs.

The script-based interface requires familiarity with the Node.js environment and command-line operations for correct invocation.