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

Reddit-Ads-Tools

Reddit-Werbekonten, Kampagnen, Anzeigengruppen und Leistungsberichte; Status- und Budgetänderungen laufen über Vorschau und Freigabe und lassen sich rückgängig machen.

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-Tools11 Tools

list_reddit_ad_accounts

Lesen1 Credits

Über die verbundene Reddit-Anmeldung erreichbare Reddit Ads-Konten: account_id, Name, Währung, Freigabestatus und welches ausgewählt ist. Nur lesend; connected=false, wenn Reddit nicht verbunden ist.

Dieses Tool hat keine Parameter.

list_reddit_campaigns

Lesen1 Credits

Reddit Ads-Kampagnen des Kontos: ID, Name, Status, Ziel, wo das Budget liegt (Kampagne oder Anzeigengruppe), Tages- oder Gesamtbudget sowie Ausgaben, Impressionen, Klicks und Conversions der letzten N Tage (UTC, Kontowährung). Nur lesend; erfindet keine Zahlen.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–730)letzte N Tage; Standard 30
statusOptionalactive | paused | archived—

list_reddit_ad_groups

Lesen1 Credits

Reddit Ads-Anzeigengruppen des Kontos: ID, Name, Kampagne, Status, Tages- oder Gesamtbudget und Gebot. Dient dazu, die Anzeigengruppe zu finden, deren Budget geändert werden soll. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idOptionalstringnur die Anzeigengruppen dieser Kampagne

reddit_performance_report

Lesen1 Credits

Reddit Ads-Auslieferungsbericht nach Konto, Kampagne oder Anzeigengruppe: Ausgaben (Kontowährung), Impressionen, Klicks, wichtigste Conversions, CTR und CPC mit Summen, optional pro Tag. Datumsangaben sind in UTC; die Daten reichen 24 Monate zurück. Nur lesend; erfindet keine Zahlen.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–730)letzte N Tage; Standard 30
levelOptionalaccount | campaign | ad_group—
campaign_idOptionalstring—
ad_group_idOptionalstring—
start_dateOptionalstringYYYY-MM-DD (UTC); hat Vorrang vor days
end_dateOptionalstringYYYY-MM-DD (UTC)
by_dateOptionalbooleaneine Zeile pro Tag

list_reddit_ads

Lesen1 Credits

Reddit Ads-Anzeigen des Kontos: Status, Auslieferung, Ablehnungsgrund, Beitrags- und Vorschaulinks. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idOptionalstring—
ad_group_idOptionalstring—

reddit_details

Lesen1 Credits

Alle Details eines Reddit Ads-Objekts: Kampagne, Anzeigengruppe, Anzeige, Beitrag, Beitragsauftrag, Zielgruppe, Formular, Profil, Katalog, Feed, Produktset, Asset oder letzte Pixel-Auslösung. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
kindPflichtcampaign | ad_group | ad | post | structured_post | post_job | custom_audience | saved_audience | lead_gen_form | profile | product_catalog | product_feed | product_set | creative_asset | business | pixel_last_fired | upload—
idPflichtstring—

list_reddit_assets

Lesen1 Credits

Listet Reddit Ads-Kontoressourcen nach Art: Zahlungsmittel, Pixel, Profile, Apps, benutzerdefinierte und gespeicherte Zielgruppen, Formulare, Kataloge, Beiträge, Creative-Assets, Produkte, Feeds, Produktsets. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
kindPflichtstring—
profile_idOptionalstring—
catalog_idOptionalstring—
business_idOptionalstring—
funding_instrument_idOptionalstring—

reddit_forecast

Lesen1 Credits

Erstellt eine Reddit Ads-Zielgruppen- und Auslieferungsschätzung oder einen Gebotsvorschlag; nichts geht live. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
kindPflichtdelivery | bid—
configPflichtobjectobject as documented by the Reddit Ads API v3

