> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Meta Ads
> Annoncedata, performance, målgrupper og leads fra Facebook og Instagram: plus guardrailet oprettelse og styring af kampagner direkte fra din AI.
**På vej.** Meta Ads er annonceret og vises i Marketplace, men kan **endnu ikke
købes**. Prisen og funktionerne nedenfor beskriver connectoren, som den bliver,
når selvbetjent køb åbner. Vil du være klar fra dag ét, så skriv til support.
Meta Ads-connectoren giver din AI adgang til dine annoncer på Facebook og
Instagram (Marketing API): kampagne-, annoncesæt- og annonce-performance,
konverteringer, rækkevidde, video-engagement, målgrupper, pixels og Lead Ads.
Den kan derudover **oprette og styre kampagner for dig** bag tydelige
sikkerhedsspærrer. Du godkender Consile-appen via Facebook-login, og din AI ser
aldrig selve adgangstokenet.
**Read + guardrailet skrivning.** Læsning er ren GET. De tre opret-værktøjer
laver som standard nye objekter **sat på pause** (`PAUSED`); at oprette som
`ACTIVE`, ændre budget, aktivere eller arkivere kræver din eksplicitte
bekræftelse (`confirm: true`). Se
[Handlinger & guardrails](/essentials/handlinger-og-guardrails).
Read + guardrailed write
Meta-login (OAuth)
Hostet i EU · Frankfurt
* **Pris ved lancering:** 299 kr/md ekskl. moms (373,75 kr inkl. moms) pr. forbundet Meta-login, opsig når som helst.
* **Flere konti:** du kan forbinde flere Meta-logins som separate instanser. Skriv til [support@consile.dk](mailto:support@consile.dk) for at få det sat op.
* **Endpoint:** `https://mcp.consile.ai/meta-ads/mcp` (din egen, navngivne connector i Claude).
## Forudsætninger
Når Meta Ads åbner for selvbetjent køb, aktiverer du connectoren i
[portalen](https://app.consile.ai). Se
[Tilkøb en connector](/portal/tilkoeb-connector).
Se [Forbind Claude](/connect/forbind-claude).
Log ind med Facebook og godkend Consile-appen til den annoncekonto, du vil
forbinde. Adgangen er en *long-lived* token (ca. 60 dage) uden `refresh_token`.
Consile forsøger at forny den automatisk tæt på udløb, men i praksis skal du
som regel re-godkende ca. hver 60. dag.
## Hvad kan den? (tools)
Du behøver ikke kende tool-navnene. Du spørger i naturligt sprog, og din AI
vælger og kalder selv det rigtige værktøj. Transporten navngiver hvert værktøj
som `meta-ads__` (fx `meta-ads__account_insights`); herunder vises de bare
navne for læsbarhed.
Connectoren stiller i alt **39 værktøjer** til rådighed: **34 read-only** (ren
læsning) og **5 guardrailede skrive-værktøjer**. Det første kald er altid
`list_ad_accounts`, så din AI finder `act_` til resten.
### Læsning (34 read-only)
**Konti & struktur**
| Tool | Hvad den gør |
| ----------------------------- | -------------------------------------------------------------------------- |
| `list_ad_accounts` | Annoncekonti loginet kan se: id, navn, status, valuta, tidszone |
| `get_account_info` | Én kontos profil: status, valuta, forbrug, spend\_cap, saldo, ejer |
| `get_account_billing_summary` | Forbrugsstatus: spend\_cap, forbrugt, saldo, prepay, min. dagsbudget |
| `list_campaigns` | Kampagner: navn, mål, status, budgetter, tidsplan (filtrér på status) |
| `list_ad_sets` | Annoncesæt: optimeringsmål, billing-event, bud, budgetter, tidsplan |
| `list_ads` | Annoncer: navn, status, tilknyttet creative, evt. scopet til ét annoncesæt |
**Creatives & assets**
| Tool | Hvad den gør |
| --------------------------------- | --------------------------------------------------------------------------- |
| `list_creatives` | Annonce-creatives på identitetsniveau: titel, body, CTA, thumbnails |
| `list_ad_creatives_detail` | Alle creatives med fuldt indhold (object\_story\_spec, link, UTM) til audit |
| `get_ad_creative` | Ét creative i fuld detalje: hvad annoncen siger, viser og linker til |
| `get_ad_creative_asset_feed_spec` | Varianterne i en dynamisk/fleksibel creative (billeder, tekster, CTA'er) |
| `get_ad_preview` | Forhåndsvisning af en eksisterende annonce i en valgt placering |
| `list_ad_images` | Kontoens billedbibliotek, slår et creatives image\_hash op til en URL |
**Performance & insights**
| Tool | Hvad den gør |
| ----------------------------------- | ------------------------------------------------------------------------------- |
| `account_insights` | Konto-overblik: impressions, reach, clicks, spend, ctr, cpc, cpm, frekvens |
| `campaign_insights` | Performance pr. kampagne (evt. scopet til én kampagne) |
| `ad_set_insights` | Performance pr. annoncesæt (evt. scopet til ét annoncesæt) |
| `ad_insights` | Performance pr. annonce, fineste granularitet |
| `insights_by_breakdown` | Opdelt på alder, køn, land, region, platform, placering eller enhed |
| `get_conversion_actions` | Konverteringer pr. action\_type (køb, lead, add\_to\_cart) + pris pr. handling |
| `get_reach_and_frequency` | Unik rækkevidde og frekvens (evt. som daglig tidsserie) |
| `get_video_metrics` | Video-funnel: afspilninger, % set, ThruPlay, gns. sete tid, pris pr. ThruPlay |
| `creative_asset_insights_breakdown` | Hvilken billede-/tekst-/CTA-variant der driver resultater i en dynamisk annonce |
**Sporing & konfiguration**
| Tool | Hvad den gør |
| ------------------------- | ---------------------------------------------------------------------------- |
| `list_pixels` | Meta-pixels/datasæt med sundhedsdata (sidst affyret, matching), kun metadata |
| `list_custom_conversions` | Brugerdefinerede konverteringer og deres regler: hvad tallene tæller |
**Målgrupper & planlægning**
| Tool | Hvad den gør |
| ---------------------------- | --------------------------------------------------------------------------------- |
| `list_custom_audiences` | Custom Audiences, **kun metadata** (Meta gemmer kun hashes; aldrig medlemmer) |
| `list_saved_audiences` | Gemte målgrupper med targeting-spec og læsbare sentence\_lines |
| `estimate_reach` | Estimeret målgruppestørrelse for en targeting-spec *før* forbrug (kun aggregeret) |
| `search_targeting_interests` | Søg i interesse-taksonomien efter fritekst (id, navn, størrelse, sti) |
**Audit & ændringslog**
| Tool | Hvad den gør |
| ------------------------- | --------------------------------------------------------------------------- |
| `list_account_activities` | Kontoens ændringslog: budgetændringer, status-skift, targeting, audit-trail |
| `list_automated_rules` | Automatiske annonceregler: triggere, filtre og hvilken handling de udfører |
**Leads (Lead Ads)**
| Tool | Hvad den gør |
| ----------------- | ----------------------------------------------------------------------- |
| `list_pages` | Facebook-sider loginet administrerer, første kald til leads-værktøjerne |
| `list_lead_forms` | Lead Ads-formularer på en side: navn, status, leads\_count |
| `list_leads` | Leads fanget af en formular inkl. field\_data (de indsendte svar) |
| `get_lead` | Ét lead i detalje |
`list_leads` og `get_lead` returnerer **persondata** (navn, e-mail, telefon
fra field\_data). Data hentes *read-through* og vises til din egen AI. Det
gemmes aldrig hos Consile.
**Avanceret**
| Tool | Hvad den gør |
| ------- | ---------------------------------------------------------------------------------------------------------------- |
| `query` | Læs en hvilken som helst Graph-node/-edge med et sikret sæt læse-parametre, read-only af konstruktion (GET-only) |
### Skrivning (5 guardrailede værktøjer)
Disse fem værktøjer er de eneste, der ændrer noget i din Meta-konto. De er alle
underlagt guardrail-modellen: **nye objekter oprettes som standard PAUSED** (at
oprette som ACTIVE kræver `confirm: true`), og alt der bruger penge (status →
ACTIVE), ændrer et budget eller arkiverer kræver `confirm: true`. Uden bekræftelse
får du kun en forhåndsvisning (dry-run), og der sendes intet til Meta.
| Tool | Hvad den gør | Kræver bekræftelse? |
| ----------------- | -------------------------------------------------------------------- | ---------------------------------------------------------- |
| `create_campaign` | Opretter en ny kampagne | Kun hvis du beder om ACTIVE ved oprettelse (ellers PAUSED) |
| `create_ad_set` | Opretter et annoncesæt med budget, targeting og optimeringsmål | Kun hvis ACTIVE (starter forbrug) |
| `create_ad` | Opretter en annonce fra et eksisterende creative | Kun hvis ACTIVE |
| `update_status` | Sætter kampagne/annoncesæt/annonce til PAUSED, ACTIVE eller ARCHIVED | Ja for ACTIVE (forbrug) og ARCHIVED; pause er altid sikker |
| `update_budget` | Ændrer dags- eller livstidsbudget | **Altid** (budgetændring) |
Fuld reference med argumenter, paginering, filtre, guardrail-felter og
returværdier for hver tool.
## Sådan virker guardrailen
Connectoren er platformens første med skrive-værktøjer, så sikkerheden er bygget
ind i selve connectoren som standardindstillinger, ikke en ubrydelig platform-spærre:
1. **Alt nyt oprettes sat på pause.** En ny kampagne, annoncesæt eller annonce
er som standard `PAUSED` og bruger ingen penge, før du beder om det.
2. **Penge, budget og arkivering kræver `confirm: true`.** At sætte noget i drift
(ACTIVE), ændre et budget/bud eller arkivere kræver, at din AI sender en
eksplicit bekræftelse. Uden den får du en struktureret forhåndsvisning af
*præcis* hvad der ville ske, og **intet** kald sendes til Meta.
3. **Ingen hård sletning.** Der findes ingen sletning. Fjernelse sker kun som
en arkivering (status-ændring), så intet forsvinder uigenkaldeligt.
I praksis viser din AI dig planen først (en forhåndsvisning fra det første kald),
og det er først det andet, bekræftede kald, der rører ved dit annoncebudget.
Læs hele bekræftelses-modellen, der gælder på tværs af alle skrive-connectors,
under [Handlinger & guardrails](/essentials/handlinger-og-guardrails).
## Prøv at spørge
> *"Vis kontoens performance de seneste 30 dage: forbrug, klik, CTR og CPC."*
> *"Hvilke kampagner havde den bedste pris pr. lead i sidste måned?"*
> *"Del de seneste 14 dage op på køn og alder."*
> *"Hvad siger og linker mine bedst præsterende annoncer til?"*
> *"Hvilken billed- og overskrift-variant driver flest resultater i den dynamiske annonce?"*
> *"Hvor mange ser videoen helt til ThruPlay?"*
> *"Hvor stor en målgruppe kan jeg nå i Danmark for 18-35-årige interesseret i løb?"*
> *"Hvilke custom audiences findes på kontoen, og hvor store er de cirka?"*
> *"Hvor mange leads har min seneste Lead Ads-formular fanget?"*
> *"Vis de nyeste leads med navn og e-mail."*
> *"Opret en kampagne 'Forår 2026' med mål OUTCOME\_LEADS, lad den stå på pause."*
> *"Sæt budgettet på annoncesæt 1234 op til 200 kr om dagen."* (du bliver bedt om at bekræfte)
> *"Aktivér kampagne 5678."* (du får en forhåndsvisning, og skal bekræfte før den starter forbrug)
Nævn gerne et datointerval (eller fx "sidste 7 dage") og en annoncekonto i
spørgsmålet, så bliver svaret præcist med det samme. Budgetter angives i
*minor units* af kontoens valuta (fx 20000 = 200,00 kr).
## Begrænsninger
* **Skrivning er guardrailet, ikke fri.** De fem skrive-værktøjer kan oprette og
styre kampagner, men kun bag bekræftelses-spærren ovenfor. Guardrailen er sikre
standardindstillinger i connectoren, ikke en absolut garanti. Se
[Handlinger & guardrails](/essentials/handlinger-og-guardrails).
* **Ingen sletning.** Objekter kan kun arkiveres, ikke slettes permanent.
* **Creatives bygges ikke fra bunden.** Annoncer oprettes fra et *eksisterende*
creative (fra `list_creatives`); upload af billeder/video er ikke understøttet i
denne version.
* **Målgrupper er kun metadata.** Custom Audiences returnerer aldrig medlemmer.
Meta gemmer kun hashes.
* **Token skal fornyes ca. hver 60. dag.** Meta udsteder ingen `refresh_token`.
Consile forsøger at re-veksle tokenet automatisk tæt på udløb, men i praksis skal
du som regel re-godkende Consile-appen ca. hver 60. dag. Hvis du tilbagekalder
adgangen i Meta, holder connectoren op med at virke og skal forbindes igen.
Virker noget ikke som forventet? Se [Fejlfinding](/troubleshooting).