Jak korzystamy z TikTok API
1. Kim jesteśmy i czym jest AIADS
AIADS to platforma do prowadzenia i optymalizacji kampanii reklamowych, rozwijana przez agencję ICBM Polska Sp. z o.o. z Gdańska. Prowadzimy kampanie firm (B2B) w Google Ads, Microsoft Ads, Meta Ads i TikTok Ads, a klient śledzi ich wyniki w platformie AIADS (app.aiads.pl).
TikTok API wykorzystujemy wyłącznie do obsługi kont reklamowych i kont firmowych TikTok naszych klientów, z którymi mamy podpisaną umowę i którzy sami udzielili nam dostępu. Nie zbieramy danych z TikToka w innych celach i nie odsprzedajemy ich.
2. Jak łączymy konto TikTok
- Właściciel konta reklamowego albo konta firmowego loguje się w TikTok i sam zatwierdza dostęp dla aplikacji AIADS (autoryzacja OAuth TikTok for Business).
- Platforma AIADS otrzymuje token dostępu do wskazanych kont. Token jest przechowywany w bazie w postaci zaszyfrowanej i służy wyłącznie do opisanych niżej funkcji.
- Z kontem pracuje zespół opiekunów kampanii ICBM Polska. Klient widzi wyniki, rekomendacje i historię zmian w platformie AIADS.
3. TikTok Marketing API — kampanie reklamowe
Poniżej każdy obszar API, z którego korzystamy, z funkcją w platformie AIADS i wywoływanymi endpointami (TikTok API for Business v1.3).
| Obszar | Do czego służy w AIADS | Endpointy |
|---|---|---|
| Konto reklamowe | Odczyt danych konta (nazwa, waluta, strefa czasowa, status) i tożsamości reklamowych przy podłączaniu klienta. | advertiser/info/ identity/get/ |
| Zarządzanie reklamami | Synchronizacja kampanii, grup reklam i reklam. Zmiany zatwierdzone przez opiekuna: status, budżet, stawka, harmonogram. Nowe reklamy tworzymy zawsze jako wyłączone. | campaign/get/ campaign/update/ adgroup/get/ adgroup/update/ adgroup/budget/update/ ad/get/ ad/create/ ad/status/update/ |
| Raportowanie | Dzienne wyniki kampanii (wyświetlenia, kliknięcia, koszt, konwersje) do raportów dla klienta, monitoringu budżetu i rekomendacji optymalizacyjnych. | report/integrated/get/ |
| Pomiar konwersji | Przesyłanie konwersji ze strony i konwersji offline (np. opłaconych zamówień z systemu sklepu) przez Events API, konfiguracja pikseli i zdarzeń, kontrola, czy zdarzenia docierają. | event/track/ pixel/list/ pixel/create/ pixel/event/create/ pixel/event/stats/ offline/create/ offline/get/ |
| Odbiorcy | Listy klientów reklamodawcy wgrywane jako zahashowane (SHA-256) adresy e-mail albo numery telefonów, minimum 1000 rekordów, oraz odbiorcy podobni (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/ |
| Leady | Pobieranie zgłoszeń z formularzy kontaktowych TikTok (Instant Forms) do skrzynki leadów klienta w AIADS, żeby handlowiec mógł szybko oddzwonić. | page/get/ page/lead/task/ page/lead/task/download/ |
| Katalog produktów | Katalog do reklam produktowych (DPA) zasilany plikiem produktowym sklepu, który przygotowujemy i hostujemy dla klienta. | catalog/create/ catalog/get/ catalog/overview/ catalog/feed/create/ catalog/feed/get/ |
| Kreacje | Wgrywanie zatwierdzonych przez klienta obrazów i filmów reklamowych do biblioteki konta. | file/image/ad/upload/ file/video/ad/upload/ file/video/ad/info/ |
| Komentarze pod reklamami | Lista komentarzy pod reklamami, odpowiedzi marki oraz ukrywanie i przywracanie komentarzy (np. spamu). Komentarzy pod reklamami nie usuwamy. | comment/list/ comment/post/ comment/status/update/ |
| Diagnoza reklam | Odczyt podpowiedzi diagnostycznych TikToka jako jednego z sygnałów w rekomendacjach dla opiekuna kampanii. | tool/diagnosis/get/ |
Nie korzystamy z endpointów Business Center (/bc/*) ani z TikTok Shop.
4. TikTok Accounts — publikacje na koncie firmowym
W module „Publikacje social” platformy AIADS klient może zlecić nam publikację materiałów na swoim firmowym koncie TikTok. Ta część korzysta z osobnej autoryzacji (TikTok Accounts).
| Funkcja | Do czego służy w AIADS | Endpointy |
|---|---|---|
| Profil i statystyki | Podstawowe dane konta firmowego i statystyki publikacji do raportu dla klienta oraz wyboru najlepszych godzin publikacji. | business/get/ business/video/list/ |
| Publikacja | Publikacja filmów i zdjęć zaakceptowanych przez klienta w kalendarzu publikacji oraz sprawdzenie statusu publikacji. | business/video/settings/ business/video/publish/ business/photo/publish/ business/publish/status/ |
| Komentarze | Moderacja komentarzy pod publikacjami w panelu: odpowiedź, ukrycie, usunięcie. Wykonuje ją osoba z zespołu. | business/comment/list/ business/comment/reply/list/ business/comment/reply/create/ business/comment/hide/ business/comment/delete/ |
5. Zasady bezpieczeństwa zmian
- Operacje zapisu domyślnie działają „na sucho” (bez wysyłki do TikToka). Po zapisie platforma odczytuje stan z API i potwierdza, że zmiana weszła.
- Nowe reklamy tworzymy jako wyłączone, a kampanie i reklamy włączamy tylko na wyraźne polecenie opiekuna.
- Automaty AIADS nie podnoszą budżetu — podwyżkę wykonuje człowiek po decyzji klienta. Każda zmiana budżetu i stawki ma limit wielkości kroku i górny limit dla całego konta.
- Nie usuwamy kampanii, grup reklam ani reklam — zamiast tego je wstrzymujemy.
- Każda próba zapisu (wykonana, zablokowana albo nieudana) trafia do dziennika zmian, a jeden przełącznik może zablokować wszystkie zapisy (tryb tylko do odczytu).
6. Dane i prywatność
- Dane z TikToka przetwarzamy w imieniu klienta jako podmiot przetwarzający (umowa powierzenia), wyłącznie w celu prowadzenia jego kampanii i raportowania.
- Adresy e-mail i numery telefonów wysyłamy do TikToka tylko w postaci skrótu SHA-256. W zdarzeniach konwersji przekazujemy też identyfikator kliknięcia (ttclid), adres IP i przeglądarkę użytkownika, jeśli zgoda na pomiar to dopuszcza.
- Danych jednego klienta nie łączymy z danymi innych klientów i nie używamy ich do trenowania modeli AI.
- Leady z formularzy TikTok trafiają tylko do skrzynki leadów tego klienta, który jest właścicielem konta reklamowego.
- Szczegóły przetwarzania danych opisuje nasza polityka prywatności.
7. Odłączenie konta i kontakt
Właściciel konta może w każdej chwili cofnąć dostęp aplikacji AIADS w ustawieniach TikTok for Business albo poprosić nas o odłączenie konta. Po cofnięciu dostępu platforma przestaje pobierać dane i wprowadzać zmiany na tym koncie.
ICBM Polska Sp. z o.o.
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Kontakt: formularz kontaktowy
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Kontakt: formularz kontaktowy
