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 CreditsTikTok 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 CreditsTikTok 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idsOptional | array<string> | — |
statusOptional | STATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALL | Filter nach Primärstatus, z. B. STATUS_DELIVERY_OK, STATUS_DISABLE |
advertiser_idOptional | string | optional: 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 CreditsTikTok Anzeigengruppen mit Budget, Gebot, Optimierungsziel, Targeting (Standorte, Alter, Geschlecht, Sprachen, Interessen, Zielgruppen), Platzierungen, Zeitplan und Tageszeit-Steuerung.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idsOptional | array<string> | — |
adgroup_idsOptional | array<string> | — |
advertiser_idOptional | string | optional: 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 CreditsTikTok 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idsOptional | array<string> | — |
adgroup_idsOptional | array<string> | — |
ad_idsOptional | array<string> | — |
advertiser_idOptional | string | optional: 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 CreditsTikTok 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
levelOptional | campaign | ad_group | ad | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | — |
end_dateOptional | string | — |
dailyOptional | boolean | eine Zeile pro Tag (stat_time_day) |
campaign_idsOptional | array<string> | — |
adgroup_idsOptional | array<string> | — |
ad_idsOptional | array<string> | — |
advertiser_idOptional | string | optional: 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 CreditsBenutzerdefinierte 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsVideos 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
video_idsOptional | array<string> | — |
limitOptional | integer (1–500) | newest first (default 500) |
advertiser_idOptional | string | optional: 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 CreditsVorgeschlagene 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
video_idPflicht | string | — |
countOptional | integer (1–10) | — |
advertiser_idOptional | string | optional: 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 CreditsWandelt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
typePflicht | interest | behavior | interest_keyword | location | region | — |
queryPflicht | string | zu suchender Name, z. B. fashion, moda, Istanbul, Turkey |
languageOptional | string | Sprache der Namen für interest/behavior/interest_keyword, z. B. tr, en (Standard: Sprache der Unterhaltung) |
objective_typeOptional | string | für location/region: Kampagnenziel, Standard TRAFFIC; LEAD_GENERATION für WhatsApp-Anzeigen |
promotion_typeOptional | string | für location/region; Standard WEBSITE, oder LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE mit LEAD_GENERATION |
placementsOptional | array<string> | Standard PLACEMENT_TIKTOK |
region_codesOptional | array<string> | location: nach Ländercode filtern, z. B. TR |
geo_typesOptional | array<string> | location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE |
limitOptional | integer (1–100) | — |
advertiser_idOptional | string | optional: 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 CreditsAnzeigenidentitä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.
| Parameter | Typ | Beschreibung |
|---|---|---|
identity_typeOptional | CUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT | — |
identity_bc_idOptional | string | erforderlich bei BC_AUTH_TT |
advertiser_idOptional | string | optional: 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 CreditsTikTok-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.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsVorlagen 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsSofort-Lead-Formulare des TikTok-Werbekontos (page/get, LEAD_GEN): page_id, Titel, Status, Erstellungs-/Aktualisierungs-/Veröffentlichungszeit und Vorschau-URL. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsFragefelder 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idPflicht | string | Sofortformular-ID aus list_tiktok_lead_forms |
advertiser_idOptional | string | optional: 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 CreditsLä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.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | Sofortformular-ID aus list_tiktok_lead_forms (oder ad_id angeben) |
ad_idOptional | string | ID der Lead-Anzeige; lädt statt eines Formulars die Leads dieser Anzeige herunter |
task_idOptional | string | Aufgaben-ID aus einem früheren Aufruf, der noch RUNNING war |
regionOptional | eu | us | other | wo die Anzeigen ausgerichtet waren: eu = EWR/Schweiz/UK, us = Vereinigte Staaten, other (Standard) = überall sonst |
limitOptional | integer (1–100) | Zeilen in der maskierten Vorschau (Standard 20); die vollständige Liste gibt es nur in der Download-Datei |
advertiser_idOptional | string | optional: 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 CreditsCreative-Portfolios des TikTok-Werbekontos (creative/portfolio/list): Portfolio-ID, Typ (Display-Karte, Download-Karte, Geschenkcode…), Vorschau-URL und Haupteinstellungen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsMit 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idOptional | string | optional: 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 CreditsSmart+-(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.
| Parameter | Typ | Beschreibung |
|---|---|---|
levelOptional | campaign | adgroup | ad | Standard campaign |
advertiser_idOptional | string | optional: 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 CreditsOrganische 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
identity_idPflicht | string | — |
identity_typeOptional | TT_USER | BC_AUTH_TT | AUTH_CODE | Standard TT_USER |
identity_bc_idOptional | string | erforderlich bei BC_AUTH_TT |
limitOptional | integer (1–100) | Standard 20 |
advertiser_idOptional | string | optional: 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 CreditsTikToks 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
adgroup_idsOptional | array<string> | bis zu 20; Standard: TikTok wählt die Anzeigengruppen mit Diagnosen |
issue_categoriesOptional | array<string> | CREATIVE | BID_AND_BUDGET | EVENT_TRACK |
advertiser_idOptional | string | optional: 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 CreditsFreier 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
metricsPflicht | array<string> | TikTok-Metriknamen, z. B. spend, impressions, clicks, conversion, complete_payment_roas |
dimensionsPflicht | array<string> | z. B. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age |
report_typeOptional | BASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP | — |
data_levelOptional | string | z. B. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER |
daysOptional | integer (1–365) | — |
start_dateOptional | string | — |
end_dateOptional | string | — |
lifetimeOptional | boolean | Gesamtwerte der Laufzeit statt eines Zeitraums |
filteringOptional | array<object> | TikTok-Filter: [{field_name, filter_type, filter_value}] |
limitOptional | integer (1–5000) | — |
advertiser_idOptional | string | optional: 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 CreditsMit 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 CreditsWerbekonten in einem TikTok Business Center (bc/asset/get, ADVERTISER): Advertiser-ID, Name, Kontotyp, Ihre Rolle und Verifizierungsstatus. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
bc_idOptional | string | Business Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht |
list_tiktok_bc_pixels
Lesen1 CreditsIn einem TikTok Business Center gehaltene Pixel (bc/asset/get, PIXEL) über seine Werbekonten hinweg. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
bc_idOptional | string | Business Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht |
list_tiktok_asset_groups
Lesen1 CreditsAsset-Gruppen eines TikTok Business Center (bc/asset_group/list): asset_group_id und Name. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
bc_idOptional | string | Business Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht |
tiktok_advertiser_qualification
Lesen1 CreditsUnternehmensqualifikationen in einem TikTok Business Center (bc/advertiser/qualification/get): Firmenname, Verifizierungsstatus, besitzendes Werbekonto, Anzahl verknüpfter Konten und Region. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
bc_idOptional | string | Business-Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht |
advertiser_idOptional | string | nur Qualifikationen dieses Werbekontos behalten |
verifiedOptional | boolean | nach verifiziert / nicht verifiziert filtern |
tiktok_change_history
Lesen2 CreditsAktivitätsprotokoll eines TikTok Business Centers (changelog/get): wann, welcher Aktivitätstyp, Bearbeiter-ID und Änderungstext, neueste zuerst. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
bc_idOptional | string | Business-Center-ID (list_tiktok_business_centers); optional, wenn das Token nur ein Business Center erreicht |
start_dateOptional | string | YYYY-MM-DD (UTC); Standard: letzte 7 Tage |
end_dateOptional | string | — |
daysOptional | integer (1–365) | — |
activity_typeOptional | string | ALL (Standard) | USER | ASSET | … wie von TikTok definiert |
limitOptional | integer (1–500) | — |
advertiser_idOptional | string | optional: 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 CreditsChoose 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
advertiser_idPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_tiktok_video
Schreiben2 CreditsLä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.
| Parameter | Typ | Beschreibung |
|---|---|---|
video_urlPflicht | string | öffentliche http(s)-URL einer mp4/mov/mpeg/avi-Datei (für URL-Uploads idealerweise unter 10 MB) |
file_nameOptional | string | 1-100 Zeichen, eindeutig im Konto; Standard: Dateiname der URL + Zeitstempel |
auto_fixOptional | boolean | TikTok niedrige Auflösung / falsches Seitenverhältnis erkennen und korrigieren lassen |
advertiser_idOptional | string | optional: 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 CreditsLä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.
| Parameter | Typ | Beschreibung |
|---|---|---|
image_urlPflicht | string | öffentliche http(s)-URL eines JPG/PNG (max. 1440x2560 Pixel insgesamt) |
file_nameOptional | string | 1-100 Zeichen, eindeutig im Konto; Standard: Dateiname der URL + Zeitstempel |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
objective_typePflicht | TRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES | — |
daily_budgetOptional | number | Kontowährung |
budget_modeOptional | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE | — |
goalOptional | string | — |
pixel_idOptional | string | — |
sales_destinationOptional | WEBSITE | APP | WEB_AND_APP | TIKTOK_SHOP | PRODUCT_SALES campaigns only |
audienceOptional | object | countries (ISO-Liste), age_min, age_max, genders ([1]=männlich, [2]=weiblich), tiktok_location_ids, tiktok_interest_ids |
ad_groupOptional | object | optionale Überschreibungen der Anzeigengruppe; Standards: automatische Platzierung, ab sofort, gleichmäßige Auslieferung |
adOptional | object | optionale Anzeige; benötigt eine video_id aus der Bibliothek |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | TikTok campaign_id |
namePflicht | string | — |
budgetPflicht | number | Tagesbudget, Kontowährung |
budget_modeOptional | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | — |
placement_typeOptional | PLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL | — |
placementsOptional | array<string> | PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE |
promotion_typeOptional | string | WEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION |
app_idOptional | string | app promotion only |
identity_idOptional | string | — |
identity_typeOptional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
secondary_optimization_eventOptional | string | — |
operation_statusOptional | ENABLE | DISABLE | — |
optimization_goalOptional | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventOptional | string | CPC | CPM | OCPM | CPV |
bid_typeOptional | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceOptional | number | — |
conversion_bid_priceOptional | number | — |
pacingOptional | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsOptional | array<string> | TikTok-Standort-IDs (Türkei 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsOptional | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderOptional | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesOptional | array<string> | Sprachcodes, z. B. tr, en |
interest_category_idsOptional | array<string> | — |
operating_systemsOptional | array<string> | ANDROID | IOS |
audience_idsOptional | array<string> | — |
excluded_audience_idsOptional | array<string> | — |
schedule_start_timeOptional | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeOptional | string | YYYY-MM-DD HH:MM:SS (UTC); setzt SCHEDULE_START_END |
daypartingOptional | string | 336 Zeichen aus 0/1: 7 Tage x 48 halbe Stunden, beginnend Montag 00:00 |
pixel_idOptional | string | — |
optimization_eventOptional | string | z. B. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledOptional | boolean | — |
share_disabledOptional | boolean | — |
search_result_enabledOptional | boolean | — |
interest_keyword_idsOptional | array<string> | aus search_tiktok_targeting(type=interest_keyword) |
actionsOptional | array<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_typeOptional | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidOptional | number | — |
zipcode_idsOptional | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsOptional | array<string> | — |
device_price_rangesOptional | array<number> | price range bounds, e.g. [0, 250] |
network_typesOptional | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsOptional | array<string> | — |
schedule_typeOptional | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idOptional | string | — |
frequencyOptional | integer | max impressions per user within frequency_schedule days |
frequency_scheduleOptional | integer | frequency cap window in days |
brand_safety_typeOptional | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsOptional | array<string> | — |
targeting_expansionOptional | object | e.g. {expansion_enabled: true} |
household_incomeOptional | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerOptional | ALL | HIGH | — |
exclude_age_under_eighteenOptional | boolean | — |
advertiser_idOptional | string | optional: 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 CreditsErstellt eine TikTok Anzeige in einer Anzeigengruppe aus einem Bibliotheksvideo (oder Spark-Post). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
adgroup_idPflicht | string | — |
ad_nameOptional | string | — |
ad_textPflicht | string | 1-100 Zeichen |
video_idOptional | string | aus list_tiktok_videos |
image_idsOptional | array<string> | Cover-Bild-IDs / Bildanzeige |
ad_formatOptional | SINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL | — |
landing_page_urlOptional | string | — |
call_to_actionOptional | string | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD … |
identity_idOptional | string | — |
identity_typeOptional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameOptional | string | — |
tiktok_item_idOptional | string | Spark Ads Post-ID |
deeplinkOptional | string | — |
auto_message_idOptional | string | welcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message) |
identity_bc_idOptional | string | Business Center id when identity_type is BC_AUTH_TT |
operation_statusOptional | ENABLE | DISABLE | DISABLE creates the ad paused; default ENABLE |
advertiser_idOptional | string | optional: 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idsPflicht | array<string> | TikTok-Kampagnen-IDs (oder eine Tecrube-Kampagnen-ID) |
amountPflicht | number | Kontowährung |
campaign_idOptional | string | Alias of campaign_ids (single id) |
currencyOptional | string | optional ISO check; must equal the ad account currency |
advertiser_idOptional | string | optional: 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 CreditsPausiert (DISABLE) oder aktiviert (ENABLE) TikTok Kampagnen. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idsPflicht | array<string> | — |
operation_statusPflicht | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
campaign_idOptional | string | Alias of campaign_ids (single id) |
advertiser_idOptional | string | optional: 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 CreditsAktualisiert 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
adgroup_idsPflicht | array<string> | — |
adgroup_nameOptional | string | — |
budgetOptional | number | — |
optimization_goalOptional | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventOptional | string | CPC | CPM | OCPM | CPV |
bid_typeOptional | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceOptional | number | — |
conversion_bid_priceOptional | number | — |
pacingOptional | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsOptional | array<string> | TikTok-Standort-IDs (Türkei 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsOptional | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderOptional | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesOptional | array<string> | Sprachcodes, z. B. tr, en |
interest_category_idsOptional | array<string> | — |
operating_systemsOptional | array<string> | ANDROID | IOS |
audience_idsOptional | array<string> | — |
excluded_audience_idsOptional | array<string> | — |
schedule_start_timeOptional | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeOptional | string | YYYY-MM-DD HH:MM:SS (UTC); setzt SCHEDULE_START_END |
daypartingOptional | string | 336 Zeichen aus 0/1: 7 Tage x 48 halbe Stunden, beginnend Montag 00:00 |
pixel_idOptional | string | Fixed at creation (defines the ad group's optimisation); rejected with an explanation |
optimization_eventOptional | string | z. B. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledOptional | boolean | — |
share_disabledOptional | boolean | — |
search_result_enabledOptional | boolean | — |
interest_keyword_idsOptional | array<string> | aus search_tiktok_targeting(type=interest_keyword) |
actionsOptional | array<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_typeOptional | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidOptional | number | — |
zipcode_idsOptional | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsOptional | array<string> | — |
device_price_rangesOptional | array<number> | price range bounds, e.g. [0, 250] |
network_typesOptional | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsOptional | array<string> | — |
schedule_typeOptional | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idOptional | string | — |
frequencyOptional | integer | max impressions per user within frequency_schedule days |
frequency_scheduleOptional | integer | frequency cap window in days |
brand_safety_typeOptional | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsOptional | array<string> | — |
targeting_expansionOptional | object | e.g. {expansion_enabled: true} |
household_incomeOptional | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerOptional | ALL | HIGH | — |
exclude_age_under_eighteenOptional | boolean | — |
changesOptional | object | beliebige adgroup/update-Felder als Map |
adgroup_idOptional | string | Alias of adgroup_ids (single id) |
placementsOptional | array<string> | Not changeable after creation (TikTok rule); rejected with an explanation |
placement_typeOptional | string | Not changeable after creation (TikTok rule); rejected with an explanation |
budget_modeOptional | string | Not changeable after creation (TikTok rule); rejected with an explanation |
advertiser_idOptional | string | optional: 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 CreditsPausiert oder aktiviert TikTok Anzeigengruppen (z. B. diejenigen, deren CPA über dem Ziel liegt). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
adgroup_idsPflicht | array<string> | — |
operation_statusPflicht | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonOptional | string | — |
adgroup_idOptional | string | Alias of adgroup_ids (single id) |
advertiser_idOptional | string | optional: 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 CreditsPausiert oder aktiviert TikTok Anzeigen (z. B. ein abgenutztes Creative). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idsPflicht | array<string> | — |
operation_statusPflicht | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonOptional | string | — |
ad_idOptional | string | Alias of ad_ids (single id) |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
audience_typeOptional | PIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP | — |
retention_daysOptional | integer (1–365) | — |
eventOptional | string | einzuschließendes Pixel-/App-Ereignis, z. B. AddToCart, CompletePayment, ViewContent |
exclude_eventOptional | string | auszuschließendes Ereignis, z. B. CompletePayment für Warenkorbabbrecher |
pixel_idOptional | string | — |
event_source_idsOptional | array<string> | Pixel-IDs / App-IDs / Anzeigengruppen-IDs je nach audience_type |
advertiser_idOptional | string | optional: 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 CreditsLöscht benutzerdefinierte oder Lookalike-Zielgruppen bei TikTok dauerhaft. Wird auf Wunsch des Nutzers angewendet und ist nicht rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
audience_idsPflicht | array<string> | ids from list_tiktok_audiences |
advertiser_idOptional | string | optional: 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 CreditsErstellt eine TikTok Lookalike-Zielgruppe aus einer benutzerdefinierten Zielgruppe (TikTok-Größen: NARROW ≈ am ähnlichsten, BALANCED, BROAD). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
source_audience_idPflicht | string | — |
audience_sizeOptional | NARROW | BALANCED | BROAD | — |
include_sourceOptional | boolean | — |
location_idsOptional | array<string> | — |
placementsOptional | array<string> | — |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
phone_numberPflicht | string | WhatsApp-Geschäftsnummer mit Ländervorwahl, z. B. +90 532 000 00 00 (nationales Format mit führender 0 wird abgelehnt) |
daily_budgetPflicht | number | Tagesbudget der Anzeigengruppe, Kontowährung (TikTok-Minimum ≈ Gegenwert von USD 20) |
video_idPflicht | string | Bibliotheksvideo (list_tiktok_videos / upload_tiktok_video) |
ad_textPflicht | string | 1-100 Zeichen |
connection_methodOptional | chat_link | native | chat_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_messageOptional | string | nur chat_link: in WhatsApp vorausgefüllter Text; muss das Angebot oder die Dienstleistung aus der Anzeige nennen, allgemeine Begrüßungen werden abgelehnt |
optimization_goalOptional | CLICK | CONVERSATION | — |
phone_region_codeOptional | string | nur native, wenn die Vorwahl geteilt wird (z. B. US für +1) |
message_event_set_idOptional | string | nur native + CONVERSATION, wenn die Nummer keinem Event-Set entspricht |
image_idsOptional | array<string> | Cover-Bild-ID; weggelassen = das eigene Cover des Videos wird automatisch abgerufen und hochgeladen |
call_to_actionOptional | string | Standard SEND_MESSAGE (CALL_NOW nicht erlaubt) |
ad_nameOptional | string | — |
identity_idOptional | string | — |
identity_typeOptional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameOptional | string | — |
goalOptional | string | — |
audienceOptional | object | countries (ISO-Liste), age_min (18+), age_max, genders ([1]=männlich, [2]=weiblich), tiktok_location_ids, tiktok_interest_ids |
ad_groupOptional | object | optionale Überschreibungen für Targeting/Zeitplan der Anzeigengruppe; Platzierungen, Promotion-Typ und Suchergebnisse sind für Messaging-Anzeigen fest vorgegeben |
landing_page_urlOptional | string | NICHT zulässig: eine Messaging-Anzeigengruppe hat kein Website-Ziel; geben Sie stattdessen phone_number an |
website_urlOptional | string | NOT accepted (same rule as landing_page_url); rejected with an explanation |
advertiser_idOptional | string | optional: 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 CreditsBenennt eine TikTok-Kampagne um (campaign/update); der Name im Kampagnenbuch folgt. Zuerst Vorschau und Freigabe. Budget und Status haben eigene Tools.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | TikTok-campaign_id oder Tecrübe-Kampagnen-ID |
namePflicht | string | — |
advertiser_idOptional | string | optional: 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 CreditsBearbeitet 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_idPflicht | string | — |
adgroup_idOptional | string | optional; wird aus der Anzeige gelesen, wenn weggelassen |
ad_nameOptional | string | — |
ad_textOptional | string | 1-100 Zeichen |
landing_page_urlOptional | string | — |
call_to_actionOptional | string | — |
display_nameOptional | string | — |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
titlePflicht | string | Vorlagenname |
contentPflicht | string | Begrüßung |
suggested_questionsPflicht | array<object> | — |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
display_namePflicht | string | — |
image_uriOptional | string | image_id eines quadratischen Avatars aus upload_tiktok_image |
advertiser_idOptional | string | optional: 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 CreditsErstellt ein TikTok-Conversion-Pixel (pixel/create). Zuerst Vorschau und Freigabe; gibt pixel_id und pixel_code zur Installation auf der Website zurück.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
advertiser_idOptional | string | optional: 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 CreditsErstellt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
identifiersPflicht | array<string> | E-Mail-Adressen, Telefonnummern mit +Ländervorwahl oder Geräte-IDs; bereits SHA-256-gehashte Werte werden ebenfalls akzeptiert |
id_typeOptional | EMAIL | PHONE | IDFA | AAID | Standard EMAIL |
retention_daysOptional | integer (1–365) | — |
advertiser_idOptional | string | optional: 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 CreditsTeilt benutzerdefinierte TikTok-Zielgruppen mit anderen Werbekonten im selben Business Center oder beendet die Freigabe (dmp/custom_audience/share, /share/cancel). Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
audience_idsPflicht | array<string> | 1-10 Custom-Audience-IDs |
shared_advertiser_idsOptional | array<string> | 1-10 Werbekonten im selben Business Center (beim Aufheben optional: alle) |
actionOptional | share | unshare | — |
advertiser_idOptional | string | optional: 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 CreditsAuszuschließende Keywords der TikTok-Suchanzeigen einer Kampagne oder Anzeigengruppe (search_ad/negative_keyword/*): list liest direkt; add und delete durchlaufen Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
object_typePflicht | CAMPAIGN | ADGROUP | — |
object_idPflicht | string | — |
operationOptional | list | add | delete | Standard list |
keywordsOptional | array<string> | für add; jeweils höchstens 80 Zeichen |
keyword_idsOptional | array<string> | für delete (aus operation=list) |
match_typeOptional | PRECISE_WORD | PHRASE_WORD | BROAD_WORD | für add; Standard BROAD_WORD |
advertiser_idOptional | string | optional: 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 CreditsSendet 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
pixel_codePflicht | string | aus list_tiktok_pixels |
event_namePflicht | string | Standardereignis, z. B. CompletePayment, SubmitForm, Contact, AddToCart |
emailOptional | string | — |
phoneOptional | string | mit +Ländervorwahl |
external_idOptional | string | — |
ttclidOptional | string | TikTok-Klick-ID aus der Landingpage-URL |
valueOptional | number | — |
currencyOptional | string | ISO 4217, erforderlich mit value |
event_idOptional | string | mit dem Browser-Pixel geteilter Deduplizierungsschlüssel |
test_event_codeOptional | string | from Events Manager › Test Events; the event is only shown there |
urlOptional | string | Seite, auf der das Ereignis stattfand |
advertiser_idOptional | string | optional: 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.