Jak zintegrować zestaw SDK wydarzeń w aplikacji TikTok

Zanim zaczniesz

Aby korzystać z zestawu SDK wydarzeń w aplikacji TikTok na urządzeniach z systemem Android i iOS, potrzebne są konto reklamowe TikTok i identyfikator aplikacji TikTok. Możesz użyć istniejącej aplikacji, jeśli ją posiadasz, lub utworzyć nową.

Uwaga: zestaw SDK wydarzeń w aplikacji TikTok obsługuje teraz hybrydową konfigurację z MMP na tym samym koncie. Możesz utworzyć nowe konto reklamowe TikTok, aby zintegrować zestaw SDK, lub użyć istniejącego konta MMP w celu zintegrowania zestawu SDK.

Jak zintegrować zestaw SDK wydarzeń w aplikacji TikTok

Krok 1: Utwórz aplikację lub użyj istniejącej aplikacji i wygeneruj identyfikator aplikacji TikTok oraz tajny klucz aplikacji

Opcja 1: Dodaj zestaw SDK do aplikacji połączonej z MMP (konfiguracja hybrydowa)

1. Zaloguj się do TikTok Ads Manager.

2. Kliknij kartę Narzędzia, a następnie Menedżer wydarzeń.

3. Wybierz Źródła danych, a następnie aplikację, do której chcesz dodać połączenie SDK.

   
   
   

4. Przejdź na kartę Ustawienia i kliknij opcję wybierz partnera w sekcji Zestaw SDK wydarzeń w aplikacji TikTok.

   
   
   

5. Postępuj zgodnie z instrukcjami i dodaj SDK do konta. Wygeneruj identyfikator aplikacji TikTok i tajny klucz aplikacji.

   

Opcja 2: Dodaj SDK do nowo utworzonej aplikacji

1. Zaloguj się do TikTok Ads Manager.

2. Kliknij kartę Narzędzia, a następnie Menedżer wydarzeń.

3. Wybierz opcję Połącz źródło danych w lewym górnym pasku nawigacji i wybierz opcję Aplikacja.

   
   
   

4. Wybierz TikTok SDK, aby połączyć swoją aplikację.

   
   
   

5. Podaj dane swojej aplikacji i utwórz ją. Postępuj zgodnie z instrukcjami i wygeneruj swój identyfikator aplikacji TikTok oraz tajny klucz aplikacji.

   
   
   

Krok 2: postępuj zgodnie z instrukcjami zawartymi w przewodniku Centrum programistów TikTok, aby zintegrować zestaw SDK wydarzeń w aplikacji TikTok

1. Aby zainicjować zestaw SDK, musisz mieć identyfikator aplikacji, identyfikator aplikacji TikTok i tajny klucz aplikacji z kroku 1.

   1. Wersja demo identyfikatora aplikacji i identyfikatora aplikacji TikTok:

      
      
      

   2. Wersja demo tajnego klucza aplikacji:

      
      
      

2. Pobierz SDK w GitHub. Na chwilę obecną obsługujemy natywne zestawy SDK systemu iOS, natywne zestawy SDK systemu Android i zestawy SDK Unity.

Krok 3: Wywołanie zwrotne zdarzenia za pomocą zestawu SDK

1. Pełną listę standardowych wydarzeń w aplikacji, które można rejestrować, a także zdarzeń rejestrowanych automatycznie znajdziesz w sekcji: Standardowe zdarzenia.

2. Poniżej znajduje się lista zdarzeń rejestrowanych automatycznie. Uwaga: możesz wyłączyć automatyczne rejestrowanie zdarzeń. Więcej informacji znajdziesz w dokumentacji dla programistów dotyczącej zestawu SDK wydarzeń w aplikacji.

   1. LaunchApp: podczas uruchamiania aplikacji.

   2. InstallApp: gdy aplikacja jest uruchamiana po raz pierwszy.

   3. 2DRetention: aplikacja zostanie ponownie otwarta następnego dnia po pierwszym otwarciu.

   4. Purchase: pomyślna realizacja płatności za subskrypcje zużywalne/niezbywalne.

      1. Przed włączeniem funkcji automatycznego rejestrowania wywołania zwrotnego dokonania zakupu upewnij się, że jest zgodne z wymaganiami Twojej firmy. Zobacz więcej szczegółów na temat automatycznego rejestrowania zdarzenia Dokonanie zakupu w systemie iOS i automatycznego rejestrowania zdarzenia Dokonanie zakupu w systemie Android.

