Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

Meta-Tools

Facebook- und Instagram-Kampagnen, Anzeigengruppen, Zielgruppen, Creatives, Lead-Formular-Ergebnisse und Reichweitenschätzungen.

Freigabe läuft — demnächst

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 Credits

Mit 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 Credits

Facebook + 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.

ParameterTypBeschreibung
levelOptionalcampaign | adset | ad—
daysOptionalinteger (1–1125)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
date_presetOptionaltoday | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_monthinstead of days/start_date/end_date
breakdownOptionalnone | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | regionplacement = publisher_platform + platform_position; device = impression_device
conversion_eventOptionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clickErgebnistyp für Conversions und CPA (Standard purchase)
campaign_idsOptionalarray<string>—
adset_idsOptionalarray<string>—
ad_idsOptionalarray<string>—
sort_byOptionalspend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc—
sort_orderOptionaldesc | asc—
min_spendOptionalnumber—
roas_belowOptionalnumber—
roas_aboveOptionalnumber—
cpa_aboveOptionalnumber—
cpa_belowOptionalnumber—
frequency_aboveOptionalnumber—
limitOptionalinteger (1–500)—
account_idOptionalstringoptional: 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 Credits

Leistungsstä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.

ParameterTypBeschreibung
placementOptionalstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (abgeglichen mit publisher_platform:platform_position)
metricOptionalroas | cpa | conversions | ctr | spend | revenue—
conversion_eventOptionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clickErgebnistyp für Conversions und CPA (Standard purchase)
daysOptionalinteger (1–1125)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
limitOptionalinteger (1–25)—
min_spendOptionalnumber—
campaign_idsOptionalarray<string>—
account_idOptionalstringoptional: 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 Credits

Custom und Lookalike Audiences des Meta-Werbekontos: id, Name, Untertyp, ungefähre Größenspanne, Aufbewahrung, Auslieferungsstatus.

ParameterTypBeschreibung
account_idOptionalstringoptional: 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 Credits

Durchsucht Metas Interessen-Taxonomie (Targeting-Suche) nach Stichwort: Interessen-id, Name, Pfad und Zielgruppen-Größenspanne. Die ids in targeting.interest_ids verwenden.

ParameterTypBeschreibung
queryOptionalstring—
limitOptionalinteger (1–100)—
localeOptionalstringz. B. tr_TR, en_US
kindOptionalinterest | behavior | life_event | industry | family_status | income | demographicinterest (default) or a detailed-targeting category
category_classOptionalstringraw adTargetingCategory class, overrides kind
account_idOptionalstringoptional: 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 Credits

Geschä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.

ParameterTypBeschreibung
targetingPflichtobject—
optimization_goalOptionalstringREACH (Standard), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idOptionalstring—
custom_event_typeOptionalstringz. B. PURCHASE (mit pixel_id)
account_idOptionalstringoptional: 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 Credits

Meta-Anzeigengruppen mit Status, Tages-/Laufzeitbudget (Kontowährung), Gebot, Optimierungsziel, Targeting und Zeitplan.

ParameterTypBeschreibung
campaign_idOptionalstring—
adset_idsOptionalarray<string>—
account_idOptionalstringoptional: 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 Credits

Aktuelle Instagram-Beiträge des verbundenen Instagram-Unternehmenskontos mit Likes, Kommentaren und Interaktion, sortiert nach Interaktion — zur Auswahl eines Beitrags zum Bewerben.

ParameterTypBeschreibung
instagram_user_idOptionalstring—
limitOptionalinteger (1–100)—
sort_byOptionalengagement | recent—

list_meta_conversations

Lesen1 Credits

Messenger 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.

ParameterTypBeschreibung
page_idOptionalstring—
platformOptionalmessenger | instagram—
limitOptionalinteger (1–50)—
account_idOptionalstringoptional: 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 Credits

Lead-Formulare (Instant Forms) der Facebook-Seite mit Status und Lead-Anzahl. Das Erstellen neuer Lead-Formulare wird nicht unterstützt.

