Meta-Tools
Facebook- und Instagram-Kampagnen, Anzeigengruppen, Zielgruppen, Creatives, Lead-Formular-Ergebnisse und Reichweitenschätzungen.
Die Integration für diesen Kanal ist fertig; die Verbindung wird freigeschaltet, sobald die Plattform unsere Entwickler-App genehmigt. Bis dahin können keine Konten verbunden werden, und die auf dieser Seite beschriebenen Aktionen sind nicht verfügbar.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools32 Tools
list_meta_ad_accounts
Lesen1 CreditsMit dem verbundenen Meta-Token erreichbare Meta-Werbekonten: id (act_…), Name, Währung, Status, Zeitzone, Gesamtausgaben, Unternehmen und welches ausgewählt ist. Nur lesend; connected=false, wenn Meta nicht verknüpft ist.
Dieses Tool hat keine Parameter.
meta_insights_report
Lesen2 CreditsFacebook + Instagram-Leistung (Meta Insights) auf Kampagnen-, Anzeigengruppen- oder Anzeigenebene für einen Zeitraum, optional aufgeschlüsselt nach Alter, Geschlecht, Platzierung oder Gerät: Ausgaben, Impressionen, Reichweite, Frequenz, Klicks, CTR, CPM, CPC, Conversions, Umsatz, ROAS (purchase_roas) und CPA (cost_per_action_type). Nach jeder Kennzahl sortierbar und mit Schwellenwerten filterbar (z. B. roas_below=3 sortiert nach Ausgaben, cpa_above=40). Nur echte Daten.
| Parameter | Typ | Beschreibung |
|---|---|---|
levelOptional | campaign | adset | ad | — |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
date_presetOptional | today | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_month | instead of days/start_date/end_date |
breakdownOptional | none | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | region | placement = publisher_platform + platform_position; device = impression_device |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | Ergebnistyp für Conversions und CPA (Standard purchase) |
campaign_idsOptional | array<string> | — |
adset_idsOptional | array<string> | — |
ad_idsOptional | array<string> | — |
sort_byOptional | spend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc | — |
sort_orderOptional | desc | asc | — |
min_spendOptional | number | — |
roas_belowOptional | number | — |
roas_aboveOptional | number | — |
cpa_aboveOptional | number | — |
cpa_belowOptional | number | — |
frequency_aboveOptional | number | — |
limitOptional | integer (1–500) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_top_creatives
Lesen2 CreditsLeistungsstärkste Meta-Anzeigen (Creatives) in einer Platzierung wie Instagram Reels, sortiert nach ROAS, CPA, Conversions oder CTR, mit Creative-Details (Vorschaubild, Video, Instagram-Permalink) und ihren Anzeigengruppen-ids zum Duplizieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
placementOptional | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (abgeglichen mit publisher_platform:platform_position) |
metricOptional | roas | cpa | conversions | ctr | spend | revenue | — |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | Ergebnistyp für Conversions und CPA (Standard purchase) |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
limitOptional | integer (1–25) | — |
min_spendOptional | number | — |
campaign_idsOptional | array<string> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_audiences
Lesen1 CreditsCustom und Lookalike Audiences des Meta-Werbekontos: id, Name, Untertyp, ungefähre Größenspanne, Aufbewahrung, Auslieferungsstatus.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
search_meta_interests
Lesen1 CreditsDurchsucht Metas Interessen-Taxonomie (Targeting-Suche) nach Stichwort: Interessen-id, Name, Pfad und Zielgruppen-Größenspanne. Die ids in targeting.interest_ids verwenden.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryOptional | string | — |
limitOptional | integer (1–100) | — |
localeOptional | string | z. B. tr_TR, en_US |
kindOptional | interest | behavior | life_event | industry | family_status | income | demographic | interest (default) or a detailed-targeting category |
category_classOptional | string | raw adTargetingCategory class, overrides kind |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_reach_estimate
Lesen2 CreditsGeschätzte Zielgruppengröße für ein Targeting-Set vor dem Ausgeben (Meta-Auslieferungsschätzung, mit Rückfall auf die Reichweitenschätzung): Spanne monatlich aktiver Nutzer und tägliche Nutzer.
| Parameter | Typ | Beschreibung |
|---|---|---|
targetingPflicht | object | — |
optimization_goalOptional | string | REACH (Standard), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idOptional | string | — |
custom_event_typeOptional | string | z. B. PURCHASE (mit pixel_id) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ad_sets
Lesen1 CreditsMeta-Anzeigengruppen mit Status, Tages-/Laufzeitbudget (Kontowährung), Gebot, Optimierungsziel, Targeting und Zeitplan.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | — |
adset_idsOptional | array<string> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_posts
Lesen1 CreditsAktuelle Instagram-Beiträge des verbundenen Instagram-Unternehmenskontos mit Likes, Kommentaren und Interaktion, sortiert nach Interaktion — zur Auswahl eines Beitrags zum Bewerben.
| Parameter | Typ | Beschreibung |
|---|---|---|
instagram_user_idOptional | string | — |
limitOptional | integer (1–100) | — |
sort_byOptional | engagement | recent | — |
list_meta_conversations
Lesen1 CreditsMessenger or Instagram Direct conversations of the Facebook Page (and its linked Instagram account): participants, unread count, last message preview. Read only; reply with reply_customer.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
platformOptional | messenger | instagram | — |
limitOptional | integer (1–50) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_lead_forms
Lesen1 CreditsLead-Formulare (Instant Forms) der Facebook-Seite mit Status und Lead-Anzahl. Das Erstellen neuer Lead-Formulare wird nicht unterstützt.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_lead_form_summary
Lesen2 CreditsLead-Anzahl für ein Lead-Formular über die letzten N Tage, nach Tag, nach Anzeige und nach Plattform. Nur Zahlen; persönliche Antworten werden nie zurückgegeben.
| Parameter | Typ | Beschreibung |
|---|---|---|
form_idPflicht | string | — |
page_idOptional | string | — |
daysOptional | integer (1–90) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalogs
Lesen1 CreditsProduktkataloge der Meta-Unternehmen des Nutzers (Commerce Manager): ID, Name, Produktanzahl, Branche, Unternehmen. Erfordert catalog_management; connected=false, wenn Meta nicht verbunden ist.
| Parameter | Typ | Beschreibung |
|---|---|---|
business_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalog_products
Lesen1 CreditsProdukte eines Meta-Katalogs mit Händler-ID, Preis, Verfügbarkeit, Zustand, URL, Bild, Prüfstatus und Ablehnungsgründen; Filter nach Prüfstatus oder Graph-Filter. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
catalog_idPflicht | string | Meta-Produktkatalog-ID (list_meta_catalogs) |
queryOptional | string | Name enthält |
review_statusOptional | approved | rejected | pending | outdated | — |
filterOptional | object | Graph-Produktfilter, z. B. {"retailer_id": {"eq": "SKU1"}} |
limitOptional | integer (1–1000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_product_sets
Lesen1 CreditsProduktsets eines Meta-Katalogs (ID, Name, Produktanzahl, Filter) für Katalogverkaufs-Anzeigengruppen, plus die Produktfeeds des Katalogs mit dem Ergebnis des letzten Uploads. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
catalog_idPflicht | string | Meta-Produktkatalog-ID (list_meta_catalogs) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_pages
Lesen1 CreditsFacebook-Seiten, die der verbundene Meta-Nutzer verwaltet (ID, Name, Kategorie, Aufgaben, verknüpftes Instagram-Konto), oder mit promotable_only die Seiten, für die das Werbekonto werben kann. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
promotable_onlyOptional | boolean | nur Seiten, die das ausgewählte Werbekonto bewerben kann |
list_meta_campaigns
Lesen1 CreditsIm Meta-Werbekonto vorhandene Kampagnen (auch außerhalb dieser App erstellte): ID, Name, Status, Ziel, Tages-/Laufzeitbudget in Kontowährung, Gebotsstrategie, Zeitplan. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
effective_statusOptional | array<string> | z. B. ACTIVE, PAUSED |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ads
Lesen1 CreditsMeta-Anzeigen des Kontos, einer Anzeigengruppe oder einer Kampagne: ID, Name, Status, effektiver Status, Anzeigengruppe, Creative-ID und Vorschaubild. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idOptional | string | — |
campaign_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_page_posts
Lesen1 CreditsNeueste Beiträge einer Facebook-Seite mit Text, Bild und Permalink, um einen organischen Beitrag als Anzeige wiederzuverwenden (object_story_id). Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
limitOptional | integer (1–100) | — |
list_meta_pixels
Lesen1 CreditsMeta-Pixel (Datensätze) des Werbekontos mit Name und letztem Auslösezeitpunkt. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_insights_query
Lesen2 CreditsFreie Abfrage der Meta Insights API für alles, was die fertigen Berichte nicht abdecken: jedes Feld, jede Aufschlüsselung, Aktionsaufschlüsselung, jeder Filter und jedes Zeitintervall, das Meta unterstützt. Gibt Rohzeilen zurück. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
fieldsPflicht | array<string> | Insights-Felder, z. B. spend, reach, actions, video_p75_watched_actions |
levelOptional | account | campaign | adset | ad | — |
breakdownsOptional | array<string> | z. B. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone |
action_breakdownsOptional | array<string> | z. B. action_type, action_device |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
time_incrementOptional | string | 1 = täglich, 7 = wöchentlich, monthly, all_days |
filteringOptional | array<object> | Graph-Filter [{field, operator, value}] |
limitOptional | integer (1–5000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_accounts
Lesen1 CreditsFür Anzeigen nutzbare Instagram-Konten: die dem Werbekonto zugeordneten und die mit den Facebook-Seiten des Nutzers verknüpften (ID, Benutzername, Seite). Nur lesend.
Dieses Tool hat keine Parameter.
list_meta_saved_audiences
Lesen1 CreditsGespeicherte Zielgruppen (wiederverwendbare Targeting-Vorgaben aus dem Ads Manager) mit Targeting und ungefährer Größe. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_custom_conversions
Lesen1 CreditsBenutzerdefinierte Conversions des Werbekontos: ID, Name, Regel (URL / Ereignis), Ereignistyp, Pixel, zuletzt ausgelöst, Standardwert. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
include_archivedOptional | boolean | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
diagnose_meta_delivery
Lesen2 CreditsLIVE-Auslieferungsdiagnose einer Meta-Kampagne. Zuerst aufrufen, wenn der Nutzer einen Status oder eine Warnung meldet (keine Auslieferung, mit Problemen, Lernphase, eingeschränkt, abgelehnt). Liefert die Kampagne, ihre Anzeigengruppen und Anzeigen mit effektivem Status, die Probleme, die laut Meta die Auslieferung blockieren (issues_info: Ebene, Fehlercode, Zusammenfassung, Meldung), die Lernphase jeder Anzeigengruppe, Gebotsstrategie, Gebotsbetrag, Budget und Restbudget, das Prüfergebnis jeder Anzeige sowie eine Befundliste. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Meta-Kampagnen-ID (list_meta_campaigns) oder Tecrübe-Kampagnen-ID |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_change_history
Lesen2 CreditsAktivitätsverlauf des Meta-Werbekontos: wer hat was wann geändert (Budget, Status, Ausrichtung, Creative-Änderungen), mit alten/neuen Werten, wenn Meta sie liefert. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
sinceOptional | string | YYYY-MM-DD |
untilOptional | string | YYYY-MM-DD |
daysOptional | integer (1–365) | — |
levelOptional | string | nach Objekttyp filtern: campaign | adset | ad | account … |
limitOptional | integer (1–1000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_delivery_estimate
Lesen1 CreditsMetas Auslieferungsschätzung für die aktuelle Ausrichtung einer bestehenden Anzeigengruppe: erreichbare monatliche Nutzer, tägliche Nutzer und die Kurve der erwarteten Ergebnisse, ohne Ausgaben. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
optimization_goalOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
preview_meta_ad
Lesen1 CreditsRendert eine Vorschau eines Meta-Creatives oder einer Anzeige in einem Platzierungsformat (Feed, Story, Reels …), ohne zu veröffentlichen; gibt eine temporäre Vorschau-URL zurück. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
creative_idOptional | string | — |
ad_idOptional | string | — |
ad_formatOptional | DESKTOP_FEED_STANDARD | MOBILE_FEED_STANDARD | INSTAGRAM_STANDARD | INSTAGRAM_STORY | INSTAGRAM_REELS | FACEBOOK_STORY_MOBILE | FACEBOOK_REELS_MOBILE | RIGHT_COLUMN_STANDARD | MARKETPLACE_MOBILE | AUDIENCE_NETWORK_OUTSTREAM_VIDEO | MESSENGER_MOBILE_INBOX_MEDIA | INSTAGRAM_EXPLORE_GRID_HOME | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
get_meta_ad_creative
Lesen1 CreditsLiest das aktuelle Creative einer Anzeige: Anzeigentitel, Primärtext, Beschreibung, Bild oder Video, Button, Ziellink, Seiten-/Instagram-Identität und welche Advantage+-Creative-Funktionen aktiviert sind. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
find_instagram_media_id
Lesen1 CreditsLöst einen Instagram-Beitrags- oder Reel-Link in seine Medien-ID auf (für boost_instagram_post benötigt), indem die Medien des ausgewählten Instagram-Unternehmenskontos durchsucht werden. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
urlPflicht | string | — |
ig_user_idOptional | string | — |
instagram_follower_growth
Lesen1 CreditsTägliche neue Follower eines Instagram-Unternehmenskontos in den letzten bis zu 30 Tagen plus aktuelle Followerzahl, um Follower- und Profilbesuchskampagnen zu messen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ig_user_idOptional | string | — |
daysOptional | integer (1–30) | — |
download_meta_leads
Lesen1 CreditsLädt die über ein Meta-Sofortformular eingereichten Antworten herunter (jede Frage sowie Anzeige, Anzeigengruppe und Kampagne jedes Leads). Personenbezogene Daten: erfordert leads_retrieval; im Rahmen der Einwilligung des Formulars verarbeiten. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
form_idPflicht | string | — |
page_idOptional | string | — |
limitOptional | integer (1–2000) | — |
sinceOptional | string | YYYY-MM-DD |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_targeting_helper
Lesen1 CreditsDrei Hilfen beim Aufbau des Meta-Targetings: schlägt ähnliche Interessen vor, prüft, ob eine Interessen-ID oder ein Name noch nutzbar ist (eine Anzeigengruppe mit ungültigem Interesse wird abgelehnt), oder liest die Mindest-Tagesbudgets des Kontos. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
modeOptional | suggest | validate | minimum_budget | — |
interest_idsOptional | array<string> | — |
namesOptional | array<string> | — |
limit_typeOptional | interests | behaviors | income | life_events | — |
is_exclusionOptional | boolean | — |
bid_amountOptional | integer | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tools38 Tools
select_meta_ad_account
Schreiben1 CreditsWählt, in welchem Meta-Werbekonto alle weiteren Meta-Tools arbeiten (Agentur / mehrere Konten). Nur Konten, auf die der Benutzer Zugriff hat, werden akzeptiert.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_website_audience
Schreiben2 CreditsErstellt eine Website Custom Audience aus dem Meta-Pixel (z. B. in den letzten 30 Tagen in den Warenkorb gelegt, aber nicht gekauft). Zuerst Vorschau und Freigabe; die Zielgruppe füllt sich innerhalb von Stunden.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
eventPflicht | string | Pixel-Event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysOptional | integer (1–180) | — |
exclude_eventOptional | string | z. B. Purchase für Warenkorbabbrecher |
pixel_idOptional | string | — |
descriptionOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_lookalike_audience
Schreiben2 CreditsErstellt eine Meta Lookalike Audience (1–10 %) einer Custom Audience in einem oder mehreren Ländern. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
source_audience_idPflicht | string | — |
countriesPflicht | array<string> | ISO-Codes |
ratio_percentOptional | number (1–10) | 1 = die nächsten 1 % |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_campaign
Schreiben2 CreditsErstellt eine Meta-Kampagne durchgängig (Kampagne + Anzeigengruppe + Anzeige, wenn Seite und Creative vorhanden sind) als pausierten Entwurf mit Ziel, Tagesbudget und Targeting. Schreibt einen Ledger-Entwurf und ein Freigabeelement; erst nach der Freigabe an Meta gesendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
objectivePflicht | sales | traffic | engagement | messages | awareness | — |
daily_budgetOptional | number | Kontowährung |
goalOptional | string | — |
special_ad_categoriesOptional | array<string> | CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES |
audienceOptional | object | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_campaign
Schreiben2 CreditsÄndert Budget (täglich/Laufzeit), Status, Name, Gebotsstrategie oder Ausgabenlimit einer Meta-Kampagne. Vorschau mit Vorher → Nachher; Budgeterhöhungen über +50 % pro Schritt werden blockiert. Wird erst nach der Freigabe angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Meta-Kampagnen-id oder Tecrube-Kampagnen-id |
daily_budgetOptional | number | ad account currency |
lifetime_budgetOptional | number | — |
currencyOptional | string | optional ISO check; must equal the ad account currency |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
bid_strategyOptional | string | LOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS |
spend_capOptional | number | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_ad_set
Schreiben2 CreditsÄndert Budget, Status, Targeting (Standorte, Alter, Geschlecht, Interessen, Zielgruppen, Platzierungen), Gebot oder Zeitplan einer Meta-Anzeigengruppe. Zuerst Vorschau und Freigabe; die Budget-Schutzgrenze gilt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
daily_budgetOptional | number | ad account currency |
lifetime_budgetOptional | number | — |
currencyOptional | string | optional ISO check; must equal the ad account currency |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
bid_strategyOptional | string | — |
bid_amountOptional | number | — |
targetingOptional | object | — |
start_timeOptional | string | ISO 8601 |
end_timeOptional | string | ISO 8601 |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
duplicate_meta_ad_set
Schreiben2 CreditsDupliziert eine erfolgreiche Meta-Anzeigengruppe (mit ihren Anzeigen) als pausierte Kopie und gibt ihr für einen Test eine neue Interessen-Zielgruppe, ein neues Targeting oder Budget. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
interest_idsOptional | array<string> | Interessen ersetzen, restliches Targeting beibehalten |
targetingOptional | object | — |
daily_budgetOptional | number | — |
nameOptional | string | — |
bid_amountOptional | number | — |
start_timeOptional | string | — |
end_timeOptional | string | — |
deep_copyOptional | boolean | — |
rename_suffixOptional | string | — |
target_campaign_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
pause_meta_ad_sets_above_cpa
Schreiben2 CreditsFindet aktive Meta-Anzeigengruppen, deren CPA über einem Schwellenwert liegt (oder die mindestens den Schwellenwert ohne Ergebnisse ausgegeben haben), pausiert sie in einer Aktion und verschiebt ihr freigewordenes Tagesbudget innerhalb der +50 %-Schutzgrenze zur Anzeigengruppe mit dem besten CPA. Zeigt zuerst die Liste; wird erst nach der Freigabe angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
cpa_thresholdPflicht | number | Kontowährung |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | Ergebnistyp für Conversions und CPA (Standard purchase) |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
min_spendOptional | number | — |
campaign_idsOptional | array<string> | — |
reallocateOptional | boolean | das Tagesbudget der pausierten Gruppen zur besten Anzeigengruppe verschieben (Standard true) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_carousel_ad
Schreiben2 CreditsErstellt eine Meta-Karussellanzeige (2–10 Bildkarten, z. B. fünf Produktbilder) in einer Anzeigengruppe für Facebook und Instagram. Studio-Bilder werden zu Meta hochgeladen (adimages). Wird nach der Freigabe pausiert erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
nameOptional | string | — |
linkPflicht | string | — |
messageOptional | string | Primärtext |
cardsPflicht | array<object> | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
optimize_card_orderOptional | boolean | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_video_ad
Schreiben2 CreditsErstellt eine Meta-Videoanzeige aus einer vorhandenen Video-id in einer Anzeigengruppe (Vorschaubild wird aus dem Video übernommen, wenn nicht angegeben). Wird nach der Freigabe pausiert erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
video_idOptional | string | Video-id im Meta-Werbekonto |
video_urlOptional | string | public https video URL; Meta fetches it (instead of video_id) |
linkPflicht | string | — |
nameOptional | string | — |
messageOptional | string | — |
titleOptional | string | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
thumbnail_urlOptional | string | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
boost_instagram_post
Schreiben2 CreditsMacht aus einem vorhandenen Instagram-Beitrag (source_instagram_media_id) oder Facebook-Seitenbeitrag (object_story_id) eine Anzeige in einer Anzeigengruppe; pick_best wählt den aktuellen Instagram-Beitrag mit der meisten Interaktion. Zuerst Vorschau und Freigabe; wird pausiert erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
instagram_media_idOptional | string | — |
pick_bestOptional | boolean | den aktuellen Instagram-Beitrag mit der meisten Interaktion verwenden |
lookback_postsOptional | integer (1–100) | — |
facebook_post_idOptional | string | {page_id}_{post_id}, um stattdessen einen Seitenbeitrag zu bewerben |
linkOptional | string | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
nameOptional | string | — |
instagram_user_idOptional | string | — |
page_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upsert_meta_catalog_product
Schreiben2 CreditsFügt einem Meta-Katalog ein Produkt hinzu (POST /{catalog_id}/products; erfordert retailer_id, name, url, image_url, price, currency, availability) oder aktualisiert ein vorhandenes (POST /{product_id}). Zuerst Vorschau und Freigabe; erst nach Freigabe angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
catalog_idOptional | string | Meta-Produktkatalog-ID (list_meta_catalogs) |
product_idOptional | string | vorhandene Meta-Produkt-ID zum Aktualisieren; weglassen zum Anlegen |
retailer_idOptional | string | — |
nameOptional | string | — |
descriptionOptional | string | — |
urlOptional | string | — |
image_urlOptional | string | — |
priceOptional | number | — |
sale_priceOptional | number | — |
currencyOptional | string | ISO; Standard: Währung des Werbekontos |
availabilityOptional | in stock | out of stock | preorder | available for order | discontinued | — |
conditionOptional | new | refurbished | used | — |
brandOptional | string | — |
categoryOptional | string | — |
gtinOptional | string | — |
colorOptional | string | — |
sizeOptional | string | — |
item_group_idOptional | string | — |
custom_label_0Optional | string | — |
visibilityOptional | published | staging | — |
custom_label_1Optional | string | — |
custom_label_2Optional | string | — |
custom_label_3Optional | string | — |
custom_label_4Optional | string | — |
genderOptional | string | female | male | unisex |
materialOptional | string | — |
patternOptional | string | — |
product_typeOptional | string | seller's own category path |
additional_image_urlsOptional | array<string> | extra product image URLs |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_catalog_sales_campaign
Schreiben2 CreditsErstellt eine Meta-Katalogverkaufskampagne (Ziel OUTCOME_SALES mit promoted_object.product_catalog_id) und eine Anzeigengruppe, die ein Produktset bewirbt (promoted_object.product_set_id, Kaufoptimierung), als pausierten Entwurf. Schreibt einen Entwurf ins Register und einen Freigabeeintrag; an Meta erst nach Freigabe gesendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
catalog_idPflicht | string | Meta-Produktkatalog-ID (list_meta_catalogs) |
product_set_idPflicht | string | — |
daily_budgetOptional | number | Kontowährung |
countriesOptional | array<string> | ISO-Codes, Standard TR |
pixel_idOptional | string | — |
goalOptional | string | — |
audienceOptional | object | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
meta_page_subscription
Schreiben1 CreditsOb die Facebook-Seite den Webhook von Tecrübe abonniert hat und mit welchen Feldern (neue Messenger- / Instagram-Nachrichten und Lead-Formular-Antworten kommen nur dann an); subscribe=true richtet das Abonnement ein (wiederholbar). Erfordert pages_manage_metadata.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
subscribeOptional | boolean | true = subscribe the Page now |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_meta_campaign
SchreibenUnumkehrbar5 CreditsLöscht eine Meta-Kampagne DAUERHAFT (Berichte bleiben in Meta lesbar). Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden. Im Zweifel stattdessen pausieren.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_meta_adset
SchreibenUnumkehrbar5 CreditsLöscht eine Meta-Anzeigengruppe DAUERHAFT. Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_meta_ad
SchreibenUnumkehrbar5 CreditsLöscht eine Meta-Anzeige DAUERHAFT. Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_meta_audience
SchreibenUnumkehrbar5 CreditsLöscht eine benutzerdefinierte oder Lookalike-Zielgruppe von Meta DAUERHAFT (Duplikate, Fehler, Datenschutzanfragen). Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden.
| Parameter | Typ | Beschreibung |
|---|---|---|
audience_idPflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_adset
Schreiben5 CreditsErstellt in einer bestehenden Meta-Kampagne eine pausierte Anzeigengruppe mit Optimierungsziel, Budget, Gebot, Zeitplan, beworbenem Objekt und vollständigem Targeting (Standorte, demografische Merkmale, detailliertes Targeting, Zielgruppen, Platzierungen). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | — |
namePflicht | string | — |
optimization_goalOptional | LINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT | — |
billing_eventOptional | IMPRESSIONS | LINK_CLICKS | THRUPLAY | — |
daily_budgetOptional | number | Kontowährung |
lifetime_budgetOptional | number | — |
bid_strategyOptional | string | — |
bid_amountOptional | number | — |
targetingPflicht | object | — |
start_timeOptional | string | ISO 8601 |
end_timeOptional | string | ISO 8601 |
pixel_idOptional | string | — |
custom_event_typeOptional | string | — |
page_idOptional | string | — |
destination_typeOptional | string | z. B. WEBSITE, MESSENGER, WHATSAPP, ON_AD |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
copy_meta_entity
Schreiben5 CreditsDupliziert eine Meta-Kampagne, -Anzeigengruppe oder -Anzeige (Ads Manager 'Duplizieren'), optional mit untergeordneten Elementen und in ein anderes übergeordnetes Element; die Kopie ist immer pausiert. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
kindPflicht | campaign | adset | ad | — |
entity_idPflicht | string | — |
deep_copyOptional | boolean | — |
rename_prefixOptional | string | — |
rename_suffixOptional | string | — |
target_parent_idOptional | string | Kampagne für die Kopie einer Anzeigengruppe, Anzeigengruppe für die Kopie einer Anzeige |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_link_ad
Schreiben8 CreditsErstellt in einer Anzeigengruppe eine Meta-Linkanzeige mit einem Bild (Creative + Anzeige) aus einer Bild-URL, einem hochgeladenen Bild-Hash oder einem Base64-Bild, mit Primärtext, Anzeigentitel und Button. Wird nach Freigabe pausiert erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
nameOptional | string | — |
linkPflicht | string | — |
messageOptional | string | Primärtext |
headlineOptional | string | — |
descriptionOptional | string | — |
image_urlOptional | string | öffentliche https-Bild-URL oder Studio-Medien-URL |
image_hashOptional | string | aus upload_meta_image |
image_base64Optional | string | Base64-Bild, höchstens 5 MB |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_dynamic_ad
Schreiben8 CreditsErstellt in einer Katalogverkaufs-Anzeigengruppe eine dynamische Produktanzeige, die sich aus einem Katalog-Produktset füllt ({{product.name}}, {{product.price}}). Wird nach Freigabe pausiert erstellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
nameOptional | string | — |
product_set_idPflicht | string | — |
messageOptional | string | — |
descriptionOptional | string | Vorlagentext, Standard {{product.price}} |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
fallback_linkOptional | string | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_ad
Schreiben5 CreditsPausiert, setzt fort, archiviert oder benennt eine einzelne Meta-Anzeige um. Vorschau mit vorher → nachher; erst nach Freigabe angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_ad_creative
Schreiben5 CreditsErsetzt das Creative einer Link-Anzeige (Bild, Text, Link, Button), ohne die Anzeige zu löschen: Aus dem aktuellen Creative plus Ihren Änderungen wird ein neues erstellt und eingesetzt, sodass die Anzeige ihre ID und ihren Verlauf behält. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
messageOptional | string | — |
headlineOptional | string | — |
descriptionOptional | string | — |
linkOptional | string | — |
image_urlOptional | string | öffentliche https-Bild-URL oder Studio-Medien-URL |
image_hashOptional | string | aus upload_meta_image |
image_base64Optional | string | Base64-Bild, höchstens 5 MB |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
page_idOptional | string | — |
nameOptional | string | neuer Creative-Name |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_ab_test
Schreiben5 CreditsErstellt einen Meta-Split-Test, der zwei bestehende Kampagnen für einen Zeitraum 50/50 auf sich nicht überschneidenden Zielgruppen laufen lässt und einen fairen Gewinner meldet. Erfordert einen Business Manager. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
campaign_aPflicht | string | — |
campaign_bPflicht | string | — |
start_timePflicht | string | ISO 8601 (UTC ohne Offset) |
end_timePflicht | string | ISO 8601 |
control_nameOptional | string | — |
treatment_nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_meta_account_controls
Schreiben2 CreditsMarkensicherheit auf Kontoebene: liest oder setzt die Zielgruppen- und Platzierungsbeschränkungen, die ALLE Kampagnen des Meta-Werbekontos binden (Mindestalter, ausgeschlossene Länder, ausgeschlossene Platzierungen wie Audience Network oder Marketplace). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | get | set | — |
age_minOptional | integer (13–65) | — |
placement_exclusionsOptional | array<string> | auszuschließende Platzierungen: AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN |
countriesOptional | array<string> | — |
excluded_countriesOptional | array<string> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_product_set
Schreiben2 CreditsErstellt in einem Meta-Katalog ein regelbasiertes Produktset (Marke, Produkttyp, Preis, Verfügbarkeit, benutzerdefinierte Labels …), das als Produktset einer Katalogverkaufs-Anzeigengruppe dient. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
catalog_idPflicht | string | — |
namePflicht | string | — |
filterOptional | object | Regel, z. B. {"product_type": {"i_contains": "Hemd"}}; {} bedeutet alle Produkte |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_customer_file_audience
Schreiben5 CreditsErstellt aus einer Kundenliste eine benutzerdefinierte Meta-Zielgruppe (customaudiences + users). Die Werte werden in Tecrübe normalisiert und mit SHA-256 gehasht, bevor etwas gespeichert oder gesendet wird; die Vorschau zeigt nur Anzahlen. Das Werbekonto muss die Custom-Audience-Bedingungen akzeptiert haben. Zuerst Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
id_typeOptional | EMAIL | PHONE | EXTERN_ID | — |
identifiersPflicht | array<string> | E-Mail-Adressen, Telefonnummern mit Ländervorwahl oder eigene Kunden-IDs; bereits SHA-256-gehashte Werte werden ebenfalls akzeptiert |
descriptionOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_product_audience
Schreiben5 CreditsErstellt aus einem Katalog-Produktset eine Retargeting-Zielgruppe (z. B. in den letzten 30 Tagen ein Produkt angesehen, aber nicht gekauft). Wird als Zielgruppe einer Katalogverkaufs-Anzeigengruppe verwendet. Zuerst Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
product_set_idPflicht | string | — |
eventOptional | string | ViewContent | AddToCart | Purchase (Standard ViewContent) |
exclude_eventOptional | string | Standard Purchase; für keinen Ausschluss leer lassen |
retention_daysOptional | integer (1–180) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_pixel
Schreiben2 CreditsErstellt im Werbekonto ein neues Meta-Pixel (Datensatz) und gibt die pixel_id zurück, die auf der Website eingebaut wird. Prüfen Sie zuerst list_meta_pixels: Meta begrenzt die Anzahl der Pixel pro Konto. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_custom_conversion
Schreiben2 CreditsErstellt für ein Meta-Pixel eine benutzerdefinierte Conversion aus einer URL-Regel und/oder einem Ereignis (z. B. URL enthält /thank-you). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
pixel_idOptional | string | — |
url_containsOptional | string | — |
eventOptional | string | Pixel-Ereignis, z. B. PageView, Purchase |
custom_event_typeOptional | PURCHASE | LEAD | COMPLETE_REGISTRATION | ADD_TO_CART | INITIATED_CHECKOUT | ADD_PAYMENT_INFO | CONTENT_VIEW | SEARCH | ADD_TO_WISHLIST | CONTACT | SUBSCRIBE | START_TRIAL | SUBMIT_APPLICATION | SCHEDULE | OTHER | — |
default_conversion_valueOptional | number | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_custom_conversion
Schreiben2 CreditsBenennt eine benutzerdefinierte Meta-Conversion um oder ändert ihre Beschreibung / ihren Standardwert. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
conversion_idPflicht | string | — |
nameOptional | string | — |
descriptionOptional | string | — |
default_conversion_valueOptional | number | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_engagement_audience
Schreiben5 CreditsErstellt eine Meta-Retargeting-Zielgruppe aus Interaktionen mit einer Facebook-Seite, einem Instagram-Unternehmensprofil oder einem Lead-Formular (z. B. geöffnet, aber nicht abgeschickt). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
sourcePflicht | page | instagram | lead_form | — |
source_idOptional | string | — |
eventOptional | string | z. B. page_engaged, ig_business_profile_engaged, lead_generation_opened |
retention_daysOptional | integer (1–730) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_lead_form
Schreiben5 CreditsErstellt auf einer Facebook-Seite ein Sofortformular (Lead-Formular) mit Standard- und eigenen Fragen, Einleitung, Datenschutzrichtlinie und Dankesbildschirm; gibt die Formular-ID für eine Lead-Anzeige zurück. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
namePflicht | string | — |
privacy_policy_urlPflicht | string | — |
questionsPflicht | array<object> | — |
follow_up_urlOptional | string | — |
intro_headlineOptional | string | — |
intro_descriptionOptional | string | — |
thank_you_textOptional | string | — |
localeOptional | string | z. B. tr_TR |
higher_intentOptional | boolean | fügt einen Prüfschritt hinzu (Formular mit höherer Absicht) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_meta_image
Schreiben1 CreditsLädt ein Bild in die Bildbibliothek des Meta-Werbekontos hoch und liefert seinen image_hash zur Wiederverwendung in Anzeigen. Externe URLs werden nur aus dem öffentlichen Internet abgerufen. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
image_urlOptional | string | öffentliche https-Bild-URL oder Studio-Medien-URL |
image_base64Optional | string | Base64-Bild, höchstens 5 MB |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_meta_video
Schreiben3 CreditsFügt dem Meta-Werbekonto ein Video aus einer öffentlichen URL hinzu (Meta ruft es ab) und liefert seine video_id für create_meta_video_ad. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
video_urlPflicht | string | öffentliche https-Video-URL; Meta ruft sie ab |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
send_meta_conversion_event
Schreiben1 CreditsSendet ein serverseitiges Conversion-Ereignis an Meta (Conversions API), z. B. einen Offline- oder CRM-Verkauf. E-Mail, Telefon und externe ID werden vor dem Speichern oder Senden per SHA-256 gehasht. Verwenden Sie test_event_code, um zuerst im Events Manager zu prüfen. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
pixel_idOptional | string | — |
event_namePflicht | string | — |
emailOptional | string | — |
phoneOptional | string | — |
external_idOptional | string | — |
valueOptional | number | — |
currencyOptional | string | — |
event_idOptional | string | mit dem Pixel geteilte Deduplizierungs-ID |
event_source_urlOptional | string | — |
action_sourceOptional | website | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other | — |
fbcOptional | string | — |
fbpOptional | string | — |
test_event_codeOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_ad_account
SchreibenUnumkehrbar2 CreditsCreate a new Meta ad account under the user's Business Manager (for the user who has no ad account after OAuth). Needs a Business Manager (returns an honest note if none; lists them when there are several). Only call it when the user explicitly asked for it; the account is created at once and the connection is linked to it. Currency and time zone are permanent; a payment method must still be added in Business Manager.
Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | account name, e.g. “Acme Ads” |
currencyPflicht | string | permanent; Meta-supported ISO code (TRY, USD, EUR…) |
business_idOptional | string | Business Manager id the account belongs to; required when the user has several |
connection_idOptional | string | optional: which Meta identity (connection) opens the account |
forceOptional | boolean | create even though this identity already has an ad account |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.