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

TikTok-Ads-Tools

Verwaltung von Kampagnen, Anzeigengruppen und Anzeigen, Video-/Bild-Upload, Zielgruppen und Leistungsberichte.

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

list_tiktok_advertisers

Lesen1 Credits

TikTok Werbekonten (Advertiser), die mit dem verbundenen TikTok Ads Token erreichbar sind: id, name, currency, timezone, status. Nur lesend; gibt connected=false zurück, wenn kein Konto verknüpft ist.

Dieses Tool hat keine Parameter.

list_tiktok_campaigns

Lesen1 Credits

TikTok Kampagnen des verbundenen Werbekontos: campaign_id, name, objective_type, budget, budget_mode, operation_status (ein / aus) und secondary_status (Auslieferungsstatus von TikTok). Verwenden Sie die campaign_id-Werte für die anderen tiktok-Tools.

ParameterTypBeschreibung
campaign_idsOptionalarray<string>—
statusOptionalSTATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALLFilter nach Primärstatus, z. B. STATUS_DELIVERY_OK, STATUS_DISABLE
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_ad_groups

Lesen1 Credits

TikTok Anzeigengruppen mit Budget, Gebot, Optimierungsziel, Targeting (Standorte, Alter, Geschlecht, Sprachen, Interessen, Zielgruppen), Platzierungen, Zeitplan und Tageszeit-Steuerung.

ParameterTypBeschreibung
campaign_idsOptionalarray<string>—
adgroup_idsOptionalarray<string>—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_ads

Lesen1 Credits

TikTok Anzeigen: ad_id, Name, Anzeigengruppe, Status (operation_status, secondary_status), Format, Text, video_id, Zielseite, Call-to-Action. Anzeigen, die die Prüfung nicht oder nur teilweise bestanden haben, enthalten zusätzlich review: den Prüfstatus von TikTok, die Ablehnungsgründe und den Vorschlag sowie die Platzierungen, Standorte und Altersgruppen, für die sie gesperrt sind.

ParameterTypBeschreibung
campaign_idsOptionalarray<string>—
adgroup_idsOptionalarray<string>—
ad_idsOptionalarray<string>—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_performance_report

Lesen2 Credits

TikTok Leistung nach Kampagne, Anzeigengruppe oder Anzeige für einen Zeitraum: Ausgaben, Impressionen, Klicks, CTR, CPM, CPC, Conversions, Kosten pro Conversion, Conversion-Rate, ROAS sofern verfügbar; optional tägliche Aufschlüsselung und Summen. Nur echte Daten; connected=false ohne Konto.

ParameterTypBeschreibung
levelOptionalcampaign | ad_group | ad—
daysOptionalinteger (1–365)—
start_dateOptionalstring—
end_dateOptionalstring—
dailyOptionalbooleaneine Zeile pro Tag (stat_time_day)
campaign_idsOptionalarray<string>—
adgroup_idsOptionalarray<string>—
ad_idsOptionalarray<string>—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_audiences

Lesen1 Credits

Benutzerdefinierte und Lookalike-Zielgruppen des TikTok Werbekontos: audience_id, Name, Typ, Größe (cover_num), Gültigkeit. Verwenden Sie audience_ids in update_tiktok_ad_group, um sie zuzuweisen.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_videos

Lesen1 Credits

Videos in der Asset-Bibliothek des TikTok Werbekontos: video_id, Dateiname, Dauer, Größe, Vorschau- und Cover-URLs. Verwenden Sie video_id in create_tiktok_ad oder create_tiktok_whatsapp_campaign; neue Videos von einer öffentlichen URL fügen Sie mit upload_tiktok_video hinzu.

ParameterTypBeschreibung
video_idsOptionalarray<string>—
limitOptionalinteger (1–500)newest first (default 500)
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

get_tiktok_video_cover

Lesen1 Credits

Vorgeschlagene Cover-Frames für ein Video aus der TikTok Bibliothek (file/video/suggestcover): id, Vorschau-URL (eine Stunde gültig), Größe. Laden Sie die gewählte URL mit upload_tiktok_image hoch, um sie als Anzeigencover zu verwenden (image_ids). Nur lesend.

ParameterTypBeschreibung
video_idPflichtstring—
countOptionalinteger (1–10)—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

search_tiktok_targeting

Lesen1 Credits

Wandelt Targeting-Namen in TikTok-IDs um: interest (tool/interest_category → interest_category_ids), behavior (tool/action_category → actions[].action_category_ids), interest_keyword (tool/interest_keyword/recommend → interest_keyword_ids), location (tool/targeting/search → location_ids / zipcode_ids, Städte und Provinzen), region (tool/region → für das Ziel ausrichtbare Länder). Nur lesend.

