How to set up a secure data connection with TikTok through Blotout

Ostatnia aktualizacja: maj 2026

TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.


This article describes how to setup a secure data connection through Blotout. Blotout supports the TikTok Pixel and Events API.

For more information on these connection tools, please review the following resources:


Wdrożenie

Nie musisz konfigurować piksela TikTok osobno, ponieważ Blotout wczyta go w Twoim imieniu.


TikTok ma siedem pól:

  • Identyfikator piksela (wymagany) ― identyfikator piksela, do którego chcesz przypisać

  • Identyfikator reklamodawcy (wymagany) ― identyfikator reklamodawcy potrzebny do synchronizacji grupy odbiorców

  • oAuth (wymagane) ― token autoryzujący dostęp EdgeTag do interfejsu programistycznego TikTok

  • Piksel przeglądarki (opcjonalnie) ― jeśli włączysz tę opcję, automatycznie wstawimy piksel przeglądarki TikTok i wyślemy te same zdarzenia z przeglądarki i serwera. Dodanie tego samego identyfikatora zdarzenia do obu zdarzeń jest niezbędne, aby TikTok mógł przeprowadzić deduplikację. Jeśli nie włączysz tej opcji, możesz wysyłać zduplikowane zdarzenia z istniejących pikseli, co spowoduje zwiększenie liczby zdarzeń dokonania zakupu.

  • Identyfikator zestawu zdarzeń offline (opcjonalnie) ― identyfikator zestawu, który będzie używany do konwersji offline

  • Zdarzenie Dokonanie zakupu (opcjonalnie) ― możesz wybrać sposób zgłaszania zdarzeń dokonania zakupu na TikToku. Jako CompletePayment lub PlaceAnOrder

  • Kod testowy zdarzeń (opcjonalnie) ― wprowadź kod testowy z Menedżera wydarzeń dla swojego piksela, aby sprawdzić, czy wszystkie zdarzenia zostały zebrane poprawnie. Musisz usunąć ten kod testowy po uruchomieniu EdgeTag, w przeciwnym razie zdarzenia nie będą rejestrowane.

  • LDU (opcjonalnie) ― jeśli włączysz tę opcję, możesz zauważyć wpływ na wielkość grupy odbiorców w następujących stanach USA: Kalifornia, Kolorado, Connecticut, Utah, Wirginia, Iowa, Minnesota, Tennessee, Maryland, Delaware, Floryda, Montana, Nebraska, New Hampshire, New Jersey, Oregon, Teksas, Indiana, Kentucky, a także na skuteczność ich kampanii (ponieważ dane LDU nie są wykorzystywane do celów optymalizacji). LDU to funkcja dająca firmom większą kontrolę nad tym, w jaki sposób dane o zdarzeniach są wykorzystywane w systemach TikToka. Więcej informacji znajdziesz w sekcji Ograniczone wykorzystanie danych


Aby znaleźć identyfikator piksela:

Przejdź do TikTok Ads Manager. Najedź na sekcję Narzędzia i kliknij Menedżer wydarzeń, aby go otworzyć.

Blotout eAPI Implementation Guide - Locate Pixel ID 1
  • Po prawej stronie w sekcji Przegląd zbiorów danych kliknij piksel, którego chcesz użyć.

Blotout eAPI Implementation Guide - Locate Pixel ID 2
  • Skopiuj wartość identyfikatora piksela i wklej ją w odpowiednim polu w Blotout.

Blotout eAPI Implementation Guide - Locate Pixel ID 3

Identyfikator reklamodawcy

W TikTok Ads Manager kliknij menu rozwijane konta w prawym górnym rogu nagłówka. Skopiuj identyfikator właściwego konta reklamowego, którego chcesz używać z Blotout.

Blotout eAPI Implementation Guide - Advertiser ID

Identyfikator zestawu zdarzeń offline

Podobnie jak w przypadku identyfikatora piksela, musisz przejść do sekcji Zdarzenia. Zamiast opcji Zdarzenia sieciowe wybierz Zdarzenia offline. Skopiuj prawidłowy identyfikator zestawu zdarzeń offline, którego chcesz użyć.

Blotout eAPI Implementation Guide - Offline Event Set IDBlotout eAPI Implementation Guide - Offline Event Set ID 2

Konfiguracja przeglądarki

Jeśli używasz naszego zestawu SDK za pośrednictwem pakietu npm, musisz dodać dodatkowy pakiet, aby ten dostawca działał prawidłowo. Musisz zainstalować @blotoutio/providers-tiktok-sdk.


Po zainstalowaniu należy dodać go do wywołania init.


Przykład


# Code Snippet

importuj { init } z '@blotoutio/edgetag-sdk-js'

importuj tiktok z '@blotoutio/providers-tiktok-sdk'


init({

edgeURL: 'https://d.mysite.com',

disableConsentCheck: true,

dostawcy: [tiktok]

})


Zdarzenia

Oto standardowe zdarzenia zalecane przez TikToka.


Nasze standardowe zdarzenia znajdziesz w naszym przewodniku.


Zdarzenie

Działanie

ClickButton

Gdy przycisk zostanie kliknięty.

AddToWishlist

Gdy produkt zostanie dodany do listy ulubionych.

Kontakt

Gdy użytkownik nawiąże kontakt lub skorzysta z konsultacji.

Pobranie

Kliknięcie przycisku otwierającego zewnętrzną stronę pobierania w przeglądarce.

SubmitForm

Gdy formularz zostaje przesłany.

CompleteRegistration

Gdy rejestracja zostanie ukończona.


Dla wszystkich powyższych zdarzeń istnieją pola opcjonalne, które można wysłać zgodnie z poniższą listą.

Imię i nazwisko / nazwa

Rodzaj

Wymagane

Opis

waluta

ciąg

nr

kod ISO 4217

wartość

liczba

nr

Wartość zamówienia lub sprzedanych pozycji, czyli całkowita cena zamówienia

wyszukaj

ciąg

nr

Szukany ciąg tekstowy

treści

Treść[]

nr

Powiązane elementy w zdarzeniu sieciowym


Definicje typów

Imię i nazwisko / nazwa

Rodzaj

Wymagane

Opis

id

ciąg

tak

Identyfikator produktu

ilość

liczba

nr

Numer pozycji.

item_price

liczba

nr

Cena pojedynczej pozycji.

title

ciąg

nr

Nazwa strony/produktu.

category

ciąg

nr

Kategoria strony/produktu.

cena

ciąg

tak

Wartość właściwości obiektu content_type musi być ustawiona na product lub product_group. Jeśli będziesz śledzić zdarzenia związane z poszczególnymi produktami, ustaw wartość na product. Jeśli śledzisz zdarzenia powiązane z grupami produktów, ustaw zamiast tego wartość product_group.


Poniżej znajdują się przykładowe przesyłane dane, które należy wykorzystać, aby określone zdarzenie zostało poprawnie przetworzone przez dostawcę. Nie są one zdefiniowane w naszych standardowych zdarzeniach.


Przykłady


// Browser example

edgetag('tag', 'AddToCart', { value: 10.0, currency: 'USD' })



// Node example

importuj { tag } z '@blotoutio/edgetag-sdk-js'

tag('AddToCart', { value: 10.0, currency: 'USD' })