Aller au contenu principal

Campaign Staging Draft

Créez un brouillon de campagne pré-deploy, prévisualisez son ExecutionPlan GAM, puis déployez avec un token de confirmation.

Endpoints REST

MéthodePathDescriptionCrédits
POST/api/jobsCréer un job campagne en staging draft0
GET/api/jobs/{id}Lire l'état du staging draft0
POST/api/jobs/{id}/deployment-planPrévisualiser le plan de déploiement0
POST/api/jobs/{id}/deployDéployer avec confirmation token5
GET/api/jobs/{id}/forecastLire le forecast disponible0

Outils MCP

OutilDescriptionCrédits
campaign(action='create_draft')Créer un staging draft de campagne avec TTL 7 jours0
campaign(action='deploy', dryRun=true)Preview deploy : mutations, coût, risques et token0
campaign(action='deploy', confirmationToken=...)Déployer le plan confirmé vers GAM5
campaign(action='read')Relire la projection live ou le draft selon l'état0

Exemples

Créer puis prévisualiser un draft

{
  "tool": "campaign",
  "arguments": { "action": "create_draft", "name": "Q3 Acme Corp" }
}
// -> { "jobId": "job_8b2a", "status": "draft", "expireAt": "2026-06-12T00:00:00Z" }

{
  "tool": "campaign",
  "arguments": { "action": "deploy", "jobId": "job_8b2a", "dryRun": true }
}
// -> { "executionPlan": { "mutations": [...], "estimatedCost": 5, "confirmationToken": "tok_9c3f" } }

Notes

  • Le staging draft sépare l'intention campagne de la mutation GAM.
  • Le token de confirmation est lié au plan et expire rapidement.
  • Sans token valide, le deploy confirmé est refusé.