ParameterTypBeschreibung
typePflichtinterest | behavior | interest_keyword | location | region—
queryPflichtstringzu suchender Name, z. B. fashion, moda, Istanbul, Turkey
languageOptionalstringSprache der Namen für interest/behavior/interest_keyword, z. B. tr, en (Standard: Sprache der Unterhaltung)
objective_typeOptionalstringfür location/region: Kampagnenziel, Standard TRAFFIC; LEAD_GENERATION für WhatsApp-Anzeigen
promotion_typeOptionalstringfür location/region; Standard WEBSITE, oder LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE mit LEAD_GENERATION
placementsOptionalarray<string>Standard PLACEMENT_TIKTOK
region_codesOptionalarray<string>location: nach Ländercode filtern, z. B. TR
geo_typesOptionalarray<string>location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE
limitOptionalinteger (1–100)—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_identities

Lesen1 Credits

Anzeigenidentitäten des TikTok-Werbekontos (identity/get): identity_id, identity_type, Anzeigename, Benutzername und ob Beiträge abgerufen werden können. identity_id/identity_type an create_tiktok_ad oder list_tiktok_posts übergeben. Nur lesend.

ParameterTypBeschreibung
identity_typeOptionalCUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT—
identity_bc_idOptionalstringerforderlich bei BC_AUTH_TT
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_pixels

Lesen1 Credits

TikTok-Conversion-Pixel des Werbekontos (pixel/list): pixel_id, pixel_code, Name, Einrichtungsmodus und erfasste Ereignisse. Verwenden Sie pixel_id für Conversion-Anzeigengruppen und pixel_code für send_tiktok_conversion_event. Nur lesend.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_auto_messages

Lesen1 Credits

Vorlagen für Begrüßungsnachrichten von TikTok-Direktnachrichten-Anzeigen (creative/auto_message/get): auto_message_id, Titel, Begrüßung, vorgeschlagene Fragen und Prüfstatus. auto_message_id an create_tiktok_ad übergeben. Nur lesend.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_lead_forms

Lesen1 Credits

Sofort-Lead-Formulare des TikTok-Werbekontos (page/get, LEAD_GEN): page_id, Titel, Status, Erstellungs-/Aktualisierungs-/Veröffentlichungszeit und Vorschau-URL. Nur lesend.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

get_tiktok_lead_form_fields

Lesen1 Credits

Fragefelder eines TikTok-Sofort-Lead-Formulars (page/field/get): Feldschlüssel, Bezeichnungen und Typen sowie Formular-Metadaten, um gesammelte Lead-Antworten richtig zu lesen. Nur lesend.

ParameterTypBeschreibung
page_idPflichtstringSofortformular-ID aus list_tiktok_lead_forms
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

download_tiktok_leads

Lesen2 Credits

Lädt die von einem TikTok-Sofortformular oder einer Lead-Anzeige gesammelten Leads herunter (page/lead/task + page/lead/task/download; eine ZIP-Datei wird zu ihrer CSV entpackt). Startet die Download-Aufgabe, fragt sie einige Sekunden lang ab und liefert, sobald sie fertig ist, eine datenschutzfreundliche Zusammenfassung: Gesamtzahl der Zeilen, Fragennamen und die ersten Zeilen (limit, Standard 20) mit Lead-ID, Erstellungszeit, Anzeigen-, Anzeigengruppen-, Kampagnen- und Formular-IDs sowie MASKIERTEN Antworten (Namen auf Initialen gekürzt; E-Mails, Telefonnummern und IBANs maskiert). Die vollständige, unmaskierte CSV wird im privaten Dateibereich des Kontos gespeichert und nur als download_url zurückgegeben, ein signierter Link, der 15 Minuten gültig ist (die gespeicherte Datei wird 30 Tage aufbewahrt und danach gelöscht): Geben Sie den Link an den Nutzer weiter und fügen Sie den Dateiinhalt nie in den Chat ein; kann die Datei nicht gespeichert werden, kommt nur die maskierte Zusammenfassung zurück. Bereitet TikTok die Datei noch vor, wird task_id zurückgegeben: mit derselben page_id/ad_id und dieser task_id erneut aufrufen. region: wo die Anzeigen liefen (eu = EWR/Schweiz/UK, us, other). Nur Administratoren des Werbekontos können herunterladen. Personenbezogene Daten: nur im Rahmen der im Formular erteilten Einwilligung verwenden. Nur lesend.