reddit_account_history

Lesen1 Credits

Änderungsverlauf des Reddit Ads-Kontos im Zeitraum: wer was geändert hat. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–730)last N days; default 30
start_dateOptionalstring—
end_dateOptionalstring—

diagnose_reddit_delivery

Lesen1 Credits

Ermittelt, warum eine Reddit Ads-Kampagne nicht ausgeliefert wird: Kontofreigabe, Zahlungsmittel, Status von Kampagne, Gruppe und Anzeige, Ablehnungsgründe und fehlende Teile, nach Dringlichkeit. Nur lesend.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idOptionalstring—

Schreib-Tools18 Tools

update_reddit_campaign_status

Schreiben2 Credits

Pausiert oder aktiviert eine Reddit Ads-Kampagne. Wird auf Wunsch des Nutzers angewendet, im Prüfprotokoll erfasst und ist mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
statusPflichtpause | activate—

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

update_reddit_campaign_budget

Schreiben2 Credits

Legt das Tagesbudget einer Reddit Ads-Kampagne mit Kampagnenbudget-Optimierung fest (budget_level=campaign). Bei anderen Kampagnen liegt das Budget in den Anzeigengruppen: Verwenden Sie update_reddit_ad_group_budget. Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
daily_budgetPflichtnumberneues Tagesbudget in der Kontowährung

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

update_reddit_ad_group_budget

Schreiben2 Credits

Legt das Tagesbudget einer Reddit Ads-Anzeigengruppe fest (Kampagnen ohne Kampagnenbudget-Optimierung). Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
ad_group_idPflichtstring—
daily_budgetPflichtnumberneues Tagesbudget in der Kontowährung

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

create_reddit_campaign

Schreiben2 Credits

Erstellt eine Reddit Ads-Kampagne immer pausiert. Ein Budget hier aktiviert die Kampagnenbudget-Optimierung; sonst liegt es in den Anzeigengruppen. Rückgängig archiviert die Kampagne.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
namePflichtstring—
objectivePflichtapp_installs | brand_awareness | catalog_sales | clicks | conversions | impressions | lead_generation | sales | video_viewable_impressions—
daily_budgetOptionalnumbercampaign budget (enables campaign budget optimization), account currency
lifetime_budgetOptionalnumbercampaign lifetime budget, account currency
funding_instrument_idOptionalstring—
special_ad_categoriesOptionalarray<string>—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
spend_capOptionalnumberaccount currency
app_idOptionalstring—
view_through_conversion_typeOptionalstring—
invoice_labelOptionalstring—
conversion_pixel_idOptionalstring—
use_catalogOptionalboolean—
campaign_typeOptionalstringAUTOMATED for a Reddit Max campaign

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

update_reddit_campaign

Schreiben2 Credits

Aktualisiert eine Reddit Ads-Kampagne: Name, Zeitplan, Gebot, Zahlungsmittel, Ausgabenobergrenze oder Gesamtbudget (50 % pro Schritt). Tagesbudgets über update_reddit_campaign_budget. Mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
nameOptionalstring—
funding_instrument_idOptionalstring—
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumber—
spend_capOptionalnumber—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
invoice_labelOptionalstring—
objectiveOptionalstring—
use_catalogOptionalboolean—
lifetime_budgetOptionalnumber—

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

create_reddit_ad_group

Schreiben2 Credits

Erstellt eine pausierte Reddit Ads-Anzeigengruppe mit Targeting, Budget, Gebot, Zeitplan und Optimierungsziel. Targeting-IDs über reddit_targeting_search. Rückgängig archiviert die Gruppe.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
namePflichtstring—
targetingPflichtobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOptionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOptionalnumberaccount currency
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
app_idOptionalstring—
conversion_pixel_idOptionalstring—
view_through_conversion_typeOptionalstring—
product_set_idOptionalstring—
saved_audience_idOptionalstring—
shopping_targetingOptionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOptionalstring—
optimization_strategy_typeOptionalstring—
campaign_idPflichtstring—

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

