Advertising · create_ad_campaign
Create ad campaign
Paused campaign on OpenAI Ads, Meta Ads or Google Ads.
- Price
- included
- Requirements
- OpenAI Ads or Meta Ads or Google Ads
- set it up in Settings → Integrations
- Human approval
- Yes, by default
- outside-facing write: a human validates
Input
| Field | Type | Description |
|---|---|---|
| platform * | openai_ads | meta_ads | google_ads | |
| name * | string | Nom lisible : « [Offre] — [Cible] — [Mois] ». |
| objective | traffic | conversions | leads | awareness | signups | traffic · conversions · leads · awareness · signups (défaut traffic). |
| landingUrl * | string | Page d'atterrissage (https). |
| dailyBudget | number | Budget quotidien en devise (ex. 20 = 20 €). |
| lifetimeBudget | number | Budget total en devise (Meta : exige endAt). |
| currency | string | Devise du compte publicitaire (défaut EUR). |
| startAt | string | Début (YYYY-MM-DD ou ISO). Défaut : au lancement. |
| endAt | string | Fin (YYYY-MM-DD ou ISO). |
| targeting | object | |
| ads * | array | |
| targetCpa | number | Coût par acquisition cible en devise (pilote les alertes de sync_ad_metrics). |
| maxBidCents | number | Enchère max CPC en centimes (optionnel). |
| missionId | string | Mission durable servie par cette campagne. |
| marketingCampaignId | string | Campagne marketing parapluie (plan_campaign) si elle existe. |
| notes | string | Hypothèse testée, segment, angle. |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"create_ad_campaign","input":{"platform":"openai_ads","name":"…","objective":"traffic","landingUrl":"…"}}'$
run({ "tool": "create_ad_campaign", "input": {"platform":"openai_ads","name":"…","objective":"traffic","landingUrl":"…"} })