Multilingual campaigns
Multilang infrastructure: language→country matrix stored in Firestore (18 languages, 238 GAM countries), segmented deployment pipeline with corpus validation. Content generation is handled by your AI agent via MCP: OrbiAds provides the infrastructure, not a server-side translation engine.
REST endpoints
| Method | Path | Description | Credits |
|---|---|---|---|
| POST | /multilang/jobs | Create a multilang job (corpus provided by the agent) | 0.5 |
| GET | /multilang/jobs/{id} | Multilang job detail | 0 |
| GET | /multilang/templates | List multilingual templates | 0 |
| POST | /multilang/jobs/{id}/deploy | Deploy the job to GAM (creates 1 LI per language with geo targeting) | 5 |
MCP tools
| Tool | Description | Credits |
|---|---|---|
| settings | action="get_multilang_matrix": fetches the language→country matrix configured for a network | 0 |
Examples
Agent flow: read the matrix, then deploy
// Step 1 — the agent reads the matrix (OrbiAds)
{
"tool": "settings",
"arguments": {
"action": "get_multilang_matrix",
"network_id": "33047445"
}
}
// Step 2 — the agent generates the content (LLM, under user control)
// Step 3 — the agent deploys through the multilang pipeline
{
"tool": "multilang_deploy",
"arguments": {
"job_id": "mlj_7f3a9b2e",
"corpus": [
{"lang": "fr", "headline": "Soldes été Acme", "body": "...", "cta": "Voir les offres"},
{"lang": "en", "headline": "Acme Summer Sale", "body": "...", "cta": "Shop now"}
]
}
}Notes
- • The AI translation engine is NOT embedded server-side in OrbiAds: your LLM agent generates the content language by language.
- • OrbiAds stores the language→country matrix in Firestore (collection multilangMatrices) and exposes the presets via MCP.
- • Corpus constraints: headline max 90 characters, body max 150, CTA max 25. Strict validation before any GAM call (CORPUS_INVALID_SCHEMA).
- • 18 supported languages (fr, en, de, es, it, pt, nl, ja, zh, ar, ru, ko, pl, sv, da, fi, nb, tr).
- • The pipeline creates one line item per language with the geo targeting of the countries associated in the matrix.