ParameterTypBeschreibung
page_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Lead-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.

ParameterTypBeschreibung
form_idPflichtstring—
page_idOptionalstring—
daysOptionalinteger (1–90)—
account_idOptionalstringoptional: 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 Credits

Produktkataloge der Meta-Unternehmen des Nutzers (Commerce Manager): ID, Name, Produktanzahl, Branche, Unternehmen. Erfordert catalog_management; connected=false, wenn Meta nicht verbunden ist.

ParameterTypBeschreibung
business_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Produkte 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.

ParameterTypBeschreibung
catalog_idPflichtstringMeta-Produktkatalog-ID (list_meta_catalogs)
queryOptionalstringName enthält
review_statusOptionalapproved | rejected | pending | outdated—
filterOptionalobjectGraph-Produktfilter, z. B. {"retailer_id": {"eq": "SKU1"}}
limitOptionalinteger (1–1000)—
account_idOptionalstringoptional: 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 Credits

Produktsets eines Meta-Katalogs (ID, Name, Produktanzahl, Filter) für Katalogverkaufs-Anzeigengruppen, plus die Produktfeeds des Katalogs mit dem Ergebnis des letzten Uploads. Nur lesend.

ParameterTypBeschreibung
catalog_idPflichtstringMeta-Produktkatalog-ID (list_meta_catalogs)
account_idOptionalstringoptional: 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 Credits

Facebook-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.

ParameterTypBeschreibung
promotable_onlyOptionalbooleannur Seiten, die das ausgewählte Werbekonto bewerben kann

list_meta_campaigns

Lesen1 Credits

Im Meta-Werbekonto vorhandene Kampagnen (auch außerhalb dieser App erstellte): ID, Name, Status, Ziel, Tages-/Laufzeitbudget in Kontowährung, Gebotsstrategie, Zeitplan. Nur lesend.

ParameterTypBeschreibung
effective_statusOptionalarray<string>z. B. ACTIVE, PAUSED
account_idOptionalstringoptional: 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 Credits

Meta-Anzeigen des Kontos, einer Anzeigengruppe oder einer Kampagne: ID, Name, Status, effektiver Status, Anzeigengruppe, Creative-ID und Vorschaubild. Nur lesend.

ParameterTypBeschreibung
adset_idOptionalstring—
campaign_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Neueste Beiträge einer Facebook-Seite mit Text, Bild und Permalink, um einen organischen Beitrag als Anzeige wiederzuverwenden (object_story_id). Nur lesend.

ParameterTypBeschreibung
page_idOptionalstring—
limitOptionalinteger (1–100)—

list_meta_pixels

Lesen1 Credits

Meta-Pixel (Datensätze) des Werbekontos mit Name und letztem Auslösezeitpunkt. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringoptional: 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 Credits

Freie 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.

ParameterTypBeschreibung
fieldsPflichtarray<string>Insights-Felder, z. B. spend, reach, actions, video_p75_watched_actions
levelOptionalaccount | campaign | adset | ad—
breakdownsOptionalarray<string>z. B. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone
action_breakdownsOptionalarray<string>z. B. action_type, action_device
daysOptionalinteger (1–1125)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
time_incrementOptionalstring1 = täglich, 7 = wöchentlich, monthly, all_days
filteringOptionalarray<object>Graph-Filter [{field, operator, value}]
limitOptionalinteger (1–5000)—
account_idOptionalstringoptional: 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 Credits

Fü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 Credits

Gespeicherte Zielgruppen (wiederverwendbare Targeting-Vorgaben aus dem Ads Manager) mit Targeting und ungefährer Größe. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringoptional: 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 Credits

Benutzerdefinierte Conversions des Werbekontos: ID, Name, Regel (URL / Ereignis), Ereignistyp, Pixel, zuletzt ausgelöst, Standardwert. Nur lesend.

ParameterTypBeschreibung
include_archivedOptionalboolean—
account_idOptionalstringoptional: 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 Credits