update_reddit_ad_group

Schreiben2 Credits

Aktualisiert eine Reddit Ads-Anzeigengruppe: Name, Targeting, Gebot, Zeitplan, Pixel, Optimierungsziel, gespeicherte Zielgruppe oder Gesamtbudget. Tagesbudgets über update_reddit_ad_group_budget. Mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
nameOptionalstring—
targetingOptionalobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOptionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOptionalnumberaccount currency
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
app_idOptionalstring—
conversion_pixel_idOptionalstring—
view_through_conversion_typeOptionalstring—
product_set_idOptionalstring—
saved_audience_idOptionalstring—
shopping_targetingOptionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOptionalstring—
optimization_strategy_typeOptionalstring—
ad_group_idPflichtstring—

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

create_reddit_ad

Schreiben2 Credits

Erstellt eine pausierte Reddit Ads-Anzeige aus einem Beitrag (create_reddit_post), Katalog oder Reddit Max-Assets. App-Anzeigen brauchen click_url und app_store_id. Rückgängig archiviert die Anzeige.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
namePflichtstring—
post_idOptionalstringt3_ post id from create_reddit_post
profile_idOptionalstring—
click_urlOptionalstring—
click_url_query_parametersOptionalarray<object>—
event_trackersOptionalarray<object>—
productsOptionalarray<object>—
shopping_creativeOptionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOptionalarray<object>—
thumbnail_asset_identifiersOptionalarray<object>—
destinationOptionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOptionalstring—
enhancementsOptionalobjectobject as documented by the Reddit Ads API v3
app_store_idOptionalstring—
ad_typeOptionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_group_idPflichtstring—

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

update_reddit_ad

Schreiben2 Credits

Aktualisiert eine Reddit Ads-Anzeige: Name, Beitrag, Klick-URL, Abfrageparameter, Tracker oder Ziel. Mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
nameOptionalstring—
post_idOptionalstringt3_ post id from create_reddit_post
profile_idOptionalstring—
click_urlOptionalstring—
click_url_query_parametersOptionalarray<object>—
event_trackersOptionalarray<object>—
productsOptionalarray<object>—
shopping_creativeOptionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOptionalarray<object>—
thumbnail_asset_identifiersOptionalarray<object>—
destinationOptionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOptionalstring—
enhancementsOptionalobjectobject as documented by the Reddit Ads API v3
app_store_idOptionalstring—
ad_typeOptionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_idPflichtstring—

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

reddit_status

SchreibenUnumkehrbar2 Credits

Pausiert, aktiviert oder archiviert eine Reddit Ads-Kampagne, -Anzeigengruppe oder -Anzeige. Pausieren und Aktivieren sind umkehrbar; Archivieren nicht, daher vorher beim Nutzer bestätigen.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
levelPflichtcampaign | ad_group | ad—
idPflichtstring—
statusPflichtpause | activate | archive—

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

create_reddit_post

Schreiben2 Credits

Erstellt einen Reddit-Anzeigenbeitrag aus öffentlichen Bild- oder Video-URLs oder als Text. Läuft im Hintergrund: mit reddit_details(kind=post_job) prüfen, post_id in create_reddit_ad verwenden. Nicht umkehrbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
typeOptionalimage | video | text—
headlineOptionalstring—
bodyOptionalstring—
image_urlOptionalstring—
video_urlOptionalstring—
thumbnail_urlOptionalstring—
destination_urlOptionalstring—
display_urlOptionalstring—
call_to_actionOptionalApply Now | Contact Us | Download | Get a Quote | Get Showtimes | Install | Learn More | Order Now | Play Now | Pre-order Now | See Menu | Shop Now | Sign Up | View More | Watch Now—
supplementary_textOptionalstring—
allow_commentsOptionalboolean—
profile_idOptionalstring—
creativeOptionalobjectraw creative for CAROUSEL or PROMOTED_POST

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

