Come integrare SDK di eventi in-app di TikTok

Prima di iniziare

Per usare SDK di eventi in-app di TikTok per Android e iOS, occorre avere un account pubblicitario di TikTok e un ID app di TikTok. Puoi usare la tua app esistente oppure crearne una nuova.

Nota: SDK di eventi in-app di TikTok non supporta la doppia configurazione con MMP nello stesso account pubblicitario. Crea un nuovo account pubblicitario di TikTok per integrare SDK di eventi in-app nel nuovo account pubblicitario senza MMP.

Come integrare SDK di eventi in-app di TikTok

Passaggio 1: crea un’app e genera un ID app di TikTok in Gestore eventi di TikTok.

1. In TikTok Ads Manager, vai a Gestore eventi facendo clic sulla scheda Strumenti, quindi su Evento.

2. Seleziona Collega fonte di dati in alto a destra sulla barra di navigazione.

3. Seleziona App per continuare.

4. Fornisci i dettagli della tua app.

5. Seleziona Usa SDK di eventi in-app di TikTok per continuare. L’app è ora creata.

6. Genera il tuo ID app di TikTok.

Passaggio 2: segui la procedura riportata nel Centro per sviluppatori di TikTok per integrare SDK di eventi in-app di TikTok.

1. Per un elenco completo degli eventi nell’app standard che puoi registrare e per gli eventi registrati automaticamente, fai riferimento a Eventi standard.

2. Gli eventi registrati automaticamente sono elencati di seguito. Nota: la registrazione automatica degli eventi può essere disattivata. Per saperne di più, fai riferimento alla documentazione per sviluppatori di SDK di eventi in-app.

   1. LaunchApp: l’app è in fase di avvio.

   2. InstallApp: l’app viene avviata per la prima volta.

   3. 2DRetention: l’app è stata riaperta il giorno successivo alla prima apertura.

   4. Acquisti (solo iOS): pagamenti completati correttamente per abbonamenti, articoli di consumo e altri tipi di articoli.

3. [Solo per iOS] Configura lo schema dei valori di conversione SKAN in Gestore eventi di TikTok (TTEM).

   1. La configurazione di uno schema di valori di conversione in TTEM è obbligatoria per poter ricevere le conversioni SKAN. TikTok supporta una mappatura dei valori di conversione a 64 bit per mappatura dello schema in SKAN 3.0 e in SKAN 4.0.

   2. [Best practice] In ambienti SKAdNetwork (SKAN), si consiglia di avere un solo SDK per i valori di conversione. Se usi un MMP o un altro SDK per aggiornare i valori di conversione in SKAdNetwork, dovrai:

      1. Configurare lo schema dei valori di conversione di TTEM con gli stessi valori configurati in MMP.

      2. Implementare la funzionalità disableSKAdNetworkSupport() per evitare che SDK di eventi in-app di TikTok aggiorni i valori di conversione.

Passaggio 3: verifica i postback in tempo reale con la modalità di debug.

1. Puoi verificare i postback degli eventi e i relativi parametri ed effettuarne il debug in tempo reale abilitando la modalità di debug nell’app. Per visualizzare gli eventi, vai alla scheda Test eventi nell’app in Gestore eventi di TikTok.

Note:

• Gli eventi di test supportano i test di più ID app di TikTok contemporaneamente. Tuttavia, in caso di test contemporaneo di più ID app di TikTok, tutti gli eventi di test dei vari ID app di TikTok verranno visualizzati nella scheda Test eventi nell’account pubblicitario a cui appartiene il primo ID app di TikTok collegato.

• Dopo aver verificato la configurazione dei segnali, disattiva la modalità di debug prima di rilasciare l’app nell’App Store o nel Play Store. Dopo la disattivazione, gli eventi test potrebbero continuare a essere visibili fino a 72 ore. Se gli eventi sono ancora visibili dopo 72 ore nella scheda Test eventi, la modalità di debug non è ancora stata disattivata. Vedi l’esempio di seguito:

Modalità di debug: ON

Modalità di debug: OFF

Passaggio 4: lancia la nuova versione dell’app con SDK di TikTok nell’App Store (iOS) o nel Play Store (Android).

Passaggio 5: conduci le tue campagne con SDK di TikTok.

Per problemi relativi all’integrazione di SDK di eventi in-app, puoi inviare un ticket al supporto clienti. Verifica di selezionare Misurazione, quindi SDK di eventi in-app come categoria del problema.