LIVE-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.

ParameterTypBeschreibung
campaign_idPflichtstringMeta-Kampagnen-ID (list_meta_campaigns) oder Tecrübe-Kampagnen-ID
account_idOptionalstringoptional: 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 Credits

Aktivitä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.

ParameterTypBeschreibung
sinceOptionalstringYYYY-MM-DD
untilOptionalstringYYYY-MM-DD
daysOptionalinteger (1–365)—
levelOptionalstringnach Objekttyp filtern: campaign | adset | ad | account …
limitOptionalinteger (1–1000)—
account_idOptionalstringoptional: 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 Credits

Metas 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.

ParameterTypBeschreibung
adset_idPflichtstring—
optimization_goalOptionalstring—
account_idOptionalstringoptional: 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 Credits

Rendert 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.

ParameterTypBeschreibung
creative_idOptionalstring—
ad_idOptionalstring—
ad_formatOptionalDESKTOP_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_idOptionalstringoptional: 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 Credits

Liest 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.

ParameterTypBeschreibung
ad_idPflichtstring—
account_idOptionalstringoptional: 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 Credits

Lö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.

ParameterTypBeschreibung
urlPflichtstring—
ig_user_idOptionalstring—

instagram_follower_growth

Lesen1 Credits

Tägliche neue Follower eines Instagram-Unternehmenskontos in den letzten bis zu 30 Tagen plus aktuelle Followerzahl, um Follower- und Profilbesuchskampagnen zu messen. Nur lesend.

ParameterTypBeschreibung
ig_user_idOptionalstring—
daysOptionalinteger (1–30)—

download_meta_leads

Lesen1 Credits

Lä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.

ParameterTypBeschreibung
form_idPflichtstring—
page_idOptionalstring—
limitOptionalinteger (1–2000)—
sinceOptionalstringYYYY-MM-DD
account_idOptionalstringoptional: 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 Credits

Drei 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.

ParameterTypBeschreibung
modeOptionalsuggest | validate | minimum_budget—
interest_idsOptionalarray<string>—
namesOptionalarray<string>—
limit_typeOptionalinterests | behaviors | income | life_events—
is_exclusionOptionalboolean—
bid_amountOptionalinteger—
account_idOptionalstringoptional: 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 Credits

Wählt, in welchem Meta-Werbekonto alle weiteren Meta-Tools arbeiten (Agentur / mehrere Konten). Nur Konten, auf die der Benutzer Zugriff hat, werden akzeptiert.

ParameterTypBeschreibung
account_idPflichtstring—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_meta_website_audience

Schreiben2 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
eventPflichtstringPixel-Event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysOptionalinteger (1–180)—
exclude_eventOptionalstringz. B. Purchase für Warenkorbabbrecher
pixel_idOptionalstring—
descriptionOptionalstring—
account_idOptionalstringoptional: 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 Credits

Erstellt eine Meta Lookalike Audience (1–10 %) einer Custom Audience in einem oder mehreren Ländern. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
namePflichtstring—
source_audience_idPflichtstring—
countriesPflichtarray<string>ISO-Codes
ratio_percentOptionalnumber (1–10)1 = die nächsten 1 %
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
objectivePflichtsales | traffic | engagement | messages | awareness—
daily_budgetOptionalnumberKontowährung
goalOptionalstring—
special_ad_categoriesOptionalarray<string>CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES
audienceOptionalobject—
account_idOptionalstringoptional: 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.

ParameterTypBeschreibung
campaign_idPflichtstringMeta-Kampagnen-id oder Tecrube-Kampagnen-id
daily_budgetOptionalnumberad account currency
lifetime_budgetOptionalnumber—
currencyOptionalstringoptional ISO check; must equal the ad account currency
statusOptionalACTIVE | PAUSED | ARCHIVED—
nameOptionalstring—
bid_strategyOptionalstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capOptionalnumber—
account_idOptionalstringoptional: 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.

