Aller au contenu principal

Segmentation géo/audience

4 endpoints REST pour définir des segments géographiques, allouer des impressions et forecaster par pays.

Endpoints REST

MéthodePathDescriptionCrédits
POST/segmentedCréer une configuration de segmentation0
GET/segmentedLister les configurations de segmentation0
POST/segmented/importImporter une segmentation0
GET/jobs/{id}/segmentation/forecastForecast par segment0

Outils MCP

OutilDescriptionCrédits
create_segmented_campaignCréer une campagne segmentée par pays1
forecast_segmentsForecaster les impressions disponibles par segment0
list_geo_targetsLister les cibles géographiques GAM0

Exemples

Créer une segmentation géo

{
  "tool": "create_segmented_campaign",
  "arguments": {
    "segments": [
      {"code": "FR", "label": "France", "impressions": 50000},
      {"code": "DE", "label": "Allemagne", "impressions": 50000},
      {"code": "UK", "label": "Royaume-Uni", "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

  • Dimension actuelle : COUNTRY (codes ISO).
  • Le forecast interroge l'API GAM pour chaque segment individuellement.
  • Le corpus est validé : chaque langue doit avoir headline + body + CTA.
  • Maximum 20 langues par campagne segmentée.