upload_reddit_creative_assets

Schreiben2 Credits

Lädt Creative-Assets für Reddit Max-Anzeigen (Bilder, Videos, Texte, Handlungsaufrufe) in ein Profil hoch. Status über reddit_details(kind=upload). Nicht umkehrbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
profile_idOptionalstring—
itemsPflichtarray<object>—

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

manage_reddit_custom_audience

SchreibenUnumkehrbar2 Credits

Erstellt benutzerdefinierte Reddit-Zielgruppen (Kundenliste, Website-Retargeting, Interaktion), fügt Nutzer per E-Mail hinzu oder entfernt sie, oder löscht eine Zielgruppe. E-Mails werden gehasht gespeichert und gesendet; Löschen ist nicht umkehrbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
actionPflichtcreate_customer_list | create_pixel | create_engagement | add_users | remove_users | delete—
nameOptionalstring—
audience_idOptionalstring—
configOptionalobjectobject as documented by the Reddit Ads API v3
emailsOptionalarray<string>plain or SHA-256; hashed before storing or sending

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

manage_reddit_saved_audience

Schreiben2 Credits

Erstellt eine gespeicherte Reddit-Zielgruppe aus dem Targeting oder aktualisiert sie mit saved_audience_id; in Anzeigengruppen über saved_audience_id nutzbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
saved_audience_idOptionalstring—
nameOptionalstring—
targetingOptionalobjectobject as documented by the Reddit Ads API v3

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

create_reddit_lead_gen_form

Schreiben2 Credits

Erstellt ein Reddit-Lead-Formular mit Datenschutzlink und Fragen. Nicht umkehrbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
namePflichtstring—
privacy_linkPflichtstring—
promptOptionalstring—
questionsPflichtarray<object>{type: EMAIL | FIRST_NAME | LAST_NAME | PHONE_NUMBER | POSTAL_CODE | JOB_TITLE | COMPANY | COMPANY_EMAIL, required}

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

send_reddit_conversion_events

Schreiben2 Credits

Sendet serverseitige Conversion-Ereignisse an ein Reddit-Pixel (Conversions API). Tests mit test_id. Senden ist nicht umkehrbar; Inhalte werden nicht gespeichert.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
pixel_idPflichtstring—
eventsPflichtarray<object>{event_at, action_source, type: {tracking_type}, click_id, user, metadata}
test_idOptionalstringsend as a test

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

manage_reddit_catalog

SchreibenUnumkehrbar2 Credits

Verwaltet Reddit-Produktkataloge, Feeds, Produktsets und Produkte: erstellen, aktualisieren, löschen, Massenimport. Löschen ist nicht umkehrbar. Passwortgeschützte Feeds in Reddit Ads hinzufügen.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
actionPflichtcreate_catalog | update_catalog | delete_catalog | create_feed | update_feed | delete_feed | create_set | update_set | delete_set | upsert_products | delete_products—
business_idOptionalstring—
catalog_idOptionalstring—
feed_idOptionalstring—
set_idOptionalstring—
bodyOptionalanyfields as documented by the Reddit Ads API v3

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

update_reddit_account

Schreiben2 Credits

Ändert Reddit-Werbekontoeinstellungen: Name, Attributionsfenster, kontoweit ausgeschlossene Communities und Keywords. Mit undo_action rückgängig machbar.

ParameterTypBeschreibung
account_idOptionalstringReddit-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
nameOptionalstring—
attribution_typeOptionalstring—
app_attribution_typeOptionalstring—
click_attribution_windowOptionalinteger—
view_attribution_windowOptionalinteger—
app_click_attribution_windowOptionalinteger—
app_view_attribution_windowOptionalinteger—
excluded_communitiesOptionalarray<string>—
excluded_keywordsOptionalarray<string>—

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