ParameterTypBeschreibung
adset_idPflichtstring—
daily_budgetOptionalnumberad account currency
lifetime_budgetOptionalnumber—
currencyOptionalstringoptional ISO check; must equal the ad account currency
statusOptionalACTIVE | PAUSED | ARCHIVED—
nameOptionalstring—
bid_strategyOptionalstring—
bid_amountOptionalnumber—
targetingOptionalobject—
start_timeOptionalstringISO 8601
end_timeOptionalstringISO 8601
account_idOptionalstringoptional: 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 Credits

Dupliziert 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.

ParameterTypBeschreibung
adset_idPflichtstring—
interest_idsOptionalarray<string>Interessen ersetzen, restliches Targeting beibehalten
targetingOptionalobject—
daily_budgetOptionalnumber—
nameOptionalstring—
bid_amountOptionalnumber—
start_timeOptionalstring—
end_timeOptionalstring—
deep_copyOptionalboolean—
rename_suffixOptionalstring—
target_campaign_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Findet 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.

ParameterTypBeschreibung
cpa_thresholdPflichtnumberKontowährung
conversion_eventOptionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clickErgebnistyp für Conversions und CPA (Standard purchase)
daysOptionalinteger (1–1125)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
min_spendOptionalnumber—
campaign_idsOptionalarray<string>—
reallocateOptionalbooleandas Tagesbudget der pausierten Gruppen zur besten Anzeigengruppe verschieben (Standard true)
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
adset_idPflichtstring—
video_idOptionalstringVideo-id im Meta-Werbekonto
video_urlOptionalstringpublic https video URL; Meta fetches it (instead of video_id)
linkPflichtstring—
nameOptionalstring—
messageOptionalstring—
titleOptionalstring—
call_to_actionOptionalLEARN_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_urlOptionalstring—
page_idOptionalstring—
instagram_user_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Macht 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.

ParameterTypBeschreibung
adset_idPflichtstring—
instagram_media_idOptionalstring—
pick_bestOptionalbooleanden aktuellen Instagram-Beitrag mit der meisten Interaktion verwenden
lookback_postsOptionalinteger (1–100)—
facebook_post_idOptionalstring{page_id}_{post_id}, um stattdessen einen Seitenbeitrag zu bewerben
linkOptionalstring—
call_to_actionOptionalLEARN_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—
nameOptionalstring—
instagram_user_idOptionalstring—
page_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Fü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.

ParameterTypBeschreibung
catalog_idOptionalstringMeta-Produktkatalog-ID (list_meta_catalogs)
product_idOptionalstringvorhandene Meta-Produkt-ID zum Aktualisieren; weglassen zum Anlegen
retailer_idOptionalstring—
nameOptionalstring—
descriptionOptionalstring—
urlOptionalstring—
image_urlOptionalstring—
priceOptionalnumber—
sale_priceOptionalnumber—
currencyOptionalstringISO; Standard: Währung des Werbekontos
availabilityOptionalin stock | out of stock | preorder | available for order | discontinued—
conditionOptionalnew | refurbished | used—
brandOptionalstring—
categoryOptionalstring—
gtinOptionalstring—
colorOptionalstring—
sizeOptionalstring—
item_group_idOptionalstring—
custom_label_0Optionalstring—
visibilityOptionalpublished | staging—
custom_label_1Optionalstring—
custom_label_2Optionalstring—
custom_label_3Optionalstring—
custom_label_4Optionalstring—
genderOptionalstringfemale | male | unisex
materialOptionalstring—
patternOptionalstring—
product_typeOptionalstringseller's own category path
additional_image_urlsOptionalarray<string>extra product image URLs
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
catalog_idPflichtstringMeta-Produktkatalog-ID (list_meta_catalogs)
product_set_idPflichtstring—
daily_budgetOptionalnumberKontowährung
countriesOptionalarray<string>ISO-Codes, Standard TR
pixel_idOptionalstring—
goalOptionalstring—
audienceOptionalobject—
account_idOptionalstringoptional: 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 Credits

