Outils publicitaires
Trois outils pour chaque réseau publicitaire : trouver une opération, lire, changer. Ils marchent de la même façon sur Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads et ChatGPT Ads, sans limite propre à Pluggzy : seules les limites de débit de chaque réseau s’appliquent.
Outils
Exactement ce que votre app d’IA reçoit de tools/list. ads_write modifie votre compte publicitaire : tout ce qui peut dépenser ou donner un accès demande d’abord l’accord de l’utilisateur.
Finds ads operations for Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads (campaigns, budgets, boosts, targeting, audiences, conversions, creatives, leads, insights…) by words or group; with operation, its parameters and body.
operationstringquerystringgroupstring{ "structuredContent": { "operations": [ { "name": "update_ad_campaign_status", "summary": "Pause or resume a campaign", "kind": "write", "needs_user_confirmed": true }, { "name": "bulk_update_ad_campaign_status", "summary": "Pause or resume many campaigns", "kind": "write", "needs_user_confirmed": true } ] }, "content": [ { "type": "text", "text": "2 operation(s)." } ] }
- Reçue09:41:02
- TraitéeAucun appel au réseau
Runs a read-only ads operation (see ads_operations): campaigns with spend and results, daily metrics, insights, audiences, leads. Money is in the account's currency.
accountstringaccount_id (list_accounts), when severaloperationstringobligatoireads_operationsparamsobjectbodyobject{ "structuredContent": { "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e", "provider": "metaads", "operation": "get_ads_timeline", "result": { "rows": [ { "date": "2026-11-16", "currency": "EUR", "spend": 112.4, "impressions": 18420, "clicks": 391, "ctr": 2.12, "conversions": 14 }, { "date": "2026-11-17", "currency": "EUR", "spend": 118.9, "impressions": 19105, "clicks": 402, "ctr": 2.1, "conversions": 16 } ] } }, "content": [ { "type": "text", "text": "Meta Ads: get_ads_timeline done." } ] }
- Reçue09:41:02
- Aucune limite propre à PluggzyUniquement celles de la régie
- Envoyée09:41:03
Runs an ads operation that changes the account (see ads_operations): create, boost, pause, budgets, targeting, deletions. needs_user_confirmed ones spend money or grant access: tell the user what will run (budget, dates, audience) and set user_confirmed only once they agree. New ads can go live at once: send a paused status to review first.
accountstringaccount_id (list_accounts), when severaloperationstringobligatoireads_operationsparamsobjectbodyobjectuser_confirmedboolean{ "structuredContent": { "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e", "provider": "metaads", "operation": "update_ad_campaign_status", "result": { "success": true, "campaignId": "120214455667788990", "status": "PAUSED" } }, "content": [ { "type": "text", "text": "Meta Ads: update_ad_campaign_status done." } ] }
- Reçue09:41:02
- Aucune limite propre à PluggzyUniquement celles de la régie
- Envoyée09:41:03
Erreurs
Chaque refus a un code que votre app d’IA sait traiter, et un message qui dit quoi faire.
Refus publicitaires
Rien n’est mis en file ni réessayé dans votre dos : votre app d’IA lit le code et le message, puis corrige l’appel ou vous demande.
confirmation_requiredads_write uniquement. L’opération peut dépenser de l’argent ou donner un accès et user_confirmed ne valait pas true. Dites à l’utilisateur ce qui va s’exécuter, puis rappelez.unsupportedL’opération ne marche pas sur le réseau de ce compte publicitaire (pas de boost sur Microsoft Ads ni ChatGPT Ads). Le message dit à quels réseaux elle s’applique.invalid_requestLe réseau a refusé l’appel : le message commence par son nom, et fields nomme les valeurs à corriger.not_foundAucune opération de ce nom : le message liste les plus proches.rate_limitedLe réseau lui-même a demandé de ralentir (sa propre limite de débit ; Pluggzy n’en a aucune sur les comptes publicitaires). retry_after_seconds est exactement l’attente demandée : rappelez ensuite.{ "error": "Meta Ads refused: the daily budget is below this ad account’s minimum.", "req_id": "req_7f3a9c21e4b8", "code": "invalid_request", "fields": { "budgetAmount": "below the ad account’s minimum daily budget" } }
cooldown et permission fonctionnent comme partout ailleurs dans Pluggzy.