TikTok-Anzeigen

Strategischer Leitfaden für die Verwaltung von TikTok-Werbekampagnen. Gründlich recherchieren, Parameter sorgfältig validieren und Benutzer durch die strengen zielspezifischen Anforderungen der Plattform führen.

Dieses Skill ist für bezahlte TikTok-Anzeigen (die TikTok-Marketing-API-Oberfläche). Für die organische Veröffentlichung von TikTok-Videos siehe das zukünftige Skill tiktok-posting.

Voraussetzungen

Hyper MCP installiert und verbunden. https://app.hyperfx.ai/mcp
TikTok-Marketing-Integration verbunden (TikTok Ads Manager / Business Center) unter https://app.hyperfx.ai/integrations.

Wenn tiktok_get_advertiser_accounts nicht in der Werkzeugliste ist, anhalten und den Benutzer auffordern, Hyper MCP zu aktivieren und TikTok Marketing zu verbinden.

Werkzeugoberfläche

Werkzeug	Zweck
`tiktok_get_advertiser_accounts`	Erkennung: listet die verfügbaren Werbetreibenden-IDs des verbundenen Benutzers auf.
`tiktok_get_campaigns`, `tiktok_create_campaign`, `tiktok_update_campaign`, `tiktok_update_campaign_status`	Kampagnen-Lebenszyklus.
`tiktok_get_adgroups`, `tiktok_create_adgroup`, `tiktok_update_adgroup`, `tiktok_update_adgroup_status`	Anzeigengruppen-Lebenszyklus.
`tiktok_get_ads`, `tiktok_create_ad`, `tiktok_update_ad_status`	Anzeigen-Lebenszyklus. Hinweis: `tiktok_update_ad` existiert nicht im MCP – inhaltliche Änderungen an Anzeigen (Creative, Text, URL) erfordern die TikTok Ads Manager-Benutzeroberfläche. Nur Statusänderungen (aktivieren / pausieren / löschen) sind über MCP verfügbar.
`tiktok_ad_video_upload`, `tiktok_ad_video_info`, `tiktok_ad_video_search`	Video-Creative-Upload + Suche.
`tiktok_report_integrated_get`	Leistungsberichte.
`tiktok_create_custom_audience`, `tiktok_list_custom_audiences`, `tiktok_create_lookalike_audience`	Zielgruppenverwaltung (optional).

Phase 1: Kontoerkennung

Ersteinrichtung

Verwende tiktok_get_advertiser_accounts(), um Werbetreibenden-IDs zu erhalten.
Bei mehreren Konten: Benutzer bitten, eines auszuwählen.
Bei einem einzelnen Konto: Benutzer informieren und fortfahren.

Gebots-Benchmarks (optional, aber empfohlen)

Vor dem Festlegen von Gebotspreisen rufe tiktok_ad_benchmarks auf, um branchenspezifische CPM/CPC-Benchmarks abzurufen. Dies verhindert die Verwendung von Platzhalterwerten, die zu niedrig sein könnten, um Auktionen zu gewinnen, oder zu hoch für das Budget des Benutzers.

tiktok_ad_benchmarks(
    advertiser_id="123456789",
    dimensions=["industry"],
    filtering={"industry": "292801"}  # Branchencode aus tiktok_get_advertiser_accounts
)

Verfügbare Kampagnenziele

Ziel	Am besten geeignet für	Wichtige Anforderungen
`TRAFFIC`	Website-Besuche steigern	`promotion_type="WEBSITE"`, CPC-Abrechnung
`CONVERSIONS`	Käufe / Leads generieren	Pixel-ID, Conversion-Event-Tracking
`REACH`	Markenbekanntheit	Nur manuelle Platzierung, CPM-Abrechnung, Frequenzbegrenzung
`APP_PROMOTION`	App-Installationen	App-ID, App-Store-URL
`VIDEO_VIEW`	Video-Engagement	Video-Creative-Assets

Phase 2: Kampagnenerstellung

Schritt 1: Kampagne erstellen

Budgetanforderungen:

MINDESTENS 50 $ für Kampagnenbudgets (TikTok-Anforderung).
budget_mode: BUDGET_MODE_INFINITE (CBO), BUDGET_MODE_DAY oder BUDGET_MODE_TOTAL.

tiktok_create_campaign(
    advertiser_id="123456789",
    campaign_name="Sommerschlussverkauf 2026",
    objective_type="TRAFFIC",
    budget_mode="BUDGET_MODE_DAY",
    budget=50.0,  # MINDESTENS 50 $/Tag
    operation_status="ENABLE"
)

Schritt 2: Anzeigengruppe erstellen

IMMER ERFORDERLICHE Parameter:

advertiser_id, campaign_id, adgroup_name.
location_ids (z. B. ["6252001"] für USA).
schedule_type und schedule_start_time (MUSS ein zukünftiges Datum sein).
billing_event (CPC, CPM, OCPM).
budget_mode (ERFORDERLICH für Anzeigengruppen).

Bei TRAFFIC-Kampagnen:

tiktok_create_adgroup(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Website-Traffic - Sommerschlussverkauf",
    location_ids=["6252001"],  # USA
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",  # ZUKÜNFTIGES DATUM
    billing_event="CPC",
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    promotion_type="WEBSITE",        # ERFORDERLICH für TRAFFIC
    optimization_goal="CLICK",       # ERFORDERLICH (korrekte Schreibweise)
    bid_price=0.50,
    placement_type="PLACEMENT_TYPE_AUTOMATIC",
    operation_status="ENABLE"
)

Bei REACH-Kampagnen:

tiktok_create_adgroup(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Markenbekanntheit USA",
    location_ids=["6252001"],
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",
    billing_event="CPM",                       # ERFORDERLICH für REACH
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    optimization_goal="REACH",
    placement_type="PLACEMENT_TYPE_NORMAL",    # ERFORDERLICH – automatisch NICHT unterstützt
    placements=["PLACEMENT_TIKTOK"],           # ERFORDERLICH
    bid_price=2.0,                             # ERFORDERLICH
    frequency=3,                               # ERFORDERLICH
    frequency_schedule=7,                      # ERFORDERLICH
    operation_status="ENABLE"
)

Schritt 3: Creative-Assets hochladen

Lade ein Video pro Creative-Variante hoch. Merke dir die zurückgegebene video_id – du wirst sie in Schritt 4 benötigen.

video_response = tiktok_ad_video_upload(
    advertiser_id="123456789",
    video_file=video_data,
    upload_type="UPLOAD_BY_FILE"
)
video_id = video_response["data"]["video_id"]

Bereits hochgeladene Videos können wiederverwendet werden. Verwende tiktok_ad_video_search, um vorhandene Videos nach Namen zu suchen, oder tiktok_ad_video_info, um Metadaten für eine bekannte Video-ID abzurufen.

Schritt 4: Die Anzeige erstellen

tiktok_create_ad(
    advertiser_id="123456789",
    adgroup_id="1234567890123456",
    ad_name="Sommerschlussverkauf - Hero-Video",
    identity_type="CUSTOMIZED_USER",   # oder "AUTH_CODE" für TikTok-Konto-Spark-Anzeigen
    identity_id="<advertiser_identity_id>",
    ad_format="SINGLE_VIDEO",
    video_id=video_id,
    ad_text="Limitierter Sommer-Drop. Jetzt shoppen.",
    landing_page_url="https://example.com/sommer",
    call_to_action="SHOP_NOW",
    operation_status="DISABLE"        # pausiert erstellen, nach Prüfung aktivieren
)

Erstelle Anzeigen immer pausiert (operation_status="DISABLE") und schalte sie erst auf ENABLE, nachdem der Benutzer sie geprüft hat.

Kritische Parameterregeln

Häufige Fehler und Lösungen

Fehler	Lösung
Budget muss mindestens 50 $ betragen	TikTok erzwingt ein MINDESTBUDGET von 50 $ für Kampagnen.
Startzeit liegt in der Vergangenheit	Verwende ein zukünftiges Datum in `schedule_start_time` und das aktuelle Jahr.
TikTok-API lehnt `optimize_goal` in manchen Kontexten ab	Sowohl `optimize_goal` als auch `optimization_goal` existieren im Schema, aber bevorzuge `optimization_goal` – dies ist das Feld, das TikTok bei den meisten Zieltypen validiert.
Nur manuelle Platzierung wird unterstützt	REACH erfordert `placement_type="PLACEMENT_TYPE_NORMAL"`.
Gebot muss größer als 0 $ sein	Setze `bid_price` > 0.
Bitte Frequenzbegrenzung festlegen	REACH erfordert sowohl `frequency` als auch `frequency_schedule`.

Parameterabhängigkeiten

TRAFFIC-Ziel erfordert:

promotion_type="WEBSITE".
optimization_goal="CLICK".
billing_event="CPC".
bid_price > 0.

REACH-Ziel erfordert:

optimization_goal="REACH".
billing_event="CPM".
placement_type="PLACEMENT_TYPE_NORMAL".
placements-Array (z. B. ["PLACEMENT_TIKTOK"]).
bid_price > 0.
frequency und frequency_schedule.

CONVERSIONS-Ziel erfordert:

Einen verbundenen TikTok-Pixel und ein konfiguriertes Conversion-Event.
optimization_goal="CONVERT" (oder VALUE für wertbasiert).
billing_event="OCPM".
pixel_id und external_action, die in der Anzeigengruppe festgelegt sind.

Berichte

tiktok_report_integrated_get(
    advertiser_id="123456789",
    report_type="BASIC",
    data_level="AUCTION_AD",
    dimensions=["ad_id"],   # nur ID-basiert – NICHT Namen
    start_date="2026-04-01",
    end_date="2026-04-30",
    metrics=["impressions", "clicks", "ctr", "spend", "cpc", "cpm"],
    page_size=20
)

Berichtsregeln:

Mit der Dimension stat_time_day: maximal 30-Tage-Bereich pro Aufruf.
Verwende nur ID-basierte Dimensionen (ad_id, campaign_id, adgroup_id – keine Namen).
Conversion-Metriken (conversion, cost_per_conversion, conversion_rate usw.) erfordern einen verbundenen Pixel und ein konfiguriertes Conversion-Event.
data_level muss mit der Dimensionsgranularität übereinstimmen: AUCTION_AD mit ad_id, AUCTION_ADGROUP mit adgroup_id, AUCTION_CAMPAIGN mit campaign_id.

Sicherheitsregeln

Niemals:

Anzeigengruppenbudgets unter 20 $/Tag ohne Warnung des Benutzers festlegen.
Eine Kampagne mit einem vergangenen schedule_start_time planen (TikTok lehnt dies mit einer verwirrenden Fehlermeldung ab).
REACH-Anzeigengruppen mit PLACEMENT_TYPE_AUTOMATIC mischen – dies schlägt stillschweigend bei der Validierung fehl.
Anzeigen mit operation_status="ENABLE" erstellen, bevor der Benutzer Creative + Targeting geprüft hat.
Berichte mit namensbasierten Dimensionen ausführen – TikTok akzeptiert nur ID-Dimensionen.

hyperfx-ai/tiktok-ads

Was ist tiktok-ads?

In Ihrer bevorzugten KI fragen

Dokumentation