Ob 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.

ParameterTypBeschreibung
page_idOptionalstring—
subscribeOptionalbooleantrue = subscribe the Page now
account_idOptionalstringoptional: 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 Credits

Lö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.

ParameterTypBeschreibung
campaign_idPflichtstring—
account_idOptionalstringoptional: 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 Credits

Löscht eine Meta-Anzeigengruppe DAUERHAFT. Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden.

ParameterTypBeschreibung
adset_idPflichtstring—
account_idOptionalstringoptional: 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 Credits

Löscht eine Meta-Anzeige DAUERHAFT. Wartet immer auf ausdrückliche Freigabe und kann nicht rückgängig gemacht werden.

ParameterTypBeschreibung
ad_idPflichtstring—
account_idOptionalstringoptional: 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 Credits

Lö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.

ParameterTypBeschreibung
audience_idPflichtstring—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
campaign_idPflichtstring—
namePflichtstring—
optimization_goalOptionalLINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT—
billing_eventOptionalIMPRESSIONS | LINK_CLICKS | THRUPLAY—
daily_budgetOptionalnumberKontowährung
lifetime_budgetOptionalnumber—
bid_strategyOptionalstring—
bid_amountOptionalnumber—
targetingPflichtobject—
start_timeOptionalstringISO 8601
end_timeOptionalstringISO 8601
pixel_idOptionalstring—
custom_event_typeOptionalstring—
page_idOptionalstring—
destination_typeOptionalstringz. B. WEBSITE, MESSENGER, WHATSAPP, ON_AD
account_idOptionalstringoptional: 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 Credits

Dupliziert 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.

ParameterTypBeschreibung
kindPflichtcampaign | adset | ad—
entity_idPflichtstring—
deep_copyOptionalboolean—
rename_prefixOptionalstring—
rename_suffixOptionalstring—
target_parent_idOptionalstringKampagne für die Kopie einer Anzeigengruppe, Anzeigengruppe für die Kopie einer Anzeige
account_idOptionalstringoptional: 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 Credits

Erstellt in einer Katalogverkaufs-Anzeigengruppe eine dynamische Produktanzeige, die sich aus einem Katalog-Produktset füllt ({{product.name}}, {{product.price}}). Wird nach Freigabe pausiert erstellt.

ParameterTypBeschreibung
adset_idPflichtstring—
nameOptionalstring—
product_set_idPflichtstring—
messageOptionalstring—
descriptionOptionalstringVorlagentext, Standard {{product.price}}
call_to_actionOptionalLEARN_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_linkOptionalstring—
page_idOptionalstring—
instagram_user_idOptionalstring—
account_idOptionalstringoptional: 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 Credits

Pausiert, setzt fort, archiviert oder benennt eine einzelne Meta-Anzeige um. Vorschau mit vorher → nachher; erst nach Freigabe angewendet.

ParameterTypBeschreibung
ad_idPflichtstring—
statusOptionalACTIVE | PAUSED | ARCHIVED—
nameOptionalstring—
account_idOptionalstringoptional: 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 Credits

Ersetzt 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.

ParameterTypBeschreibung
ad_idPflichtstring—
messageOptionalstring—
headlineOptionalstring—
descriptionOptionalstring—
linkOptionalstring—
image_urlOptionalstringöffentliche https-Bild-URL oder Studio-Medien-URL
image_hashOptionalstringaus upload_meta_image
image_base64OptionalstringBase64-Bild, höchstens 5 MB
call_to_actionOptionalLEARN_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_idOptionalstring—
nameOptionalstringneuer Creative-Name
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
campaign_aPflichtstring—
campaign_bPflichtstring—
start_timePflichtstringISO 8601 (UTC ohne Offset)
end_timePflichtstringISO 8601
control_nameOptionalstring—
treatment_nameOptionalstring—
account_idOptionalstringoptional: 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 Credits