ParameterTypBeschreibung
page_idOptionalstringSofortformular-ID aus list_tiktok_lead_forms (oder ad_id angeben)
ad_idOptionalstringID der Lead-Anzeige; lädt statt eines Formulars die Leads dieser Anzeige herunter
task_idOptionalstringAufgaben-ID aus einem früheren Aufruf, der noch RUNNING war
regionOptionaleu | us | otherwo die Anzeigen ausgerichtet waren: eu = EWR/Schweiz/UK, us = Vereinigte Staaten, other (Standard) = überall sonst
limitOptionalinteger (1–100)Zeilen in der maskierten Vorschau (Standard 20); die vollständige Liste gibt es nur in der Download-Datei
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_creative_portfolios

Lesen1 Credits

Creative-Portfolios des TikTok-Werbekontos (creative/portfolio/list): Portfolio-ID, Typ (Display-Karte, Download-Karte, Geschenkcode…), Vorschau-URL und Haupteinstellungen. Nur lesend.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_gmv_max_stores

Lesen1 Credits

Mit dem Werbekonto verknüpfte TikTok Shop-Stores (gmv_max/store/list) mit GMV Max-Verfügbarkeit, Status, Rolle, autorisierendem Business Center und ansprechbaren Regionen. Nur lesend.

ParameterTypBeschreibung
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_smart_plus

Lesen1 Credits

