> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Ads mit anny verbinden

> Miss mit dem TikTok-Pixel, welche Kampagnen zu Buchungen in anny führen.

[TikTok Ads](https://ads.tiktok.com) ist die Werbeplattform von TikTok. Mit dem TikTok-Pixel und der serverseitigen Conversion-Schnittstelle misst du, welche deiner Kampagnen tatsächlich zu Buchungen führen. anny lädt dazu das TikTok-Pixel auf deinen Buchungsseiten und meldet die passenden Ereignisse an TikTok.

Mit TikTok Ads kannst du in anny:

* Seitenaufrufe deiner Buchungsseiten und abgeschlossene Buchungen als Conversions an TikTok melden
* den Erfolg deiner TikTok-Kampagnen bis zur fertigen Buchung nachverfolgen
* Buchungen zusätzlich serverseitig melden, auch wenn Kund:innen keine Cookies zulassen

Praktisch ist die Integration, wenn du über TikTok wirbst und wissen willst, welche Anzeigen sich in echte Buchungen und Umsatz übersetzen.

<Info>
  Die TikTok-Ads-Integration gehört zum Feature **Conversion Tracking**. Ist es in deinem Plan nicht enthalten, erscheint TikTok Ads in der Integrationsübersicht als nicht verfügbar. Dasselbe Feature schaltet auch Google Ads, Meta Ads und LinkedIn Ads frei.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall                      | Beschreibung                                                                                                                                                                                              |
| :---------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kampagnen-Erfolg messen             | **Du siehst im TikTok Events Manager, welche Anzeigen zu Buchungen führen.** anny meldet abgeschlossene Buchungen als Conversion samt Buchungswert, sodass du deine Werbeausgaben gezielt steuern kannst. |
| Conversions ohne Cookies erfassen   | **Auch ohne Cookie-Einwilligung ordnest du Buchungen deinen Kampagnen zu.** Kommen Kund:innen über eine TikTok-Anzeige, meldet anny den Abschluss serverseitig, unabhängig vom Cookie-Banner.             |
| Mehrere Plattformen parallel nutzen | **Du misst TikTok, Google, Meta und LinkedIn gleichzeitig.** anny bedient alle aktiven Plattformen über dieselben Ereignisse, ohne dass du deine Buchungsseiten anpassen musst.                           |

## Wie die TikTok-Ads-Verbindung funktioniert

Die Integration besteht aus zwei Wegen, die du getrennt nutzen kannst:

* **TikTok Pixel:** anny lädt das TikTok-Pixel-Skript im Browser deiner Kund:innen auf den von anny gehosteten Buchungsseiten und meldet dort Ereignisse. Dafür trägst du im Panel **TikTok Pixel** deine **Pixel ID** ein.
* **Offline conversion API:** anny meldet abgeschlossene Buchungen zusätzlich direkt vom Server an TikTok, ohne Browser und ohne Cookies. Dafür hinterlegst du im Panel **Offline conversion API** einen **Access token**.

Nur die **Pixel ID** ist Pflicht. Der **Access token** ist optional und schaltet den serverseitigen Weg zu. anny authentifiziert sich damit bei TikTok und sendet Ereignisse, empfängt aber keine Daten zurück. Es gibt in anny keine Zielgruppen-, Kampagnen- oder Budgetverwaltung.

Das Pixel lädt auf allen öffentlichen, von anny gehosteten Seiten: Buchungsseite, Ressourcen-, Service-, Abo- und Buchungspaket-Seite sowie Checkout und Bestätigung. Im Admin-Bereich lädt kein Pixel. anny meldet dabei vier Ereignisse:

| Ereignis           | Wann es gemeldet wird                     | Mitgesendete Daten                    |
| :----------------- | :---------------------------------------- | :------------------------------------ |
| `ViewContent`      | Kund:innen rufen eine Buchungsseite auf   | –                                     |
| `AddToCart`        | Eine Buchung wird in den Warenkorb gelegt | Netto-Betrag, Währung, Buchungsnummer |
| `InitiateCheckout` | Der Checkout wird geöffnet                | –                                     |
| `CompletePayment`  | Eine Buchung wird abgeschlossen           | Netto-Betrag, Währung, Buchungsnummer |

anny überträgt keine Namen, E-Mail-Adressen, Telefonnummern oder Buchungsdetails. Das Pixel selbst erhebt zusätzlich die üblichen Browser-Daten wie IP-Adresse, Browser-Kennung, Seiten-URL und TikTok-Cookies.

Das Pixel lädt erst, wenn Kund:innen im Cookie-Banner der Buchungsseite **Marketing** akzeptieren. Vorher passiert nichts. Die Option **Marketing** erscheint nur, wenn eine Tracking-Integration aktiv ist. Nimmt eine Person ihre Einwilligung zurück, sendet anny für sie keine weiteren Ereignisse mehr.

Der serverseitige Weg funktioniert unabhängig von den Cookies: anny meldet eine Offline-Conversion, wenn eine Person über eine TikTok-Anzeige mit Klick-Parameter auf die Buchungsseite gekommen ist, und ordnet Abschlüsse innerhalb von 14 Tagen dieser Kampagne zu. Wenn du die Integration deaktivierst, entfernt anny die **Pixel ID** sofort von allen Buchungsseiten und meldet keine weiteren Ereignisse mehr.

## TikTok Ads verbinden

### Voraussetzungen

Bevor du TikTok Ads verbindest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte in deinem anny Account und das Feature **Conversion Tracking** in deinem Plan
* Ein TikTok-Ads-Konto mit einem erstellten Pixel und dessen **Pixel ID** (TikTok Events Manager → Datenquellen → auswählen)
* Optional für serverseitige Conversions: einen **Access token** aus dem TikTok Events Manager (Datenquelle → Einstellungen → Zugangstoken generieren)

### Verbindung einrichten

<Steps>
  <Step title="Pixel ID eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **TikTok Ads**. Trage im Panel **TikTok Pixel** deine **Pixel ID** ein.
  </Step>

  <Step title="Optional: Offline conversion API hinterlegen">
    Willst du Buchungen zusätzlich serverseitig melden, füge im Panel **Offline conversion API** deinen **Access token** ein und klicke auf **Autorisieren**. Diesen Schritt kannst du überspringen, wenn du nur das Pixel nutzt.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Erst dann übergibt anny die **Pixel ID** an deine Buchungsseiten.
  </Step>
</Steps>

Sobald die Integration aktiv ist, lädt anny das TikTok-Pixel nach Marketing-Einwilligung auf deinen Buchungsseiten und meldet die Ereignisse an TikTok. Die Ergebnisse siehst du im TikTok Events Manager.

<Tip>
  Die **Pixel ID** darf nur Buchstaben, Ziffern und die Zeichen `_ : / - + = .` enthalten. Leerzeichen am Anfang und Ende entfernt anny automatisch. Enthält die ID andere Zeichen, bricht das Aktivieren mit einer Fehlermeldung ab.
</Tip>

## Einschränkungen

Die TikTok-Ads-Integration unterstützt nicht:

* **Eingebettete Buchungsseite (Widget):** In einem eingebetteten Widget zeigt anny kein Cookie-Banner und lädt daher kein TikTok-Pixel. Stattdessen gibt anny die Ereignisse an die umgebende Website weiter, wo ein eigener Tag Manager sie verarbeiten kann. Der serverseitige Weg über die **Offline conversion API** funktioniert im Widget uneingeschränkt.
* **Mehrere Pixel pro Account:** anny speichert eine **Pixel ID** pro Account. Legst du eine weitere TikTok-Ads-Integration an, gilt die zuletzt aktivierte Konfiguration.
* **Rückkanal:** TikTok sendet keine Daten an anny. Zielgruppen, Kampagnen und Budgets verwaltest du weiterhin im TikTok Ads Manager.
* **Änderung im aktiven Zustand:** Die **Pixel ID** lässt sich nur bei deaktivierter Integration ändern.

## Verbindung trennen

<Warning>
  Wenn du die Integration über den **Toggle** deaktivierst, entfernt anny das TikTok-Pixel sofort von allen Buchungsseiten und meldet keine weiteren Ereignisse mehr, weder aus dem Browser noch vom Server. Beim Löschen entfernt anny zusätzlich die gespeicherte **Pixel ID** und den **Access token**. Bereits in TikTok erfasste Daten bleiben dort erhalten, deine Buchungen sind nicht betroffen.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Werden meine Buchungsseiten auch ohne Cookie-Einwilligung getrackt?">
    Das Pixel lädt erst, wenn Kund:innen im Cookie-Banner **Marketing** akzeptieren. Ohne Einwilligung feuert anny keine Pixel-Ereignisse. Der serverseitige Weg über die **Offline conversion API** funktioniert dagegen auch ohne Cookie-Einwilligung, sofern die Person über eine TikTok-Anzeige gekommen ist.
  </Accordion>

  <Accordion title="Muss ich einen Access token hinterlegen?">
    Nein. Für das Tracking im Browser reicht die **Pixel ID**. Der **Access token** ist nur nötig, wenn du Buchungen zusätzlich serverseitig melden willst, zum Beispiel für Kund:innen ohne Cookie-Einwilligung oder in einem eingebetteten Widget.
  </Accordion>

  <Accordion title="Kann ich TikTok Ads und andere Plattformen gleichzeitig nutzen?">
    Ja. Google Ads, Meta Ads, LinkedIn Ads und TikTok Ads können parallel aktiv sein und werden über dieselben Ereignisse bedient. Es gibt eine gemeinsame Marketing-Einwilligung im Cookie-Banner, nicht eine pro Plattform.
  </Accordion>

  <Accordion title="Wie ändere ich die Pixel ID?">
    Deaktiviere die Integration zuerst über den **Toggle**, denn solange sie aktiv ist, ist die **Pixel ID** gesperrt. Trage danach die neue **Pixel ID** ein und aktiviere die Integration wieder.
  </Accordion>

  <Accordion title="Wo sehe ich, ob das Tracking funktioniert?">
    Die gemeldeten Ereignisse und Conversions siehst du im TikTok Events Manager. In anny protokolliert der **Aktivierungsverlauf** unter der Integration nur, wann sie aktiviert oder deaktiviert wurde, nicht die einzelnen Ereignisse.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann die Pixel ID nicht ändern">
    Die Integration ist noch aktiv. Solange sie läuft, ist die **Pixel ID** gesperrt. Deaktiviere die Integration zuerst über den **Toggle**, ändere dann die ID und aktiviere sie wieder.
  </Accordion>

  <Accordion title="Das Aktivieren bricht mit einer Fehlermeldung ab">
    Die **Pixel ID** enthält vermutlich unerlaubte Zeichen. Erlaubt sind nur Buchstaben, Ziffern und die Zeichen `_ : / - + = .`. Entferne insbesondere Leerzeichen in der Mitte der ID und aktiviere erneut.
  </Accordion>

  <Accordion title="TikTok Ads erscheint nicht in der Integrationsübersicht">
    Die Integration ist an das Feature **Conversion Tracking** gebunden. Ist es in deinem Plan nicht enthalten, taucht TikTok Ads nicht auf. Prüfe deinen Plan oder wende dich an den anny Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** TikTok Ads ist eine Conversion-Tracking-Integration, KEIN Datensync und KEIN Smart-Lock. Es gibt keinen Rückkanal von TikTok zu anny und keine Zielgruppen-, Kampagnen- oder Budgetverwaltung in anny. Zwei getrennte Wege: TikTok-Pixel (browserseitig) und Offline conversion API (serverseitig); beide unabhängig nutzbar, nur die Pixel ID ist Pflicht.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **TikTok Ads**. Panel **TikTok Pixel** mit Feld **Pixel ID**; Panel **Offline conversion API** mit Feld **Access token** und Button **Autorisieren**. Aktion **Verbindung testen** und **Löschen** über die drei Punkte; Aktivieren/Deaktivieren über den Toggle oben rechts. **Aktivierungsverlauf** protokolliert nur Aktivierung/Deaktivierung, keine einzelnen Ereignisse. Labels sind in der deutschen Oberfläche englisch ("Pixel ID", "Access token", "Offline conversion API").
>
> **Events & Seiten:** Pixel lädt auf allen öffentlichen anny-Seiten (Buchungsseite, Ressource, Service, Abo, Buchungspaket, Checkout, Bestätigung), nicht im Admin. Ereignisse: `ViewContent` (Seitenaufruf), `AddToCart` (Warenkorb), `InitiateCheckout` (Checkout geöffnet), `CompletePayment` (Abschluss). `AddToCart` und `CompletePayment` tragen Netto-Betrag, Währung und Buchungsnummer; keine personenbezogenen Kundendaten. Das Pixel lädt erst nach Marketing-Einwilligung im Cookie-Banner; die Marketing-Option erscheint nur bei aktiver Tracking-Integration; Widerruf stoppt weitere anny-Events.
>
> **Serverseitige Offline-Conversions:** Nur, wenn die Person über einen TikTok-Klick-Parameter (`ttclid`) kam. Attributionsfenster 14 Tage, unabhängig von der Cookie-Einwilligung (nur technisch notwendiger Besuchs-Schlüssel). Klick-Parameter gewinnen gegen reine UTM-Parameter bei Wiederkehr. Gemeldet werden Bestellungen, Abos und Buchungspakete als `CompletePayment` mit Netto-Betrag und Währung. Übertragen werden Pixel ID, Ereignisname, Ereignis-Kennung, Zeitstempel, Klick-ID, Betrag, Währung; keine Kundendaten. Bei Serverfehler/Ratenlimit bis zu 3 Wiederholungen; bei inhaltlicher Ablehnung (z. B. ungültiger Access token) keine Wiederholung.
>
> **Beziehungen:** Feature-Gating über **Conversion Tracking**, gemeinsam mit Google Ads, Meta Ads und LinkedIn Ads. Eine gemeinsame Marketing-Einwilligung für alle Plattformen. Verwandter Artikel: utm-tracking. Im Widget lädt kein Pixel (kein Cookie-Banner); Ereignisse gehen an die umgebende Website (Tag Manager), Offline conversion API funktioniert dort. Pro Account wird nur eine Pixel-Konfiguration gespeichert; bei mehreren Integrationen gilt die zuletzt aktivierte. Auf Seiten mit mehreren Organisationen lädt anny jedes Pixel getrennt.