Markensicherheit 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.

ParameterTypBeschreibung
actionOptionalget | set—
age_minOptionalinteger (13–65)—
placement_exclusionsOptionalarray<string>auszuschließende Platzierungen: AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN
countriesOptionalarray<string>—
excluded_countriesOptionalarray<string>—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
catalog_idPflichtstring—
namePflichtstring—
filterOptionalobjectRegel, z. B. {"product_type": {"i_contains": "Hemd"}}; {} bedeutet alle Produkte
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
id_typeOptionalEMAIL | PHONE | EXTERN_ID—
identifiersPflichtarray<string>E-Mail-Adressen, Telefonnummern mit Ländervorwahl oder eigene Kunden-IDs; bereits SHA-256-gehashte Werte werden ebenfalls akzeptiert
descriptionOptionalstring—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
product_set_idPflichtstring—
eventOptionalstringViewContent | AddToCart | Purchase (Standard ViewContent)
exclude_eventOptionalstringStandard Purchase; für keinen Ausschluss leer lassen
retention_daysOptionalinteger (1–180)—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
pixel_idOptionalstring—
url_containsOptionalstring—
eventOptionalstringPixel-Ereignis, z. B. PageView, Purchase
custom_event_typeOptionalPURCHASE | 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_valueOptionalnumber—
account_idOptionalstringoptional: 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 Credits

Benennt eine benutzerdefinierte Meta-Conversion um oder ändert ihre Beschreibung / ihren Standardwert. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
conversion_idPflichtstring—
nameOptionalstring—
descriptionOptionalstring—
default_conversion_valueOptionalnumber—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
namePflichtstring—
sourcePflichtpage | instagram | lead_form—
source_idOptionalstring—
eventOptionalstringz. B. page_engaged, ig_business_profile_engaged, lead_generation_opened
retention_daysOptionalinteger (1–730)—
account_idOptionalstringoptional: 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 Credits

Erstellt 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.

ParameterTypBeschreibung
page_idOptionalstring—
namePflichtstring—
privacy_policy_urlPflichtstring—
questionsPflichtarray<object>—
follow_up_urlOptionalstring—
intro_headlineOptionalstring—
intro_descriptionOptionalstring—
thank_you_textOptionalstring—
localeOptionalstringz. B. tr_TR
higher_intentOptionalbooleanfügt einen Prüfschritt hinzu (Formular mit höherer Absicht)
account_idOptionalstringoptional: 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 Credits

Lä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.

ParameterTypBeschreibung
image_urlOptionalstringöffentliche https-Bild-URL oder Studio-Medien-URL
image_base64OptionalstringBase64-Bild, höchstens 5 MB
nameOptionalstring—
account_idOptionalstringoptional: 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 Credits

Fü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.

ParameterTypBeschreibung
video_urlPflichtstringöffentliche https-Video-URL; Meta ruft sie ab
nameOptionalstring—
account_idOptionalstringoptional: 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 Credits

Sendet 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.

ParameterTypBeschreibung
pixel_idOptionalstring—
event_namePflichtstring—
emailOptionalstring—
phoneOptionalstring—
external_idOptionalstring—
valueOptionalnumber—
currencyOptionalstring—
event_idOptionalstringmit dem Pixel geteilte Deduplizierungs-ID
event_source_urlOptionalstring—
action_sourceOptionalwebsite | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other—
fbcOptionalstring—
fbpOptionalstring—
test_event_codeOptionalstring—
account_idOptionalstringoptional: 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 Credits

Create 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.

ParameterTypBeschreibung
namePflichtstringaccount name, e.g. “Acme Ads”
currencyPflichtstringpermanent; Meta-supported ISO code (TRY, USD, EUR…)
business_idOptionalstringBusiness Manager id the account belongs to; required when the user has several
connection_idOptionalstringoptional: which Meta identity (connection) opens the account
forceOptionalbooleancreate even though this identity already has an ad account
account_idOptionalstringoptional: 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.