Smart+-(automatisierte) Kampagnen, Anzeigengruppen oder Anzeigen des TikTok-Werbekontos (smart_plus/*/get). Diese werden von list_tiktok_campaigns / _ad_groups / _ads nicht zurückgegeben. Nur lesend.

ParameterTypBeschreibung
levelOptionalcampaign | adgroup | adStandard campaign
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_posts

Lesen1 Credits

Organische TikTok-Beiträge einer verknüpften TikTok-Kontoidentität (identity/video/get), die als Spark Ads laufen können: tiktok_item_id, Text, Status, Dauer, Cover und Status der Anzeigenautorisierung. Nur lesend.

ParameterTypBeschreibung
identity_idPflichtstring—
identity_typeOptionalTT_USER | BC_AUTH_TT | AUTH_CODEStandard TT_USER
identity_bc_idOptionalstringerforderlich bei BC_AUTH_TT
limitOptionalinteger (1–100)Standard 20
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_recommendations

Lesen2 Credits

TikToks eigene Diagnosen und Vorschläge für Anzeigengruppen (tool/diagnosis/get): Creative-Ermüdung, Gebots- und Budgetvorschläge mit geschätzter Steigerung sowie Probleme beim Event-Tracking. Nur lesend; Umsetzung mit den Update-Tools.

ParameterTypBeschreibung
adgroup_idsOptionalarray<string>bis zu 20; Standard: TikTok wählt die Anzeigengruppen mit Diagnosen
issue_categoriesOptionalarray<string>CREATIVE | BID_AND_BUDGET | EVENT_TRACK
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_report_query

Lesen2 Credits

Freier TikTok-Bericht (report/integrated/get): alle unterstützten Metriken und Dimensionen, Berichtstyp, Datenebene, Zeitraum oder Gesamtlaufzeit und Filter. Die Zeilen werden genau so zurückgegeben, wie TikTok sie berechnet. Nur lesend.

ParameterTypBeschreibung
metricsPflichtarray<string>TikTok-Metriknamen, z. B. spend, impressions, clicks, conversion, complete_payment_roas
dimensionsPflichtarray<string>z. B. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age
report_typeOptionalBASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP—
data_levelOptionalstringz. B. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER
daysOptionalinteger (1–365)—
start_dateOptionalstring—
end_dateOptionalstring—
lifetimeOptionalbooleanGesamtwerte der Laufzeit statt eines Zeitraums
filteringOptionalarray<object>TikTok-Filter: [{field_name, filter_type, filter_value}]
limitOptionalinteger (1–5000)—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_business_centers

Lesen1 Credits

Mit dem verbundenen Token erreichbare TikTok Business Center (bc/get): bc_id, Name, Unternehmen, Status, Währung, Zeitzone und Ihre Rolle. Nur lesend.

Dieses Tool hat keine Parameter.

list_tiktok_bc_advertisers

Lesen1 Credits

Werbekonten in einem TikTok Business Center (bc/asset/get, ADVERTISER): Advertiser-ID, Name, Kontotyp, Ihre Rolle und Verifizierungsstatus. Nur lesend.

ParameterTypBeschreibung
bc_idOptionalstringBusiness Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht

list_tiktok_bc_pixels

Lesen1 Credits

In einem TikTok Business Center gehaltene Pixel (bc/asset/get, PIXEL) über seine Werbekonten hinweg. Nur lesend.

ParameterTypBeschreibung
bc_idOptionalstringBusiness Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht

list_tiktok_asset_groups

Lesen1 Credits

Asset-Gruppen eines TikTok Business Center (bc/asset_group/list): asset_group_id und Name. Nur lesend.

ParameterTypBeschreibung
bc_idOptionalstringBusiness Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht

tiktok_advertiser_qualification

Lesen1 Credits

Unternehmensqualifikationen in einem TikTok Business Center (bc/advertiser/qualification/get): Firmenname, Verifizierungsstatus, besitzendes Werbekonto, Anzahl verknüpfter Konten und Region. Nur lesend.

ParameterTypBeschreibung
bc_idOptionalstringBusiness-Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht
advertiser_idOptionalstringnur Qualifikationen dieses Werbekontos behalten
verifiedOptionalbooleannach verifiziert / nicht verifiziert filtern

tiktok_change_history

Lesen2 Credits

Aktivitätsprotokoll eines TikTok Business Centers (changelog/get): wann, welcher Aktivitätstyp, Bearbeiter-ID und Änderungstext, neueste zuerst. Nur lesend.

ParameterTypBeschreibung
bc_idOptionalstringBusiness-Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht
start_dateOptionalstringYYYY-MM-DD (UTC); Standard: letzte 7 Tage
end_dateOptionalstring—
daysOptionalinteger (1–365)—
activity_typeOptionalstringALL (Standard) | USER | ASSET | … wie von TikTok definiert
limitOptionalinteger (1–500)—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

Schreib-Tools24 Tools

select_tiktok_advertiser

Schreiben1 Credits

Choose which TikTok ad account (advertiser) all further TikTok reads and writes use. Per project: with a non-default project selected only that project's advertiser is saved; in the default project the connection's selection changes. Local setting; nothing is changed on TikTok. Switching is always allowed; adding another advertiser on the platform is subject to the plan's ads.accounts.max limit (error=entitlement body with next_plan and upgrade_url).

Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.

ParameterTypBeschreibung
advertiser_idPflichtstring—

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

upload_tiktok_video

Schreiben2 Credits

Lädt ein Video von einer öffentlichen URL in die Asset-Bibliothek des TikTok Werbekontos hoch (file/video/ad/upload, UPLOAD_BY_URL). Zuerst Vorschau und Freigabe; die neue video_id wird im Aktionsergebnis zurückgegeben.

ParameterTypBeschreibung
video_urlPflichtstringöffentliche http(s)-URL einer mp4/mov/mpeg/avi-Datei (für URL-Uploads idealerweise unter 10 MB)
file_nameOptionalstring1-100 Zeichen, eindeutig im Konto; Standard: Dateiname der URL + Zeitstempel
auto_fixOptionalbooleanTikTok niedrige Auflösung / falsches Seitenverhältnis erkennen und korrigieren lassen
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_image

Schreiben2 Credits

Lädt ein Bild (Bildanzeige oder Videocover) von einer öffentlichen URL in die TikTok Asset-Bibliothek hoch (file/image/ad/upload, UPLOAD_BY_URL). Zuerst Vorschau und Freigabe; die image_id wird im Aktionsergebnis zurückgegeben.

ParameterTypBeschreibung
image_urlPflichtstringöffentliche http(s)-URL eines JPG/PNG (max. 1440x2560 Pixel insgesamt)
file_nameOptionalstring1-100 Zeichen, eindeutig im Konto; Standard: Dateiname der URL + Zeitstempel
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_campaign

Schreiben2 Credits

Erstellt eine TikTok Kampagne durchgängig (Kampagne + Anzeigengruppe, optional die Anzeige) als pausierten Entwurf. Schreibt einen Ledger-Entwurf und öffnet ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit verbundenem Konto an TikTok gesendet.

ParameterTypBeschreibung
namePflichtstring—
objective_typePflichtTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetOptionalnumberKontowährung
budget_modeOptionalBUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE—
goalOptionalstring—
pixel_idOptionalstring—
sales_destinationOptionalWEBSITE | APP | WEB_AND_APP | TIKTOK_SHOPPRODUCT_SALES campaigns only
audienceOptionalobjectcountries (ISO-Liste), age_min, age_max, genders ([1]=männlich, [2]=weiblich), tiktok_location_ids, tiktok_interest_ids
ad_groupOptionalobjectoptionale Überschreibungen der Anzeigengruppe; Standards: automatische Platzierung, ab sofort, gleichmäßige Auslieferung
adOptionalobjectoptionale Anzeige; benötigt eine video_id aus der Bibliothek
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad_group

Schreiben2 Credits

Erstellt eine TikTok Anzeigengruppe unter einer Kampagne mit Budget, Gebot, Targeting, Platzierungen, Zeitplan und Tageszeit-Steuerung. Zuerst Vorschau und Freigabe; wird pausiert erstellt, sofern nicht operation_status=ENABLE.

ParameterTypBeschreibung
campaign_idPflichtstringTikTok campaign_id
namePflichtstring—
budgetPflichtnumberTagesbudget, Kontowährung
budget_modeOptionalBUDGET_MODE_DAY | BUDGET_MODE_TOTAL—
placement_typeOptionalPLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL—
placementsOptionalarray<string>PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE
promotion_typeOptionalstringWEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION
app_idOptionalstringapp promotion only
identity_idOptionalstring—
identity_typeOptionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
secondary_optimization_eventOptionalstring—
operation_statusOptionalENABLE | DISABLE—
optimization_goalOptionalstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventOptionalstringCPC | CPM | OCPM | CPV
bid_typeOptionalstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceOptionalnumber—
conversion_bid_priceOptionalnumber—
pacingOptionalPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsOptionalarray<string>TikTok-Standort-IDs (Türkei 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsOptionalarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderOptionalGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesOptionalarray<string>Sprachcodes, z. B. tr, en
interest_category_idsOptionalarray<string>—
operating_systemsOptionalarray<string>ANDROID | IOS
audience_idsOptionalarray<string>—
excluded_audience_idsOptionalarray<string>—
schedule_start_timeOptionalstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeOptionalstringYYYY-MM-DD HH:MM:SS (UTC); setzt SCHEDULE_START_END
daypartingOptionalstring336 Zeichen aus 0/1: 7 Tage x 48 halbe Stunden, beginnend Montag 00:00
pixel_idOptionalstring—
optimization_eventOptionalstringz. B. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOptionalboolean—
share_disabledOptionalboolean—
search_result_enabledOptionalboolean—
interest_keyword_idsOptionalarray<string>aus search_tiktok_targeting(type=interest_keyword)
actionsOptionalarray<object>Verhaltens-Targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [IDs aus search_tiktok_targeting(type=behavior)]}]
deep_bid_typeOptionalstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidOptionalnumber—
zipcode_idsOptionalarray<string>from search_tiktok_targeting(type=location)
device_model_idsOptionalarray<string>—
device_price_rangesOptionalarray<number>price range bounds, e.g. [0, 250]
network_typesOptionalarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsOptionalarray<string>—
schedule_typeOptionalSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idOptionalstring—
frequencyOptionalintegermax impressions per user within frequency_schedule days
frequency_scheduleOptionalintegerfrequency cap window in days
brand_safety_typeOptionalstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsOptionalarray<string>—
targeting_expansionOptionalobjecte.g. {expansion_enabled: true}
household_incomeOptionalarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerOptionalALL | HIGH—
exclude_age_under_eighteenOptionalboolean—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad

Schreiben2 Credits

Erstellt eine TikTok Anzeige in einer Anzeigengruppe aus einem Bibliotheksvideo (oder Spark-Post). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
adgroup_idPflichtstring—
ad_nameOptionalstring—
ad_textPflichtstring1-100 Zeichen
video_idOptionalstringaus list_tiktok_videos
image_idsOptionalarray<string>Cover-Bild-IDs / Bildanzeige
ad_formatOptionalSINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL—
landing_page_urlOptionalstring—
call_to_actionOptionalstringLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD …
identity_idOptionalstring—
identity_typeOptionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameOptionalstring—
tiktok_item_idOptionalstringSpark Ads Post-ID
deeplinkOptionalstring—
auto_message_idOptionalstringwelcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message)
identity_bc_idOptionalstringBusiness Center id when identity_type is BC_AUTH_TT
operation_statusOptionalENABLE | DISABLEDISABLE creates the ad paused; default ENABLE
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_campaign_budget

Schreiben2 Credits

Ändert das Budget einer oder mehrerer TikTok Kampagnen. Durchläuft Vorschau und Freigabe; der Ledger wird nur aktualisiert, wenn TikTok die Änderung akzeptiert.

ParameterTypBeschreibung
campaign_idsPflichtarray<string>TikTok-Kampagnen-IDs (oder eine Tecrube-Kampagnen-ID)
amountPflichtnumberKontowährung
campaign_idOptionalstringAlias of campaign_ids (single id)
currencyOptionalstringoptional ISO check; must equal the ad account currency
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_campaign_status

SchreibenUnumkehrbar2 Credits

Pausiert (DISABLE) oder aktiviert (ENABLE) TikTok Kampagnen. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
campaign_idsPflichtarray<string>—
operation_statusPflichtENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
campaign_idOptionalstringAlias of campaign_ids (single id)
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad_group

Schreiben2 Credits

Aktualisiert eine oder mehrere TikTok Anzeigengruppen auf einmal: Budget, Gebot (bid_type/bid_price), Targeting (Standorte, Alter, Geschlecht, Sprachen, Interessen, Zielgruppen), Zeitplan und Tageszeit-Steuerung, Kommentar-/Teilen-Einstellungen. Platzierungen und Budgetmodus können nach der Erstellung nicht geändert werden (TikTok-Regel). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
adgroup_idsPflichtarray<string>—
adgroup_nameOptionalstring—
budgetOptionalnumber—
optimization_goalOptionalstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventOptionalstringCPC | CPM | OCPM | CPV
bid_typeOptionalstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceOptionalnumber—
conversion_bid_priceOptionalnumber—
pacingOptionalPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsOptionalarray<string>TikTok-Standort-IDs (Türkei 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsOptionalarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderOptionalGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesOptionalarray<string>Sprachcodes, z. B. tr, en
interest_category_idsOptionalarray<string>—
operating_systemsOptionalarray<string>ANDROID | IOS
audience_idsOptionalarray<string>—
excluded_audience_idsOptionalarray<string>—
schedule_start_timeOptionalstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeOptionalstringYYYY-MM-DD HH:MM:SS (UTC); setzt SCHEDULE_START_END
daypartingOptionalstring336 Zeichen aus 0/1: 7 Tage x 48 halbe Stunden, beginnend Montag 00:00
pixel_idOptionalstringFixed at creation (defines the ad group's optimisation); rejected with an explanation
optimization_eventOptionalstringz. B. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOptionalboolean—
share_disabledOptionalboolean—
search_result_enabledOptionalboolean—
interest_keyword_idsOptionalarray<string>aus search_tiktok_targeting(type=interest_keyword)
actionsOptionalarray<object>Verhaltens-Targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [IDs aus search_tiktok_targeting(type=behavior)]}]
deep_bid_typeOptionalstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidOptionalnumber—
zipcode_idsOptionalarray<string>from search_tiktok_targeting(type=location)
device_model_idsOptionalarray<string>—
device_price_rangesOptionalarray<number>price range bounds, e.g. [0, 250]
network_typesOptionalarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsOptionalarray<string>—
schedule_typeOptionalSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idOptionalstring—
frequencyOptionalintegermax impressions per user within frequency_schedule days
frequency_scheduleOptionalintegerfrequency cap window in days
brand_safety_typeOptionalstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsOptionalarray<string>—
targeting_expansionOptionalobjecte.g. {expansion_enabled: true}
household_incomeOptionalarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerOptionalALL | HIGH—
exclude_age_under_eighteenOptionalboolean—
changesOptionalobjectbeliebige adgroup/update-Felder als Map
adgroup_idOptionalstringAlias of adgroup_ids (single id)
placementsOptionalarray<string>Not changeable after creation (TikTok rule); rejected with an explanation
placement_typeOptionalstringNot changeable after creation (TikTok rule); rejected with an explanation
budget_modeOptionalstringNot changeable after creation (TikTok rule); rejected with an explanation
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad_group_status

SchreibenUnumkehrbar2 Credits

Pausiert oder aktiviert TikTok Anzeigengruppen (z. B. diejenigen, deren CPA über dem Ziel liegt). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
adgroup_idsPflichtarray<string>—
operation_statusPflichtENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonOptionalstring—
adgroup_idOptionalstringAlias of adgroup_ids (single id)
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad_status

SchreibenUnumkehrbar2 Credits

Pausiert oder aktiviert TikTok Anzeigen (z. B. ein abgenutztes Creative). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
ad_idsPflichtarray<string>—
operation_statusPflichtENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonOptionalstring—
ad_idOptionalstringAlias of ad_ids (single id)
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_custom_audience

Schreiben2 Credits

Erstellt eine regelbasierte benutzerdefinierte TikTok Zielgruppe aus Pixel-, App- oder Interaktionsereignissen (z. B. in den letzten 30 Tagen in den Warenkorb gelegt, aber nicht gekauft). Zuerst Vorschau und Freigabe; die Zielgruppe benötigt Stunden, um sich zu füllen.

ParameterTypBeschreibung
namePflichtstring—
audience_typeOptionalPIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP—
retention_daysOptionalinteger (1–365)—
eventOptionalstringeinzuschließendes Pixel-/App-Ereignis, z. B. AddToCart, CompletePayment, ViewContent
exclude_eventOptionalstringauszuschließendes Ereignis, z. B. CompletePayment für Warenkorbabbrecher
pixel_idOptionalstring—
event_source_idsOptionalarray<string>Pixel-IDs / App-IDs / Anzeigengruppen-IDs je nach audience_type
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_audience

SchreibenUnumkehrbar2 Credits

Löscht benutzerdefinierte oder Lookalike-Zielgruppen bei TikTok dauerhaft. Wird auf Wunsch des Nutzers angewendet und ist nicht rückgängig machbar.

ParameterTypBeschreibung
audience_idsPflichtarray<string>ids from list_tiktok_audiences
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_lookalike_audience

Schreiben2 Credits

Erstellt eine TikTok Lookalike-Zielgruppe aus einer benutzerdefinierten Zielgruppe (TikTok-Größen: NARROW ≈ am ähnlichsten, BALANCED, BROAD). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
namePflichtstring—
source_audience_idPflichtstring—
audience_sizeOptionalNARROW | BALANCED | BROAD—
include_sourceOptionalboolean—
location_idsOptionalarray<string>—
placementsOptionalarray<string>—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_whatsapp_campaign

Schreiben2 Credits

Erstellt eine TikTok Anzeige, die einen WhatsApp-Chat öffnet (Click-to-WhatsApp): LEAD_GENERATION-Kampagne, Anzeigengruppe mit Optimierungsort Instant Messaging App (WhatsApp) auf der TikTok-Platzierung und eine Videoanzeige, deren Cover automatisch aus dem Video übernommen wird. chat_link erzeugt den wa.me-Link aus der Telefonnummer; Website-URLs werden abgelehnt. Alles wird pausiert erstellt; zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
namePflichtstring—
phone_numberPflichtstringWhatsApp-Geschäftsnummer mit Ländervorwahl, z. B. +90 532 000 00 00 (nationales Format mit führender 0 wird abgelehnt)
daily_budgetPflichtnumberTagesbudget der Anzeigengruppe, Kontowährung (TikTok-Minimum ≈ Gegenwert von USD 20)
video_idPflichtstringBibliotheksvideo (list_tiktok_videos / upload_tiktok_video)
ad_textPflichtstring1-100 Zeichen
connection_methodOptionalchat_link | nativechat_link: aus der Nummer erzeugter wa.me-Link (nur CLICK, keine zusätzliche Einrichtung); native: mit dem Nachrichtenverwaltungs-Tool von TikTok verbundene Nummer (CLICK oder CONVERSATION bei Freischaltung)
prefilled_messageOptionalstringnur chat_link: in WhatsApp vorausgefüllter Text; muss das Angebot oder die Dienstleistung aus der Anzeige nennen, allgemeine Begrüßungen werden abgelehnt
optimization_goalOptionalCLICK | CONVERSATION—
phone_region_codeOptionalstringnur native, wenn die Vorwahl geteilt wird (z. B. US für +1)
message_event_set_idOptionalstringnur native + CONVERSATION, wenn die Nummer keinem Event-Set entspricht
image_idsOptionalarray<string>Cover-Bild-ID; weggelassen = das eigene Cover des Videos wird automatisch abgerufen und hochgeladen
call_to_actionOptionalstringStandard SEND_MESSAGE (CALL_NOW nicht erlaubt)
ad_nameOptionalstring—
identity_idOptionalstring—
identity_typeOptionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameOptionalstring—
goalOptionalstring—
audienceOptionalobjectcountries (ISO-Liste), age_min (18+), age_max, genders ([1]=männlich, [2]=weiblich), tiktok_location_ids, tiktok_interest_ids
ad_groupOptionalobjectoptionale Überschreibungen für Targeting/Zeitplan der Anzeigengruppe; Platzierungen, Promotion-Typ und Suchergebnisse sind für Messaging-Anzeigen fest vorgegeben
landing_page_urlOptionalstringNICHT zulässig: eine Messaging-Anzeigengruppe hat kein Website-Ziel; geben Sie stattdessen phone_number an
website_urlOptionalstringNOT accepted (same rule as landing_page_url); rejected with an explanation
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_campaign

Schreiben5 Credits

Benennt eine TikTok-Kampagne um (campaign/update); der Name im Kampagnenbuch folgt. Zuerst Vorschau und Freigabe. Budget und Status haben eigene Tools.

ParameterTypBeschreibung
campaign_idPflichtstringTikTok-campaign_id oder Tecrübe-Kampagnen-ID
namePflichtstring—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_ad

Schreiben5 Credits

Bearbeitet den Text einer TikTok-Anzeige direkt (ad/update): Name, Text, Landingpage, Call-to-Action oder Anzeigename. Die aktuelle Anzeige wird zuerst gelesen und jedes andere Feld bleibt erhalten. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
ad_idPflichtstring—
adgroup_idOptionalstringoptional; wird aus der Anzeige gelesen, wenn weggelassen
ad_nameOptionalstring—
ad_textOptionalstring1-100 Zeichen
landing_page_urlOptionalstring—
call_to_actionOptionalstring—
display_nameOptionalstring—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_auto_message

Schreiben2 Credits

Erstellt eine Begrüßungsnachricht für TikTok-Direktnachrichten-Anzeigen (creative/auto_message/create): eine Begrüßung plus 1-3 antippbare Fragen mit automatischen Antworten. Gibt nach Freigabe auto_message_id zurück.

ParameterTypBeschreibung
titlePflichtstringVorlagenname
contentPflichtstringBegrüßung
suggested_questionsPflichtarray<object>—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_identity

Schreiben2 Credits

Erstellt eine benutzerdefinierte TikTok-Anzeigenidentität (identity/create): den Anzeigenamen und den Avatar, die bei Nicht-Spark-Anzeigen erscheinen. Zuerst Vorschau und Freigabe; gibt identity_id zurück.

ParameterTypBeschreibung
display_namePflichtstring—
image_uriOptionalstringimage_id eines quadratischen Avatars aus upload_tiktok_image
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_pixel

Schreiben2 Credits

Erstellt ein TikTok-Conversion-Pixel (pixel/create). Zuerst Vorschau und Freigabe; gibt pixel_id und pixel_code zur Installation auf der Website zurück.

ParameterTypBeschreibung
namePflichtstring—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_customer_file_audience

Schreiben6 Credits

Erstellt aus einer Kundenliste eine benutzerdefinierte TikTok-Zielgruppe (dmp/custom_audience/file/upload + create). Die Werte werden in Tecrübe normalisiert und mit SHA-256 gehasht, bevor etwas gespeichert oder gesendet wird; die Vorschau zeigt nur Anzahlen. Zuerst Freigabe.

ParameterTypBeschreibung
namePflichtstring—
identifiersPflichtarray<string>E-Mail-Adressen, Telefonnummern mit +Ländervorwahl oder Geräte-IDs; bereits SHA-256-gehashte Werte werden ebenfalls akzeptiert
id_typeOptionalEMAIL | PHONE | IDFA | AAIDStandard EMAIL
retention_daysOptionalinteger (1–365)—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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.

share_tiktok_audience

Schreiben4 Credits

Teilt benutzerdefinierte TikTok-Zielgruppen mit anderen Werbekonten im selben Business Center oder beendet die Freigabe (dmp/custom_audience/share, /share/cancel). Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
audience_idsPflichtarray<string>1-10 Custom-Audience-IDs
shared_advertiser_idsOptionalarray<string>1-10 Werbekonten im selben Business Center (beim Aufheben optional: alle)
actionOptionalshare | unshare—
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_search_negative_keywords

Schreiben4 Credits

Auszuschließende Keywords der TikTok-Suchanzeigen einer Kampagne oder Anzeigengruppe (search_ad/negative_keyword/*): list liest direkt; add und delete durchlaufen Vorschau und Freigabe.

ParameterTypBeschreibung
object_typePflichtCAMPAIGN | ADGROUP—
object_idPflichtstring—
operationOptionallist | add | deleteStandard list
keywordsOptionalarray<string>für add; jeweils höchstens 80 Zeichen
keyword_idsOptionalarray<string>für delete (aus operation=list)
match_typeOptionalPRECISE_WORD | PHRASE_WORD | BROAD_WORDfür add; Standard BROAD_WORD
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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_tiktok_conversion_event

Schreiben1 Credits

Sendet ein serverseitiges Web-Conversion-Ereignis an TikTok (Events API 2.0, event/track). E-Mail, Telefon und externe ID werden vor dem Speichern oder Senden per SHA-256 gehasht. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
pixel_codePflichtstringaus list_tiktok_pixels
event_namePflichtstringStandardereignis, z. B. CompletePayment, SubmitForm, Contact, AddToCart
emailOptionalstring—
phoneOptionalstringmit +Ländervorwahl
external_idOptionalstring—
ttclidOptionalstringTikTok-Klick-ID aus der Landingpage-URL
valueOptionalnumber—
currencyOptionalstringISO 4217, erforderlich mit value
event_idOptionalstringmit dem Browser-Pixel geteilter Deduplizierungsschlüssel
test_event_codeOptionalstringfrom Events Manager › Test Events; the event is only shown there
urlOptionalstringSeite, auf der das Ereignis stattfand
advertiser_idOptionalstringoptional: run in this TikTok ad account (advertiser id from list_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.