Geo/audience segmentation
4 REST endpoints to define geographic segments, allocate impressions and forecast by country.
REST endpoints
| Method | Path | Description | Credits |
|---|---|---|---|
| POST | /segmented | Create a segmentation configuration | 0 |
| GET | /segmented | List segmentation configurations | 0 |
| POST | /segmented/import | Import a segmentation | 0 |
| GET | /jobs/{id}/segmentation/forecast | Forecast per segment | 0 |
MCP tools
| Tool | Description | Credits |
|---|---|---|
| create_segmented_campaign | Create a country-segmented campaign | 1 |
| forecast_segments | Forecast available impressions per segment | 0 |
| list_geo_targets | List GAM geo targets | 0 |
Examples
Create a geo segmentation
{
"tool": "create_segmented_campaign",
"arguments": {
"segments": [
{"code": "FR", "label": "France", "impressions": 50000},
{"code": "DE", "label": "Germany", "impressions": 50000},
{"code": "UK", "label": "United Kingdom", "impressions": 50000}
],
"corpus": {
"FR": {"headline": "Soldes d'été", "body": "Jusqu'à -30%", "cta": "Découvrir"},
"DE": {"headline": "Sommerschluss", "body": "Bis zu -30%", "cta": "Entdecken"},
"UK": {"headline": "Summer Sale", "body": "Up to 30% off", "cta": "Shop now"}
}
}
}Notes
- • Current dimension: COUNTRY (ISO codes).
- • The forecast queries the GAM API for each segment individually.
- • The corpus is validated: every language must have headline + body + CTA.
- • Maximum 20 languages per segmented campaign.