Specjalne wywoływanie dla automatycznie rejestrowanych zdarzeń Dokonanie zakupu: SDK może automatycznie rejestrować transakcje dokonywane za pośrednictwem StoreKit (iOS) lub Google Play Billing (Android). Aby przekazać więcej właściwości i parametrów lub jeśli nie korzystasz z natywnej bramki płatności od Apple lub Google, zalecamy skorzystanie z ręcznego wywołania zwrotnego dokonania zakupu.

Krok 4: [iOS] Pomiar zdarzeń SKAN

W środowisku SKAdNetwork (SKAN) zalecamy korzystanie tylko z jednego zestawu SDK zgłaszającego wartości konwersji. Jeśli używasz MMP lub innego zestawu SDK do aktualizowania wartości konwersji w SKAdNetwork, pamiętaj o dodaniu do konfiguracji opcji disableSKAdNetworkSupport(), aby uniknąć konfliktów aktualizacji.

Określ, czy musisz włączyć pomiar SKAN TikTok SDK:

Jeśli masz MMP:

• Zestaw SDK MMP aktualizuje wartość konwersji, a Ty zamierzasz użyć schematu SKAN MMP: wyłącz obsługę SKAdNetwork w TikTok SDK i nie przesyłaj schematu do Menedżera wydarzeń TikTok. (Twój MMP pozostaje jedynym źródłem wiarygodnych informacji na temat aktualizacji i schematu wartości konwersji.)

Jeśli NIE masz MMP:

Musisz sprawdzić, czy tylko jeden zestaw SDK w Twojej aplikacji aktualizuje wartość konwersji SKAN.

• Inny zestaw SDK inny niż MMP aktualizuje wartość konwersji: wyłącz obsługę SKAdNetwork w TikTok SDK, ale prześlij schemat do Menedżera wydarzeń TikTok. (TikTok użyje Twojego schematu, ale nie będzie wykonywał zbędnych aktualizacji wartości konwersji.)

• Za aktualizację wartości konwersji odpowiada TikTok SDK: włącz obsługę SKAdNetwork w TikTok SDK i prześlij schemat do Menedżera wydarzeń TikTok. (TikTok staje się głównym dostawcą aktualizacji wartości konwersji SKAN.)

Więcej szczegółów znajdziesz w dokumentacji programisty na temat zestawu SDK wydarzeń w aplikacji.

Krok 5: zweryfikuj wywołania zwrotne (postbacki) w czasie rzeczywistym w trybie debugowania

Od wersji 1.5.0 zestawu SDK użytkownicy mają do dyspozycji dwie metody weryfikacji integracji zestawu SDK przed premierą:

• (zalecane) tryb zdarzeń testowych oparty na tokenach. Jest on w całości realizowany w Menedżerze wydarzeń TikTok i nie wymaga modyfikacji kodu;

• ręczny tryb debugowania, wymagający modyfikacji. Jeśli korzystasz z debugowania ręcznego, pamiętaj o wyłączeniu trybu debugowania przed premierą aplikacji. Zdarzenia generowane podczas korzystania z któregokolwiek z tych narzędzi przechodzą przez proces testowy i nie mogą być wykorzystywane do zgłaszania.

  • Tryb debugowania: WŁ.

    

    Tryb debugowania: WYŁ.

    

Krok 6: opublikuj nową wersję aplikacji z zestawem SDK TikTok w App Store (iOS) / Play Store (Android)

Zdarzenie SDK pojawi się na karcie Zgłaszanie w Menedżerze wydarzeń, gdy TikTok zacznie odbierać sygnał w czasie rzeczywistym z SDK. Sygnały w trybie testowym nie będą tutaj wyświetlane.

Krok 7: wyświetl swoją kampanię przy użyciu zestawu SDK TikTok.

W razie jakichkolwiek problemów z integracją zestawu SDK wydarzeń w aplikacji możesz przesłać zgłoszenie do działu obsługi klienta. Wybierz opcję Pomiar, a następnie Zestaw SDK wydarzeń w aplikacji jako kategorię problemu.