Wie wir die TikTok API nutzen
1. Wer wir sind und was AIADS ist
AIADS ist eine Plattform zur Durchführung und Optimierung von Werbekampagnen, entwickelt von der Agentur ICBM Polska Sp. z o.o. aus Gdańsk. Wir führen Unternehmenskampagnen (B2B) in Google Ads, Microsoft Ads, Meta Ads und TikTok Ads durch, während der Kunde ihre Ergebnisse in der Plattform AIADS (app.aiads.pl) verfolgt.
Die TikTok API nutzen wir ausschließlich zur Verwaltung der Werbekonten und Unternehmenskonten auf TikTok unserer Kunden, mit denen wir einen Vertrag abgeschlossen haben und die uns selbst den Zugriff erteilt haben. Wir erheben keine TikTok-Daten für andere Zwecke und verkaufen sie nicht weiter.
2. Wie wir ein TikTok-Konto verbinden
- Der Inhaber des Werbekontos oder des Unternehmenskontos meldet sich bei TikTok an und bestätigt selbst den Zugriff für die Anwendung AIADS (OAuth-Autorisierung TikTok for Business).
- Die Plattform AIADS erhält ein Zugriffstoken für die angegebenen Konten. Das Token wird verschlüsselt in der Datenbank gespeichert und dient ausschließlich den nachstehend beschriebenen Funktionen.
- Mit dem Konto arbeitet das Team der Kampagnenbetreuer von ICBM Polska. Der Kunde sieht Ergebnisse, Empfehlungen und den Änderungsverlauf in der Plattform AIADS.
3. TikTok Marketing API — Werbekampagnen
Nachstehend jeder API-Bereich, den wir nutzen, mit der jeweiligen Funktion in der Plattform AIADS und den aufgerufenen Endpoints (TikTok API for Business v1.3).
| Bereich | Wozu dient es in AIADS | Endpoints |
|---|---|---|
| Werbekonto | Auslesen der Kontodaten (Name, Währung, Zeitzone, Status) und der Werbeidentitäten bei der Anbindung des Kunden. | advertiser/info/ identity/get/ |
| Anzeigenverwaltung | Synchronisierung von Kampagnen, Anzeigengruppen und Anzeigen. Vom Betreuer freigegebene Änderungen: Status, Budget, Gebot, Zeitplan. Neue Anzeigen erstellen wir stets als deaktiviert. | campaign/get/ campaign/update/ adgroup/get/ adgroup/update/ adgroup/budget/update/ ad/get/ ad/create/ ad/status/update/ |
| Reporting | Tägliche Kampagnenergebnisse (Impressionen, Klicks, Kosten, Conversions) für Kundenberichte, Budgetmonitoring und Optimierungsempfehlungen. | report/integrated/get/ |
| Conversion-Messung | Übermittlung von Website-Conversions und Offline-Conversions (z. B. bezahlte Bestellungen aus dem Shopsystem) über die Events API, Konfiguration von Pixeln und Events sowie Kontrolle, ob die Events ankommen. | event/track/ pixel/list/ pixel/create/ pixel/event/create/ pixel/event/stats/ offline/create/ offline/get/ |
| Zielgruppen | Kundenlisten des Werbetreibenden, hochgeladen als gehashte (SHA-256) E-Mail-Adressen oder Telefonnummern, mindestens 1.000 Datensätze, sowie ähnliche Zielgruppen (Lookalike). | dmp/custom_audience/file/upload/ dmp/custom_audience/create/ dmp/custom_audience/update/ dmp/custom_audience/list/ dmp/custom_audience/lookalike/create/ dmp/custom_audience/delete/ |
| Leads | Abruf von Einsendungen aus TikTok-Kontaktformularen (Instant Forms) in das Lead-Postfach des Kunden in AIADS, damit der Vertrieb schnell zurückrufen kann. | page/get/ page/lead/task/ page/lead/task/download/ |
| Produktkatalog | Katalog für Produktanzeigen (DPA), gespeist durch den Produktfeed des Shops, den wir für den Kunden erstellen und hosten. | catalog/create/ catalog/get/ catalog/overview/ catalog/feed/create/ catalog/feed/get/ |
| Creatives | Hochladen der vom Kunden freigegebenen Werbebilder und -videos in die Mediathek des Kontos. | file/image/ad/upload/ file/video/ad/upload/ file/video/ad/info/ |
| Kommentare unter Anzeigen | Liste der Kommentare unter den Anzeigen, Antworten der Marke sowie Ausblenden und Wiederherstellen von Kommentaren (z. B. Spam). Kommentare unter den Anzeigen löschen wir nicht. | comment/list/ comment/post/ comment/status/update/ |
| Anzeigendiagnose | Auslesen der diagnostischen Hinweise von TikTok als eines der Signale in den Empfehlungen für den Kampagnenbetreuer. | tool/diagnosis/get/ |
Wir nutzen weder die Business-Center-Endpunkte (/bc/*) noch TikTok Shop.
4. TikTok Accounts — Veröffentlichungen auf dem Unternehmenskonto
Im Modul „Social-Veröffentlichungen“ der Plattform AIADS kann der Kunde uns beauftragen, Inhalte auf seinem TikTok-Unternehmenskonto zu veröffentlichen. Dieser Teil nutzt eine separate Autorisierung (TikTok Accounts).
| Funktion | Wozu dient es in AIADS | Endpoints |
|---|---|---|
| Profil und Statistiken | Grunddaten des Unternehmenskontos und Veröffentlichungsstatistiken für den Kundenbericht sowie zur Auswahl der besten Veröffentlichungszeiten. | business/get/ business/video/list/ |
| Veröffentlichung | Veröffentlichung der vom Kunden im Veröffentlichungskalender freigegebenen Videos und Bilder sowie Prüfung des Veröffentlichungsstatus. | business/video/settings/ business/video/publish/ business/photo/publish/ business/publish/status/ |
| Kommentare | Moderation der Kommentare unter den Veröffentlichungen im Panel: Antworten, Ausblenden, Löschen. Durchgeführt von einer Person aus dem Team. | business/comment/list/ business/comment/reply/list/ business/comment/reply/create/ business/comment/hide/ business/comment/delete/ |
5. Sicherheitsregeln für Änderungen
- Schreiboperationen laufen standardmäßig im Trockenmodus („dry run“, ohne Übertragung an TikTok). Nach dem Speichern liest die Plattform den Status aus der API aus und bestätigt, dass die Änderung übernommen wurde.
- Neue Anzeigen erstellen wir deaktiviert; Kampagnen und Anzeigen aktivieren wir nur auf ausdrückliche Anweisung des Betreuers.
- Die Automatismen von AIADS erhöhen das Budget nicht — die Erhöhung nimmt ein Mensch nach Entscheidung des Kunden vor. Jede Budget- und Gebotsänderung unterliegt einer maximalen Schrittgröße und einer Obergrenze für das gesamte Konto.
- Wir löschen weder Kampagnen, Anzeigengruppen noch Anzeigen — stattdessen pausieren wir sie.
- Jeder Schreibversuch (ausgeführt, blockiert oder fehlgeschlagen) wird im Änderungsprotokoll erfasst, und ein einziger Schalter kann alle Schreibvorgänge sperren (schreibgeschützter Modus).
6. Daten und Datenschutz
- Daten von TikTok verarbeiten wir im Auftrag des Kunden als Auftragsverarbeiter (Auftragsverarbeitungsvertrag), ausschließlich zur Durchführung seiner Kampagnen und für das Reporting.
- E-Mail-Adressen und Telefonnummern übermitteln wir an TikTok ausschließlich als SHA-256-Hash. Bei Conversion-Ereignissen übergeben wir zudem die Klick-ID (ttclid), die IP-Adresse und den Browser des Nutzers, sofern die Einwilligung zur Messung dies zulässt.
- Die Daten eines Kunden verknüpfen wir nicht mit den Daten anderer Kunden und verwenden sie nicht zum Trainieren von KI-Modellen.
- Leads aus TikTok-Formularen gelangen ausschließlich in das Lead-Postfach des Kunden, der Inhaber des Werbekontos ist.
- Einzelheiten zur Datenverarbeitung beschreibt unsere Datenschutzerklärung.
7. Kontotrennung und Kontakt
Der Kontoinhaber kann den Zugriff der AIADS-Anwendung jederzeit in den Einstellungen von TikTok for Business widerrufen oder uns um die Trennung des Kontos bitten. Nach dem Widerruf des Zugriffs ruft die Plattform keine Daten mehr ab und nimmt keine Änderungen an diesem Konto mehr vor.
ICBM Polska Sp. z o.o.
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Kontakt: Kontaktformular
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Kontakt: Kontaktformular
